data_porter 0.1.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (168) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +62 -1
  3. data/README.md +63 -386
  4. data/ROADMAP.md +89 -0
  5. data/app/assets/javascripts/data_porter/stimulus.min.js +2 -0
  6. data/app/assets/javascripts/data_porter/turbo.min.js +29 -0
  7. data/app/assets/stylesheets/data_porter/alerts.css +25 -0
  8. data/app/assets/stylesheets/data_porter/application.css +12 -646
  9. data/app/assets/stylesheets/data_porter/badges.css +73 -0
  10. data/app/assets/stylesheets/data_porter/base.css +56 -0
  11. data/app/assets/stylesheets/data_porter/cards.css +60 -0
  12. data/app/assets/stylesheets/data_porter/layout.css +128 -0
  13. data/app/assets/stylesheets/data_porter/mapping.css +79 -0
  14. data/app/assets/stylesheets/data_porter/modal.css +49 -0
  15. data/app/assets/stylesheets/data_porter/preview.css +24 -0
  16. data/app/assets/stylesheets/data_porter/progress.css +37 -0
  17. data/app/assets/stylesheets/data_porter/table.css +45 -0
  18. data/app/controllers/data_porter/imports_controller.rb +74 -10
  19. data/app/controllers/data_porter/mapping_templates_controller.rb +85 -0
  20. data/app/javascript/data_porter/mapping_controller.js +86 -0
  21. data/app/javascript/data_porter/progress_controller.js +1 -1
  22. data/app/javascript/data_porter/template_form_controller.js +46 -0
  23. data/app/jobs/data_porter/extract_headers_job.rb +12 -0
  24. data/app/models/data_porter/data_import.rb +8 -2
  25. data/app/models/data_porter/mapping_template.rb +15 -0
  26. data/app/views/data_porter/imports/index.html.erb +9 -8
  27. data/app/views/data_porter/imports/new.html.erb +10 -4
  28. data/app/views/data_porter/imports/show.html.erb +41 -13
  29. data/app/views/data_porter/mapping_templates/_form.html.erb +40 -0
  30. data/app/views/data_porter/mapping_templates/edit.html.erb +11 -0
  31. data/app/views/data_porter/mapping_templates/index.html.erb +42 -0
  32. data/app/views/data_porter/mapping_templates/new.html.erb +11 -0
  33. data/app/views/layouts/data_porter/application.html.erb +162 -0
  34. data/config/routes.rb +3 -0
  35. data/docs/CONFIGURATION.md +81 -0
  36. data/docs/MAPPING.md +44 -0
  37. data/docs/SOURCES.md +94 -0
  38. data/docs/TARGETS.md +176 -0
  39. data/docs/screenshots/mapping.jpg +0 -0
  40. data/lib/data_porter/components/mapping/column_row.rb +52 -0
  41. data/lib/data_porter/components/mapping/form.rb +127 -0
  42. data/lib/data_porter/components/mapping/template_select.rb +35 -0
  43. data/lib/data_porter/components/preview/results_summary.rb +21 -0
  44. data/lib/data_porter/components/preview/summary_cards.rb +32 -0
  45. data/lib/data_porter/components/preview/table.rb +56 -0
  46. data/lib/data_porter/components/progress/bar.rb +35 -0
  47. data/lib/data_porter/components/shared/failure_alert.rb +22 -0
  48. data/lib/data_porter/components/shared/status_badge.rb +18 -0
  49. data/lib/data_porter/components.rb +9 -6
  50. data/lib/data_porter/configuration.rb +1 -1
  51. data/lib/data_porter/engine.rb +7 -1
  52. data/lib/data_porter/orchestrator.rb +21 -1
  53. data/lib/data_porter/sources/base.rb +18 -3
  54. data/lib/data_porter/sources/csv.rb +5 -0
  55. data/lib/data_porter/sources/xlsx.rb +76 -0
  56. data/lib/data_porter/sources.rb +3 -1
  57. data/lib/data_porter/version.rb +1 -1
  58. data/lib/generators/data_porter/install/install_generator.rb +4 -0
  59. data/lib/generators/data_porter/install/templates/create_data_porter_mapping_templates.rb.erb +16 -0
  60. data/lib/generators/data_porter/install/templates/initializer.rb +1 -1
  61. metadata +72 -135
  62. data/.claude/commands/blog-status.md +0 -10
  63. data/.claude/commands/blog.md +0 -109
  64. data/.claude/commands/task-done.md +0 -27
  65. data/.claude/commands/tm/add-dependency.md +0 -58
  66. data/.claude/commands/tm/add-subtask.md +0 -79
  67. data/.claude/commands/tm/add-task.md +0 -81
  68. data/.claude/commands/tm/analyze-complexity.md +0 -124
  69. data/.claude/commands/tm/analyze-project.md +0 -100
  70. data/.claude/commands/tm/auto-implement-tasks.md +0 -100
  71. data/.claude/commands/tm/command-pipeline.md +0 -80
  72. data/.claude/commands/tm/complexity-report.md +0 -120
  73. data/.claude/commands/tm/convert-task-to-subtask.md +0 -74
  74. data/.claude/commands/tm/expand-all-tasks.md +0 -52
  75. data/.claude/commands/tm/expand-task.md +0 -52
  76. data/.claude/commands/tm/fix-dependencies.md +0 -82
  77. data/.claude/commands/tm/help.md +0 -101
  78. data/.claude/commands/tm/init-project-quick.md +0 -49
  79. data/.claude/commands/tm/init-project.md +0 -53
  80. data/.claude/commands/tm/install-taskmaster.md +0 -118
  81. data/.claude/commands/tm/learn.md +0 -106
  82. data/.claude/commands/tm/list-tasks-by-status.md +0 -42
  83. data/.claude/commands/tm/list-tasks-with-subtasks.md +0 -30
  84. data/.claude/commands/tm/list-tasks.md +0 -46
  85. data/.claude/commands/tm/next-task.md +0 -69
  86. data/.claude/commands/tm/parse-prd-with-research.md +0 -51
  87. data/.claude/commands/tm/parse-prd.md +0 -52
  88. data/.claude/commands/tm/project-status.md +0 -67
  89. data/.claude/commands/tm/quick-install-taskmaster.md +0 -23
  90. data/.claude/commands/tm/remove-all-subtasks.md +0 -94
  91. data/.claude/commands/tm/remove-dependency.md +0 -65
  92. data/.claude/commands/tm/remove-subtask.md +0 -87
  93. data/.claude/commands/tm/remove-subtasks.md +0 -89
  94. data/.claude/commands/tm/remove-task.md +0 -110
  95. data/.claude/commands/tm/setup-models.md +0 -52
  96. data/.claude/commands/tm/show-task.md +0 -85
  97. data/.claude/commands/tm/smart-workflow.md +0 -58
  98. data/.claude/commands/tm/sync-readme.md +0 -120
  99. data/.claude/commands/tm/tm-main.md +0 -147
  100. data/.claude/commands/tm/to-cancelled.md +0 -58
  101. data/.claude/commands/tm/to-deferred.md +0 -50
  102. data/.claude/commands/tm/to-done.md +0 -47
  103. data/.claude/commands/tm/to-in-progress.md +0 -39
  104. data/.claude/commands/tm/to-pending.md +0 -35
  105. data/.claude/commands/tm/to-review.md +0 -43
  106. data/.claude/commands/tm/update-single-task.md +0 -122
  107. data/.claude/commands/tm/update-task.md +0 -75
  108. data/.claude/commands/tm/update-tasks-from-id.md +0 -111
  109. data/.claude/commands/tm/validate-dependencies.md +0 -72
  110. data/.claude/commands/tm/view-models.md +0 -52
  111. data/.env.example +0 -12
  112. data/.mcp.json +0 -24
  113. data/.taskmaster/CLAUDE.md +0 -435
  114. data/.taskmaster/config.json +0 -44
  115. data/.taskmaster/docs/prd.txt +0 -2044
  116. data/.taskmaster/state.json +0 -6
  117. data/.taskmaster/tasks/task_001.md +0 -19
  118. data/.taskmaster/tasks/task_002.md +0 -19
  119. data/.taskmaster/tasks/task_003.md +0 -19
  120. data/.taskmaster/tasks/task_004.md +0 -19
  121. data/.taskmaster/tasks/task_005.md +0 -19
  122. data/.taskmaster/tasks/task_006.md +0 -19
  123. data/.taskmaster/tasks/task_007.md +0 -19
  124. data/.taskmaster/tasks/task_008.md +0 -19
  125. data/.taskmaster/tasks/task_009.md +0 -19
  126. data/.taskmaster/tasks/task_010.md +0 -19
  127. data/.taskmaster/tasks/task_011.md +0 -19
  128. data/.taskmaster/tasks/task_012.md +0 -19
  129. data/.taskmaster/tasks/task_013.md +0 -19
  130. data/.taskmaster/tasks/task_014.md +0 -19
  131. data/.taskmaster/tasks/task_015.md +0 -19
  132. data/.taskmaster/tasks/task_016.md +0 -19
  133. data/.taskmaster/tasks/task_017.md +0 -19
  134. data/.taskmaster/tasks/task_018.md +0 -19
  135. data/.taskmaster/tasks/task_019.md +0 -19
  136. data/.taskmaster/tasks/task_020.md +0 -19
  137. data/.taskmaster/tasks/tasks.json +0 -299
  138. data/.taskmaster/templates/example_prd.txt +0 -47
  139. data/.taskmaster/templates/example_prd_rpg.txt +0 -511
  140. data/CLAUDE.md +0 -65
  141. data/config/database.yml +0 -3
  142. data/docs/SPEC.md +0 -2012
  143. data/docs/UI.md +0 -32
  144. data/docs/blog/001-why-build-a-data-import-engine.md +0 -166
  145. data/docs/blog/002-scaffolding-a-rails-engine.md +0 -188
  146. data/docs/blog/003-configuration-dsl.md +0 -222
  147. data/docs/blog/004-store-model-jsonb.md +0 -237
  148. data/docs/blog/005-target-dsl.md +0 -284
  149. data/docs/blog/006-parsing-csv-sources.md +0 -300
  150. data/docs/blog/007-orchestrator.md +0 -247
  151. data/docs/blog/008-actioncable-stimulus.md +0 -376
  152. data/docs/blog/009-phlex-ui-components.md +0 -446
  153. data/docs/blog/010-controllers-routing.md +0 -374
  154. data/docs/blog/011-generators.md +0 -364
  155. data/docs/blog/012-json-api-sources.md +0 -323
  156. data/docs/blog/013-testing-rails-engine.md +0 -618
  157. data/docs/blog/014-dry-run.md +0 -307
  158. data/docs/blog/015-publishing-retro.md +0 -264
  159. data/docs/blog/016-erb-view-templates.md +0 -431
  160. data/docs/blog/017-showcase-final-retro.md +0 -220
  161. data/docs/blog/BACKLOG.md +0 -8
  162. data/docs/blog/SERIES.md +0 -154
  163. data/lib/data_porter/components/failure_alert.rb +0 -20
  164. data/lib/data_porter/components/preview_table.rb +0 -54
  165. data/lib/data_porter/components/progress_bar.rb +0 -33
  166. data/lib/data_porter/components/results_summary.rb +0 -19
  167. data/lib/data_porter/components/status_badge.rb +0 -16
  168. data/lib/data_porter/components/summary_cards.rb +0 -30
@@ -1,124 +0,0 @@
1
- Analyze Complexity
2
-
3
- Arguments: $ARGUMENTS
4
- Analyze task complexity and generate expansion recommendations.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- Perform deep analysis of task complexity across the project.
9
-
10
- ## Complexity Analysis
11
-
12
- Uses AI to analyze tasks and recommend which ones need breakdown.
13
-
14
- ## Execution Options
15
-
16
- ```bash
17
- task-master analyze-complexity [--research] [--threshold=5]
18
- ```
19
-
20
- ## Analysis Parameters
21
-
22
- - `--research` → Use research AI for deeper analysis
23
- - `--threshold=5` → Only flag tasks above complexity 5
24
- - Default: Analyze all pending tasks
25
-
26
- ## Analysis Process
27
-
28
- ### 1. **Task Evaluation**
29
- For each task, AI evaluates:
30
- - Technical complexity
31
- - Time requirements
32
- - Dependency complexity
33
- - Risk factors
34
- - Knowledge requirements
35
-
36
- ### 2. **Complexity Scoring**
37
- Assigns score 1-10 based on:
38
- - Implementation difficulty
39
- - Integration challenges
40
- - Testing requirements
41
- - Unknown factors
42
- - Technical debt risk
43
-
44
- ### 3. **Recommendations**
45
- For complex tasks:
46
- - Suggest expansion approach
47
- - Recommend subtask breakdown
48
- - Identify risk areas
49
- - Propose mitigation strategies
50
-
51
- ## Smart Analysis Features
52
-
53
- 1. **Pattern Recognition**
54
- - Similar task comparisons
55
- - Historical complexity accuracy
56
- - Team velocity consideration
57
- - Technology stack factors
58
-
59
- 2. **Contextual Factors**
60
- - Team expertise
61
- - Available resources
62
- - Timeline constraints
63
- - Business criticality
64
-
65
- 3. **Risk Assessment**
66
- - Technical risks
67
- - Timeline risks
68
- - Dependency risks
69
- - Knowledge gaps
70
-
71
- ## Output Format
72
-
73
- ```
74
- Task Complexity Analysis Report
75
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
76
-
77
- High Complexity Tasks (>7):
78
- 📍 #5 "Implement real-time sync" - Score: 9/10
79
- Factors: WebSocket complexity, state management, conflict resolution
80
- Recommendation: Expand into 5-7 subtasks
81
- Risks: Performance, data consistency
82
-
83
- 📍 #12 "Migrate database schema" - Score: 8/10
84
- Factors: Data migration, zero downtime, rollback strategy
85
- Recommendation: Expand into 4-5 subtasks
86
- Risks: Data loss, downtime
87
-
88
- Medium Complexity Tasks (5-7):
89
- 📍 #23 "Add export functionality" - Score: 6/10
90
- Consider expansion if timeline tight
91
-
92
- Low Complexity Tasks (<5):
93
- ✅ 15 tasks - No expansion needed
94
-
95
- Summary:
96
- - Expand immediately: 2 tasks
97
- - Consider expanding: 5 tasks
98
- - Keep as-is: 15 tasks
99
- ```
100
-
101
- ## Actionable Output
102
-
103
- For each high-complexity task:
104
- 1. Complexity score with reasoning
105
- 2. Specific expansion suggestions
106
- 3. Risk mitigation approaches
107
- 4. Recommended subtask structure
108
-
109
- ## Integration
110
-
111
- Results are:
112
- - Saved to `.taskmaster/reports/complexity-analysis.md`
113
- - Used by expand command
114
- - Inform sprint planning
115
- - Guide resource allocation
116
-
117
- ## Next Steps
118
-
119
- After analysis:
120
- ```
121
- /taskmaster:expand 5 # Expand specific task
122
- /taskmaster:expand-all # Expand all recommended
123
- /taskmaster:complexity-report # View detailed report
124
- ```
@@ -1,100 +0,0 @@
1
- Analyze Project
2
-
3
- Arguments: $ARGUMENTS
4
- Advanced project analysis with actionable insights and recommendations.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- ## Comprehensive Project Analysis
9
-
10
- Multi-dimensional analysis based on requested focus area.
11
-
12
- ### 1. **Analysis Modes**
13
-
14
- Based on $ARGUMENTS:
15
- - "velocity" → Sprint velocity and trends
16
- - "quality" → Code quality metrics
17
- - "risk" → Risk assessment and mitigation
18
- - "dependencies" → Dependency graph analysis
19
- - "team" → Workload and skill distribution
20
- - "architecture" → System design coherence
21
- - Default → Full spectrum analysis
22
-
23
- ### 2. **Velocity Analytics**
24
-
25
- ```
26
- 📊 Velocity Analysis
27
- ━━━━━━━━━━━━━━━━━━━
28
- Current Sprint: 24 points/week ↗️ +20%
29
- Rolling Average: 20 points/week
30
- Efficiency: 85% (17/20 tasks on time)
31
-
32
- Bottlenecks Detected:
33
- - Code review delays (avg 4h wait)
34
- - Test environment availability
35
- - Dependency on external team
36
-
37
- Recommendations:
38
- 1. Implement parallel review process
39
- 2. Add staging environment
40
- 3. Mock external dependencies
41
- ```
42
-
43
- ### 3. **Risk Assessment**
44
-
45
- **Technical Risks**
46
- - High complexity tasks without backup assignee
47
- - Single points of failure in architecture
48
- - Insufficient test coverage in critical paths
49
- - Technical debt accumulation rate
50
-
51
- **Project Risks**
52
- - Critical path dependencies
53
- - Resource availability gaps
54
- - Deadline feasibility analysis
55
- - Scope creep indicators
56
-
57
- ### 4. **Dependency Intelligence**
58
-
59
- Visual dependency analysis:
60
- ```
61
- Critical Path:
62
- #12 → #15 → #23 → #45 → #50 (20 days)
63
- ↘ #24 → #46 ↗
64
-
65
- Optimization: Parallelize #15 and #24
66
- Time Saved: 3 days
67
- ```
68
-
69
- ### 5. **Quality Metrics**
70
-
71
- **Code Quality**
72
- - Test coverage trends
73
- - Complexity scores
74
- - Technical debt ratio
75
- - Review feedback patterns
76
-
77
- **Process Quality**
78
- - Rework frequency
79
- - Bug introduction rate
80
- - Time to resolution
81
- - Knowledge distribution
82
-
83
- ### 6. **Predictive Insights**
84
-
85
- Based on patterns:
86
- - Completion probability by deadline
87
- - Resource needs projection
88
- - Risk materialization likelihood
89
- - Suggested interventions
90
-
91
- ### 7. **Executive Dashboard**
92
-
93
- High-level summary with:
94
- - Health score (0-100)
95
- - Top 3 risks
96
- - Top 3 opportunities
97
- - Recommended actions
98
- - Success probability
99
-
100
- Result: Data-driven decisions with clear action paths.
@@ -1,100 +0,0 @@
1
- Auto Implement Tasks
2
-
3
- Arguments: $ARGUMENTS
4
- Enhanced auto-implementation with intelligent code generation and testing.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- ## Intelligent Auto-Implementation
9
-
10
- Advanced implementation with context awareness and quality checks.
11
-
12
- ### 1. **Pre-Implementation Analysis**
13
-
14
- Before starting:
15
- - Analyze task complexity and requirements
16
- - Check codebase patterns and conventions
17
- - Identify similar completed tasks
18
- - Assess test coverage needs
19
- - Detect potential risks
20
-
21
- ### 2. **Smart Implementation Strategy**
22
-
23
- Based on task type and context:
24
-
25
- **Feature Tasks**
26
- 1. Research existing patterns
27
- 2. Design component architecture
28
- 3. Implement with tests
29
- 4. Integrate with system
30
- 5. Update documentation
31
-
32
- **Bug Fix Tasks**
33
- 1. Reproduce issue
34
- 2. Identify root cause
35
- 3. Implement minimal fix
36
- 4. Add regression tests
37
- 5. Verify side effects
38
-
39
- **Refactoring Tasks**
40
- 1. Analyze current structure
41
- 2. Plan incremental changes
42
- 3. Maintain test coverage
43
- 4. Refactor step-by-step
44
- 5. Verify behavior unchanged
45
-
46
- ### 3. **Code Intelligence**
47
-
48
- **Pattern Recognition**
49
- - Learn from existing code
50
- - Follow team conventions
51
- - Use preferred libraries
52
- - Match style guidelines
53
-
54
- **Test-Driven Approach**
55
- - Write tests first when possible
56
- - Ensure comprehensive coverage
57
- - Include edge cases
58
- - Performance considerations
59
-
60
- ### 4. **Progressive Implementation**
61
-
62
- Step-by-step with validation:
63
- ```
64
- Step 1/5: Setting up component structure ✓
65
- Step 2/5: Implementing core logic ✓
66
- Step 3/5: Adding error handling ⚡ (in progress)
67
- Step 4/5: Writing tests ⏳
68
- Step 5/5: Integration testing ⏳
69
-
70
- Current: Adding try-catch blocks and validation...
71
- ```
72
-
73
- ### 5. **Quality Assurance**
74
-
75
- Automated checks:
76
- - Linting and formatting
77
- - Test execution
78
- - Type checking
79
- - Dependency validation
80
- - Performance analysis
81
-
82
- ### 6. **Smart Recovery**
83
-
84
- If issues arise:
85
- - Diagnostic analysis
86
- - Suggestion generation
87
- - Fallback strategies
88
- - Manual intervention points
89
- - Learning from failures
90
-
91
- ### 7. **Post-Implementation**
92
-
93
- After completion:
94
- - Generate PR description
95
- - Update documentation
96
- - Log lessons learned
97
- - Suggest follow-up tasks
98
- - Update task relationships
99
-
100
- Result: High-quality, production-ready implementations.
@@ -1,80 +0,0 @@
1
- Command Pipeline
2
-
3
- Arguments: $ARGUMENTS
4
- Execute a pipeline of commands based on a specification.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- ## Command Pipeline Execution
9
-
10
- Parse pipeline specification from arguments. Supported formats:
11
-
12
- ### Simple Pipeline
13
- `init → expand-all → sprint-plan`
14
-
15
- ### Conditional Pipeline
16
- `status → if:pending>10 → sprint-plan → else → next`
17
-
18
- ### Iterative Pipeline
19
- `for:pending-tasks → expand → complexity-check`
20
-
21
- ### Smart Pipeline Patterns
22
-
23
- **1. Project Setup Pipeline**
24
- ```
25
- init [prd] →
26
- expand-all →
27
- complexity-report →
28
- sprint-plan →
29
- show first-sprint
30
- ```
31
-
32
- **2. Daily Work Pipeline**
33
- ```
34
- standup →
35
- if:in-progress → continue →
36
- else → next → start
37
- ```
38
-
39
- **3. Task Completion Pipeline**
40
- ```
41
- complete [id] →
42
- git-commit →
43
- if:blocked-tasks-freed → show-freed →
44
- next
45
- ```
46
-
47
- **4. Quality Check Pipeline**
48
- ```
49
- list in-progress →
50
- for:each → check-idle-time →
51
- if:idle>1day → prompt-update
52
- ```
53
-
54
- ### Pipeline Features
55
-
56
- **Variables**
57
- - Store results: `status → $count=pending-count`
58
- - Use in conditions: `if:$count>10`
59
- - Pass between commands: `expand $high-priority-tasks`
60
-
61
- **Error Handling**
62
- - On failure: `try:complete → catch:show-blockers`
63
- - Skip on error: `optional:test-run`
64
- - Retry logic: `retry:3:commit`
65
-
66
- **Parallel Execution**
67
- - Parallel branches: `[analyze | test | lint]`
68
- - Join results: `parallel → join:report`
69
-
70
- ### Execution Flow
71
-
72
- 1. Parse pipeline specification
73
- 2. Validate command sequence
74
- 3. Execute with state passing
75
- 4. Handle conditions and loops
76
- 5. Aggregate results
77
- 6. Show summary
78
-
79
- This enables complex workflows like:
80
- `parse-prd → expand-all → filter:complex>70 → assign:senior → sprint-plan:weighted`
@@ -1,120 +0,0 @@
1
- Complexity Report
2
-
3
- Arguments: $ARGUMENTS
4
- Display the task complexity analysis report.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- View the detailed complexity analysis generated by analyze-complexity command.
9
-
10
- ## Viewing Complexity Report
11
-
12
- Shows comprehensive task complexity analysis with actionable insights.
13
-
14
- ## Execution
15
-
16
- ```bash
17
- task-master complexity-report [--file=<path>]
18
- ```
19
-
20
- ## Report Location
21
-
22
- Default: `.taskmaster/reports/complexity-analysis.md`
23
- Custom: Specify with --file parameter
24
-
25
- ## Report Contents
26
-
27
- ### 1. **Executive Summary**
28
- ```
29
- Complexity Analysis Summary
30
- ━━━━━━━━━━━━━━━━━━━━━━━━
31
- Analysis Date: 2024-01-15
32
- Tasks Analyzed: 32
33
- High Complexity: 5 (16%)
34
- Medium Complexity: 12 (37%)
35
- Low Complexity: 15 (47%)
36
-
37
- Critical Findings:
38
- - 5 tasks need immediate expansion
39
- - 3 tasks have high technical risk
40
- - 2 tasks block critical path
41
- ```
42
-
43
- ### 2. **Detailed Task Analysis**
44
- For each complex task:
45
- - Complexity score breakdown
46
- - Contributing factors
47
- - Specific risks identified
48
- - Expansion recommendations
49
- - Similar completed tasks
50
-
51
- ### 3. **Risk Matrix**
52
- Visual representation:
53
- ```
54
- Risk vs Complexity Matrix
55
- ━━━━━━━━━━━━━━━━━━━━━━━
56
- High Risk | #5(9) #12(8) | #23(6)
57
- Med Risk | #34(7) | #45(5) #67(5)
58
- Low Risk | #78(8) | [15 tasks]
59
- | High Complex | Med Complex
60
- ```
61
-
62
- ### 4. **Recommendations**
63
-
64
- **Immediate Actions:**
65
- 1. Expand task #5 - Critical path + high complexity
66
- 2. Expand task #12 - High risk + dependencies
67
- 3. Review task #34 - Consider splitting
68
-
69
- **Sprint Planning:**
70
- - Don't schedule multiple high-complexity tasks together
71
- - Ensure expertise available for complex tasks
72
- - Build in buffer time for unknowns
73
-
74
- ## Interactive Features
75
-
76
- When viewing report:
77
- 1. **Quick Actions**
78
- - Press 'e' to expand a task
79
- - Press 'd' for task details
80
- - Press 'r' to refresh analysis
81
-
82
- 2. **Filtering**
83
- - View by complexity level
84
- - Filter by risk factors
85
- - Show only actionable items
86
-
87
- 3. **Export Options**
88
- - Markdown format
89
- - CSV for spreadsheets
90
- - JSON for tools
91
-
92
- ## Report Intelligence
93
-
94
- - Compares with historical data
95
- - Shows complexity trends
96
- - Identifies patterns
97
- - Suggests process improvements
98
-
99
- ## Integration
100
-
101
- Use report for:
102
- - Sprint planning sessions
103
- - Resource allocation
104
- - Risk assessment
105
- - Team discussions
106
- - Client updates
107
-
108
- ## Example Usage
109
-
110
- ```
111
- /taskmaster:complexity-report
112
- → Opens latest analysis
113
-
114
- /taskmaster:complexity-report --file=archived/2024-01-01.md
115
- → View historical analysis
116
-
117
- After viewing:
118
- /taskmaster:expand 5
119
- → Expand high-complexity task
120
- ```
@@ -1,74 +0,0 @@
1
- Convert Task To Subtask
2
-
3
- Arguments: $ARGUMENTS
4
- Convert an existing task into a subtask.
5
-
6
- Arguments: $ARGUMENTS
7
-
8
- Parse parent ID and task ID to convert.
9
-
10
- ## Task Conversion
11
-
12
- Converts an existing standalone task into a subtask of another task.
13
-
14
- ## Argument Parsing
15
-
16
- - "move task 8 under 5"
17
- - "make 8 a subtask of 5"
18
- - "nest 8 in 5"
19
- - "5 8" → make task 8 a subtask of task 5
20
-
21
- ## Execution
22
-
23
- ```bash
24
- task-master add-subtask --parent=<parent-id> --task-id=<task-to-convert>
25
- ```
26
-
27
- ## Pre-Conversion Checks
28
-
29
- 1. **Validation**
30
- - Both tasks exist and are valid
31
- - No circular parent relationships
32
- - Task isn't already a subtask
33
- - Logical hierarchy makes sense
34
-
35
- 2. **Impact Analysis**
36
- - Dependencies that will be affected
37
- - Tasks that depend on converting task
38
- - Priority alignment needed
39
- - Status compatibility
40
-
41
- ## Conversion Process
42
-
43
- 1. Change task ID from "8" to "5.1" (next available)
44
- 2. Update all dependency references
45
- 3. Inherit parent's context where appropriate
46
- 4. Adjust priorities if needed
47
- 5. Update time estimates
48
-
49
- ## Smart Features
50
-
51
- - Preserve task history
52
- - Maintain dependencies
53
- - Update all references
54
- - Create conversion log
55
-
56
- ## Example
57
-
58
- ```
59
- /taskmaster:add-subtask/from-task 5 8
60
- → Converting: Task #8 becomes subtask #5.1
61
- → Updated: 3 dependency references
62
- → Parent task #5 now has 1 subtask
63
- → Note: Subtask inherits parent's priority
64
-
65
- Before: #8 "Implement validation" (standalone)
66
- After: #5.1 "Implement validation" (subtask of #5)
67
- ```
68
-
69
- ## Post-Conversion
70
-
71
- - Show new task hierarchy
72
- - List updated dependencies
73
- - Verify project integrity
74
- - Suggest related conversions
@@ -1,52 +0,0 @@
1
- Expand All Tasks
2
- Expand all pending tasks that need subtasks.
3
-
4
- ## Bulk Task Expansion
5
-
6
- Intelligently expands all tasks that would benefit from breakdown.
7
-
8
- ## Execution
9
-
10
- ```bash
11
- task-master expand --all
12
- ```
13
-
14
- ## Smart Selection
15
-
16
- Only expands tasks that:
17
- - Are marked as pending
18
- - Have high complexity (>5)
19
- - Lack existing subtasks
20
- - Would benefit from breakdown
21
-
22
- ## Expansion Process
23
-
24
- 1. **Analysis Phase**
25
- - Identify expansion candidates
26
- - Group related tasks
27
- - Plan expansion strategy
28
-
29
- 2. **Batch Processing**
30
- - Expand tasks in logical order
31
- - Maintain consistency
32
- - Preserve relationships
33
- - Optimize for parallelism
34
-
35
- 3. **Quality Control**
36
- - Ensure subtask quality
37
- - Avoid over-decomposition
38
- - Maintain task coherence
39
- - Update dependencies
40
-
41
- ## Options
42
-
43
- - Add `force` to expand all regardless of complexity
44
- - Add `research` for enhanced AI analysis
45
-
46
- ## Results
47
-
48
- After bulk expansion:
49
- - Summary of tasks expanded
50
- - New subtask count
51
- - Updated complexity metrics
52
- - Suggested task order
@@ -1,52 +0,0 @@
1
- Expand Task
2
-
3
- Arguments: $ARGUMENTS
4
- Break down a complex task into subtasks.
5
-
6
- Arguments: $ARGUMENTS (task ID)
7
-
8
- ## Intelligent Task Expansion
9
-
10
- Analyzes a task and creates detailed subtasks for better manageability.
11
-
12
- ## Execution
13
-
14
- ```bash
15
- task-master expand --id=$ARGUMENTS
16
- ```
17
-
18
- ## Expansion Process
19
-
20
- 1. **Task Analysis**
21
- - Review task complexity
22
- - Identify components
23
- - Detect technical challenges
24
- - Estimate time requirements
25
-
26
- 2. **Subtask Generation**
27
- - Create 3-7 subtasks typically
28
- - Each subtask 1-4 hours
29
- - Logical implementation order
30
- - Clear acceptance criteria
31
-
32
- 3. **Smart Breakdown**
33
- - Setup/configuration tasks
34
- - Core implementation
35
- - Testing components
36
- - Integration steps
37
- - Documentation updates
38
-
39
- ## Enhanced Features
40
-
41
- Based on task type:
42
- - **Feature**: Setup → Implement → Test → Integrate
43
- - **Bug Fix**: Reproduce → Diagnose → Fix → Verify
44
- - **Refactor**: Analyze → Plan → Refactor → Validate
45
-
46
- ## Post-Expansion
47
-
48
- After expansion:
49
- 1. Show subtask hierarchy
50
- 2. Update time estimates
51
- 3. Suggest implementation order
52
- 4. Highlight critical path