jell-utils 0.0.18 → 0.2.0

package/.claude/commands/tm/complexity-report.md

@@ -0,0 +1,120 @@
+Complexity Report
+
+Arguments: $ARGUMENTS
+Display the task complexity analysis report.
+
+Arguments: $ARGUMENTS
+
+View the detailed complexity analysis generated by analyze-complexity command.
+
+## Viewing Complexity Report
+
+Shows comprehensive task complexity analysis with actionable insights.
+
+## Execution
+
+```bash
+task-master complexity-report [--file=<path>]
+```
+
+## Report Location
+
+Default: `.taskmaster/reports/complexity-analysis.md`
+Custom: Specify with --file parameter
+
+## Report Contents
+
+### 1. **Executive Summary**
+```
+Complexity Analysis Summary
+━━━━━━━━━━━━━━━━━━━━━━━━
+Analysis Date: 2024-01-15
+Tasks Analyzed: 32
+High Complexity: 5 (16%)
+Medium Complexity: 12 (37%)
+Low Complexity: 15 (47%)
+
+Critical Findings:
+- 5 tasks need immediate expansion
+- 3 tasks have high technical risk
+- 2 tasks block critical path
+```
+
+### 2. **Detailed Task Analysis**
+For each complex task:
+- Complexity score breakdown
+- Contributing factors
+- Specific risks identified
+- Expansion recommendations
+- Similar completed tasks
+
+### 3. **Risk Matrix**
+Visual representation:
+```
+Risk vs Complexity Matrix
+━━━━━━━━━━━━━━━━━━━━━━━
+High Risk  | #5(9) #12(8) | #23(6)
+Med Risk   | #34(7)       | #45(5) #67(5)
+Low Risk   | #78(8)       | [15 tasks]
+           | High Complex  | Med Complex
+```
+
+### 4. **Recommendations**
+
+**Immediate Actions:**
+1. Expand task #5 - Critical path + high complexity
+2. Expand task #12 - High risk + dependencies
+3. Review task #34 - Consider splitting
+
+**Sprint Planning:**
+- Don't schedule multiple high-complexity tasks together
+- Ensure expertise available for complex tasks
+- Build in buffer time for unknowns
+
+## Interactive Features
+
+When viewing report:
+1. **Quick Actions**
+   - Press 'e' to expand a task
+   - Press 'd' for task details
+   - Press 'r' to refresh analysis
+
+2. **Filtering**
+   - View by complexity level
+   - Filter by risk factors
+   - Show only actionable items
+
+3. **Export Options**
+   - Markdown format
+   - CSV for spreadsheets
+   - JSON for tools
+
+## Report Intelligence
+
+- Compares with historical data
+- Shows complexity trends
+- Identifies patterns
+- Suggests process improvements
+
+## Integration
+
+Use report for:
+- Sprint planning sessions
+- Resource allocation
+- Risk assessment
+- Team discussions
+- Client updates
+
+## Example Usage
+
+```
+/taskmaster:complexity-report
+→ Opens latest analysis
+
+/taskmaster:complexity-report --file=archived/2024-01-01.md
+→ View historical analysis
+
+After viewing:
+/taskmaster:expand 5
+→ Expand high-complexity task
+```

package/.claude/commands/tm/convert-task-to-subtask.md

@@ -0,0 +1,74 @@
+Convert Task To Subtask
+
+Arguments: $ARGUMENTS
+Convert an existing task into a subtask.
+
+Arguments: $ARGUMENTS
+
+Parse parent ID and task ID to convert.
+
+## Task Conversion
+
+Converts an existing standalone task into a subtask of another task.
+
+## Argument Parsing
+
+- "move task 8 under 5"
+- "make 8 a subtask of 5"
+- "nest 8 in 5"
+- "5 8" → make task 8 a subtask of task 5
+
+## Execution
+
+```bash
+task-master add-subtask --parent=<parent-id> --task-id=<task-to-convert>
+```
+
+## Pre-Conversion Checks
+
+1. **Validation**
+   - Both tasks exist and are valid
+   - No circular parent relationships
+   - Task isn't already a subtask
+   - Logical hierarchy makes sense
+
+2. **Impact Analysis**
+   - Dependencies that will be affected
+   - Tasks that depend on converting task
+   - Priority alignment needed
+   - Status compatibility
+
+## Conversion Process
+
+1. Change task ID from "8" to "5.1" (next available)
+2. Update all dependency references
+3. Inherit parent's context where appropriate
+4. Adjust priorities if needed
+5. Update time estimates
+
+## Smart Features
+
+- Preserve task history
+- Maintain dependencies
+- Update all references
+- Create conversion log
+
+## Example
+
+```
+/taskmaster:add-subtask/from-task 5 8
+→ Converting: Task #8 becomes subtask #5.1
+→ Updated: 3 dependency references
+→ Parent task #5 now has 1 subtask
+→ Note: Subtask inherits parent's priority
+
+Before: #8 "Implement validation" (standalone)
+After:  #5.1 "Implement validation" (subtask of #5)
+```
+
+## Post-Conversion
+
+- Show new task hierarchy
+- List updated dependencies
+- Verify project integrity
+- Suggest related conversions

package/.claude/commands/tm/expand-all-tasks.md

@@ -0,0 +1,52 @@
+Expand All Tasks
+Expand all pending tasks that need subtasks.
+
+## Bulk Task Expansion
+
+Intelligently expands all tasks that would benefit from breakdown.
+
+## Execution
+
+```bash
+task-master expand --all
+```
+
+## Smart Selection
+
+Only expands tasks that:
+- Are marked as pending
+- Have high complexity (>5)
+- Lack existing subtasks
+- Would benefit from breakdown
+
+## Expansion Process
+
+1. **Analysis Phase**
+   - Identify expansion candidates
+   - Group related tasks
+   - Plan expansion strategy
+
+2. **Batch Processing**
+   - Expand tasks in logical order
+   - Maintain consistency
+   - Preserve relationships
+   - Optimize for parallelism
+
+3. **Quality Control**
+   - Ensure subtask quality
+   - Avoid over-decomposition
+   - Maintain task coherence
+   - Update dependencies
+
+## Options
+
+- Add `force` to expand all regardless of complexity
+- Add `research` for enhanced AI analysis
+
+## Results
+
+After bulk expansion:
+- Summary of tasks expanded
+- New subtask count
+- Updated complexity metrics
+- Suggested task order

package/.claude/commands/tm/expand-task.md

@@ -0,0 +1,52 @@
+Expand Task
+
+Arguments: $ARGUMENTS
+Break down a complex task into subtasks.
+
+Arguments: $ARGUMENTS (task ID)
+
+## Intelligent Task Expansion
+
+Analyzes a task and creates detailed subtasks for better manageability.
+
+## Execution
+
+```bash
+task-master expand --id=$ARGUMENTS
+```
+
+## Expansion Process
+
+1. **Task Analysis**
+   - Review task complexity
+   - Identify components
+   - Detect technical challenges
+   - Estimate time requirements
+
+2. **Subtask Generation**
+   - Create 3-7 subtasks typically
+   - Each subtask 1-4 hours
+   - Logical implementation order
+   - Clear acceptance criteria
+
+3. **Smart Breakdown**
+   - Setup/configuration tasks
+   - Core implementation
+   - Testing components
+   - Integration steps
+   - Documentation updates
+
+## Enhanced Features
+
+Based on task type:
+- **Feature**: Setup → Implement → Test → Integrate
+- **Bug Fix**: Reproduce → Diagnose → Fix → Verify
+- **Refactor**: Analyze → Plan → Refactor → Validate
+
+## Post-Expansion
+
+After expansion:
+1. Show subtask hierarchy
+2. Update time estimates
+3. Suggest implementation order
+4. Highlight critical path

package/.claude/commands/tm/fix-dependencies.md

@@ -0,0 +1,82 @@
+Fix Dependencies
+Automatically fix dependency issues found during validation.
+
+## Automatic Dependency Repair
+
+Intelligently fixes common dependency problems while preserving project logic.
+
+## Execution
+
+```bash
+task-master fix-dependencies
+```
+
+## What Gets Fixed
+
+### 1. **Auto-Fixable Issues**
+- Remove references to deleted tasks
+- Break simple circular dependencies
+- Remove self-dependencies
+- Clean up duplicate dependencies
+
+### 2. **Smart Resolutions**
+- Reorder dependencies to maintain logic
+- Suggest task merging for over-dependent tasks
+- Flatten unnecessary dependency chains
+- Remove redundant transitive dependencies
+
+### 3. **Manual Review Required**
+- Complex circular dependencies
+- Critical path modifications
+- Business logic dependencies
+- High-impact changes
+
+## Fix Process
+
+1. **Analysis Phase**
+   - Run validation check
+   - Categorize issues by type
+   - Determine fix strategy
+
+2. **Execution Phase**
+   - Apply automatic fixes
+   - Log all changes made
+   - Preserve task relationships
+
+3. **Verification Phase**
+   - Re-validate after fixes
+   - Show before/after comparison
+   - Highlight manual fixes needed
+
+## Smart Features
+
+- Preserves intended task flow
+- Minimal disruption approach
+- Creates fix history/log
+- Suggests manual interventions
+
+## Output Example
+
+```
+Dependency Auto-Fix Report
+━━━━━━━━━━━━━━━━━━━━━━━━
+Fixed Automatically:
+✅ Removed 2 references to deleted tasks
+✅ Resolved 1 self-dependency
+✅ Cleaned 3 redundant dependencies
+
+Manual Review Needed:
+⚠️ Complex circular dependency: #12 → #15 → #18 → #12
+  Suggestion: Make #15 not depend on #12
+⚠️ Task #45 has 8 dependencies
+  Suggestion: Break into subtasks
+
+Run '/taskmaster:validate-dependencies' to verify fixes
+```
+
+## Safety
+
+- Preview mode available
+- Rollback capability
+- Change logging
+- No data loss

package/.claude/commands/tm/help.md

@@ -0,0 +1,101 @@
+Help
+
+Arguments: $ARGUMENTS
+Show help for Task Master AI commands.
+
+Arguments: $ARGUMENTS
+
+Display help for Task Master commands and available options.
+
+## Task Master AI Command Help
+
+### Quick Navigation
+
+Type `/taskmaster:` and use tab completion to explore all commands.
+
+### Command Categories
+
+#### 🚀 Setup & Installation
+- `/taskmaster:install-taskmaster` - Comprehensive installation guide
+- `/taskmaster:quick-install-taskmaster` - One-line global install
+
+#### 📋 Project Setup
+- `/taskmaster:init-project` - Initialize new project
+- `/taskmaster:init-project-quick` - Quick setup with auto-confirm
+- `/taskmaster:view-models` - View AI configuration
+- `/taskmaster:setup-models` - Configure AI providers
+
+#### 🎯 Task Generation
+- `/taskmaster:parse-prd` - Generate tasks from PRD
+- `/taskmaster:parse-prd-with-research` - Enhanced parsing
+- `/taskmaster:generate-tasks` - Create task files
+
+#### 📝 Task Management
+- `/taskmaster:list-tasks` - List all tasks
+- `/taskmaster:list-tasks-by-status` - List tasks filtered by status
+- `/taskmaster:list-tasks-with-subtasks` - List tasks with subtasks
+- `/taskmaster:show-task` - Display task details
+- `/taskmaster:add-task` - Create new task
+- `/taskmaster:update-task` - Update single task
+- `/taskmaster:update-tasks-from-id` - Update multiple tasks
+- `/taskmaster:next-task` - Get next task recommendation
+
+#### 🔄 Status Management
+- `/taskmaster:to-pending` - Set task to pending
+- `/taskmaster:to-in-progress` - Set task to in-progress
+- `/taskmaster:to-done` - Set task to done
+- `/taskmaster:to-review` - Set task to review
+- `/taskmaster:to-deferred` - Set task to deferred
+- `/taskmaster:to-cancelled` - Set task to cancelled
+
+#### 🔍 Analysis & Breakdown
+- `/taskmaster:analyze-complexity` - Analyze task complexity
+- `/taskmaster:complexity-report` - View complexity report
+- `/taskmaster:expand-task` - Break down complex task
+- `/taskmaster:expand-all-tasks` - Expand all eligible tasks
+
+#### 🔗 Dependencies
+- `/taskmaster:add-dependency` - Add task dependency
+- `/taskmaster:remove-dependency` - Remove dependency
+- `/taskmaster:validate-dependencies` - Check for issues
+- `/taskmaster:fix-dependencies` - Auto-fix dependency issues
+
+#### 📦 Subtasks
+- `/taskmaster:add-subtask` - Add subtask to task
+- `/taskmaster:convert-task-to-subtask` - Convert task to subtask
+- `/taskmaster:remove-subtask` - Remove subtask
+- `/taskmaster:remove-subtasks` - Clear specific task subtasks
+- `/taskmaster:remove-all-subtasks` - Clear all subtasks
+
+#### 🗑️ Task Removal
+- `/taskmaster:remove-task` - Remove task permanently
+
+#### 🤖 Workflows
+- `/taskmaster:smart-workflow` - Intelligent workflows
+- `/taskmaster:command-pipeline` - Command chaining
+- `/taskmaster:auto-implement-tasks` - Auto-implementation
+
+#### 📊 Utilities
+- `/taskmaster:analyze-project` - Project analysis
+- `/taskmaster:project-status` - Project dashboard
+- `/taskmaster:sync-readme` - Sync README with tasks
+- `/taskmaster:learn` - Interactive learning
+- `/taskmaster:tm-main` - Main Task Master interface
+
+### Quick Start Examples
+
+```
+/taskmaster:list-tasks
+/taskmaster:show-task 1.2
+/taskmaster:add-task
+/taskmaster:next-task
+```
+
+### Getting Started
+
+1. Install: `/taskmaster:quick-install-taskmaster`
+2. Initialize: `/taskmaster:init-project-quick`
+3. Learn: `/taskmaster:learn`
+4. Work: `/taskmaster:smart-workflow`
+
+For detailed command info, run the specific command with `--help` or check command documentation.

package/.claude/commands/tm/init-project-quick.md

@@ -0,0 +1,49 @@
+Init Project Quick
+
+Arguments: $ARGUMENTS
+Quick initialization with auto-confirmation.
+
+Arguments: $ARGUMENTS
+
+Initialize a Task Master project without prompts, accepting all defaults.
+
+## Quick Setup
+
+```bash
+task-master init -y
+```
+
+## What It Does
+
+1. Creates `.taskmaster/` directory structure
+2. Initializes empty `tasks.json`
+3. Sets up default configuration
+4. Uses directory name as project name
+5. Skips all confirmation prompts
+
+## Smart Defaults
+
+- Project name: Current directory name
+- Description: "Task Master Project"
+- Model config: Existing environment vars
+- Task structure: Standard format
+
+## Next Steps
+
+After quick init:
+1. Configure AI models if needed:
+   ```
+   /taskmaster:models/setup
+   ```
+
+2. Parse PRD if available:
+   ```
+   /taskmaster:parse-prd <file>
+   ```
+
+3. Or create first task:
+   ```
+   /taskmaster:add-task create initial setup
+   ```
+
+Perfect for rapid project setup!

package/.claude/commands/tm/init-project.md

@@ -0,0 +1,53 @@
+Init Project
+
+Arguments: $ARGUMENTS
+Initialize a new Task Master project.
+
+Arguments: $ARGUMENTS
+
+Parse arguments to determine initialization preferences.
+
+## Initialization Process
+
+1. **Parse Arguments**
+   - PRD file path (if provided)
+   - Project name
+   - Auto-confirm flag (-y)
+
+2. **Project Setup**
+   ```bash
+   task-master init
+   ```
+
+3. **Smart Initialization**
+   - Detect existing project files
+   - Suggest project name from directory
+   - Check for git repository
+   - Verify AI provider configuration
+
+## Configuration Options
+
+Based on arguments:
+- `quick` / `-y` → Skip confirmations
+- `<file.md>` → Use as PRD after init
+- `--name=<name>` → Set project name
+- `--description=<desc>` → Set description
+
+## Post-Initialization
+
+After successful init:
+1. Show project structure created
+2. Verify AI models configured
+3. Suggest next steps:
+   - Parse PRD if available
+   - Configure AI providers
+   - Set up git hooks
+   - Create first tasks
+
+## Integration
+
+If PRD file provided:
+```
+/taskmaster:init my-prd.md
+→ Automatically runs parse-prd after init
+```

package/.claude/commands/tm/install-taskmaster.md

@@ -0,0 +1,118 @@
+Install TaskMaster
+Check if Task Master is installed and install it if needed.
+
+This command helps you get Task Master set up globally on your system.
+
+## Detection and Installation Process
+
+1. **Check Current Installation**
+   ```bash
+   # Check if task-master command exists
+   which task-master || echo "Task Master not found"
+
+   # Check npm global packages
+   npm list -g task-master-ai
+   ```
+
+2. **System Requirements Check**
+   ```bash
+   # Verify Node.js is installed
+   node --version
+
+   # Verify npm is installed
+   npm --version
+
+   # Check Node version (need 16+)
+   ```
+
+3. **Install Task Master Globally**
+   If not installed, run:
+   ```bash
+   npm install -g task-master-ai
+   ```
+
+4. **Verify Installation**
+   ```bash
+   # Check version
+   task-master --version
+
+   # Verify command is available
+   which task-master
+   ```
+
+5. **Initial Setup**
+   ```bash
+   # Initialize in current directory
+   task-master init
+   ```
+
+6. **Configure AI Provider**
+   Ensure you have at least one AI provider API key set:
+   ```bash
+   # Check current configuration
+   task-master models --status
+
+   # If no API keys found, guide setup
+   echo "You'll need at least one API key:"
+   echo "- ANTHROPIC_API_KEY for Claude"
+   echo "- OPENAI_API_KEY for GPT models"
+   echo "- PERPLEXITY_API_KEY for research"
+   echo ""
+   echo "Set them in your shell profile or .env file"
+   ```
+
+7. **Quick Test**
+   ```bash
+   # Create a test PRD
+   echo "Build a simple hello world API" > test-prd.txt
+
+   # Try parsing it
+   task-master parse-prd test-prd.txt -n 3
+   ```
+
+## Troubleshooting
+
+If installation fails:
+
+**Permission Errors:**
+```bash
+# Try with sudo (macOS/Linux)
+sudo npm install -g task-master-ai
+
+# Or fix npm permissions
+npm config set prefix ~/.npm-global
+export PATH=~/.npm-global/bin:$PATH
+```
+
+**Network Issues:**
+```bash
+# Use different registry
+npm install -g task-master-ai --registry https://registry.npmjs.org/
+```
+
+**Node Version Issues:**
+```bash
+# Install Node 20+ via nvm
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
+nvm install 20
+nvm use 20
+```
+
+## Success Confirmation
+
+Once installed, you should see:
+```
+✅ Task Master installed
+✅ Command 'task-master' available globally
+✅ AI provider configured
+✅ Ready to use slash commands!
+
+Try: /taskmaster:init your-prd.md
+```
+
+## Next Steps
+
+After installation:
+1. Run `/taskmaster:status` to verify setup
+2. Configure AI providers with `/taskmaster:setup-models`
+3. Start using Task Master commands!