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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +62 -1
- data/README.md +63 -386
- data/ROADMAP.md +89 -0
- data/app/assets/javascripts/data_porter/stimulus.min.js +2 -0
- data/app/assets/javascripts/data_porter/turbo.min.js +29 -0
- data/app/assets/stylesheets/data_porter/alerts.css +25 -0
- data/app/assets/stylesheets/data_porter/application.css +12 -646
- data/app/assets/stylesheets/data_porter/badges.css +73 -0
- data/app/assets/stylesheets/data_porter/base.css +56 -0
- data/app/assets/stylesheets/data_porter/cards.css +60 -0
- data/app/assets/stylesheets/data_porter/layout.css +128 -0
- data/app/assets/stylesheets/data_porter/mapping.css +79 -0
- data/app/assets/stylesheets/data_porter/modal.css +49 -0
- data/app/assets/stylesheets/data_porter/preview.css +24 -0
- data/app/assets/stylesheets/data_porter/progress.css +37 -0
- data/app/assets/stylesheets/data_porter/table.css +45 -0
- data/app/controllers/data_porter/imports_controller.rb +74 -10
- data/app/controllers/data_porter/mapping_templates_controller.rb +85 -0
- data/app/javascript/data_porter/mapping_controller.js +86 -0
- data/app/javascript/data_porter/progress_controller.js +1 -1
- data/app/javascript/data_porter/template_form_controller.js +46 -0
- data/app/jobs/data_porter/extract_headers_job.rb +12 -0
- data/app/models/data_porter/data_import.rb +8 -2
- data/app/models/data_porter/mapping_template.rb +15 -0
- data/app/views/data_porter/imports/index.html.erb +9 -8
- data/app/views/data_porter/imports/new.html.erb +10 -4
- data/app/views/data_porter/imports/show.html.erb +41 -13
- data/app/views/data_porter/mapping_templates/_form.html.erb +40 -0
- data/app/views/data_porter/mapping_templates/edit.html.erb +11 -0
- data/app/views/data_porter/mapping_templates/index.html.erb +42 -0
- data/app/views/data_porter/mapping_templates/new.html.erb +11 -0
- data/app/views/layouts/data_porter/application.html.erb +162 -0
- data/config/routes.rb +3 -0
- data/docs/CONFIGURATION.md +81 -0
- data/docs/MAPPING.md +44 -0
- data/docs/SOURCES.md +94 -0
- data/docs/TARGETS.md +176 -0
- data/docs/screenshots/mapping.jpg +0 -0
- data/lib/data_porter/components/mapping/column_row.rb +52 -0
- data/lib/data_porter/components/mapping/form.rb +127 -0
- data/lib/data_porter/components/mapping/template_select.rb +35 -0
- data/lib/data_porter/components/preview/results_summary.rb +21 -0
- data/lib/data_porter/components/preview/summary_cards.rb +32 -0
- data/lib/data_porter/components/preview/table.rb +56 -0
- data/lib/data_porter/components/progress/bar.rb +35 -0
- data/lib/data_porter/components/shared/failure_alert.rb +22 -0
- data/lib/data_porter/components/shared/status_badge.rb +18 -0
- data/lib/data_porter/components.rb +9 -6
- data/lib/data_porter/configuration.rb +1 -1
- data/lib/data_porter/engine.rb +7 -1
- data/lib/data_porter/orchestrator.rb +21 -1
- data/lib/data_porter/sources/base.rb +18 -3
- data/lib/data_porter/sources/csv.rb +5 -0
- data/lib/data_porter/sources/xlsx.rb +76 -0
- data/lib/data_porter/sources.rb +3 -1
- data/lib/data_porter/version.rb +1 -1
- data/lib/generators/data_porter/install/install_generator.rb +4 -0
- data/lib/generators/data_porter/install/templates/create_data_porter_mapping_templates.rb.erb +16 -0
- data/lib/generators/data_porter/install/templates/initializer.rb +1 -1
- metadata +72 -135
- data/.claude/commands/blog-status.md +0 -10
- data/.claude/commands/blog.md +0 -109
- data/.claude/commands/task-done.md +0 -27
- data/.claude/commands/tm/add-dependency.md +0 -58
- data/.claude/commands/tm/add-subtask.md +0 -79
- data/.claude/commands/tm/add-task.md +0 -81
- data/.claude/commands/tm/analyze-complexity.md +0 -124
- data/.claude/commands/tm/analyze-project.md +0 -100
- data/.claude/commands/tm/auto-implement-tasks.md +0 -100
- data/.claude/commands/tm/command-pipeline.md +0 -80
- data/.claude/commands/tm/complexity-report.md +0 -120
- data/.claude/commands/tm/convert-task-to-subtask.md +0 -74
- data/.claude/commands/tm/expand-all-tasks.md +0 -52
- data/.claude/commands/tm/expand-task.md +0 -52
- data/.claude/commands/tm/fix-dependencies.md +0 -82
- data/.claude/commands/tm/help.md +0 -101
- data/.claude/commands/tm/init-project-quick.md +0 -49
- data/.claude/commands/tm/init-project.md +0 -53
- data/.claude/commands/tm/install-taskmaster.md +0 -118
- data/.claude/commands/tm/learn.md +0 -106
- data/.claude/commands/tm/list-tasks-by-status.md +0 -42
- data/.claude/commands/tm/list-tasks-with-subtasks.md +0 -30
- data/.claude/commands/tm/list-tasks.md +0 -46
- data/.claude/commands/tm/next-task.md +0 -69
- data/.claude/commands/tm/parse-prd-with-research.md +0 -51
- data/.claude/commands/tm/parse-prd.md +0 -52
- data/.claude/commands/tm/project-status.md +0 -67
- data/.claude/commands/tm/quick-install-taskmaster.md +0 -23
- data/.claude/commands/tm/remove-all-subtasks.md +0 -94
- data/.claude/commands/tm/remove-dependency.md +0 -65
- data/.claude/commands/tm/remove-subtask.md +0 -87
- data/.claude/commands/tm/remove-subtasks.md +0 -89
- data/.claude/commands/tm/remove-task.md +0 -110
- data/.claude/commands/tm/setup-models.md +0 -52
- data/.claude/commands/tm/show-task.md +0 -85
- data/.claude/commands/tm/smart-workflow.md +0 -58
- data/.claude/commands/tm/sync-readme.md +0 -120
- data/.claude/commands/tm/tm-main.md +0 -147
- data/.claude/commands/tm/to-cancelled.md +0 -58
- data/.claude/commands/tm/to-deferred.md +0 -50
- data/.claude/commands/tm/to-done.md +0 -47
- data/.claude/commands/tm/to-in-progress.md +0 -39
- data/.claude/commands/tm/to-pending.md +0 -35
- data/.claude/commands/tm/to-review.md +0 -43
- data/.claude/commands/tm/update-single-task.md +0 -122
- data/.claude/commands/tm/update-task.md +0 -75
- data/.claude/commands/tm/update-tasks-from-id.md +0 -111
- data/.claude/commands/tm/validate-dependencies.md +0 -72
- data/.claude/commands/tm/view-models.md +0 -52
- data/.env.example +0 -12
- data/.mcp.json +0 -24
- data/.taskmaster/CLAUDE.md +0 -435
- data/.taskmaster/config.json +0 -44
- data/.taskmaster/docs/prd.txt +0 -2044
- data/.taskmaster/state.json +0 -6
- data/.taskmaster/tasks/task_001.md +0 -19
- data/.taskmaster/tasks/task_002.md +0 -19
- data/.taskmaster/tasks/task_003.md +0 -19
- data/.taskmaster/tasks/task_004.md +0 -19
- data/.taskmaster/tasks/task_005.md +0 -19
- data/.taskmaster/tasks/task_006.md +0 -19
- data/.taskmaster/tasks/task_007.md +0 -19
- data/.taskmaster/tasks/task_008.md +0 -19
- data/.taskmaster/tasks/task_009.md +0 -19
- data/.taskmaster/tasks/task_010.md +0 -19
- data/.taskmaster/tasks/task_011.md +0 -19
- data/.taskmaster/tasks/task_012.md +0 -19
- data/.taskmaster/tasks/task_013.md +0 -19
- data/.taskmaster/tasks/task_014.md +0 -19
- data/.taskmaster/tasks/task_015.md +0 -19
- data/.taskmaster/tasks/task_016.md +0 -19
- data/.taskmaster/tasks/task_017.md +0 -19
- data/.taskmaster/tasks/task_018.md +0 -19
- data/.taskmaster/tasks/task_019.md +0 -19
- data/.taskmaster/tasks/task_020.md +0 -19
- data/.taskmaster/tasks/tasks.json +0 -299
- data/.taskmaster/templates/example_prd.txt +0 -47
- data/.taskmaster/templates/example_prd_rpg.txt +0 -511
- data/CLAUDE.md +0 -65
- data/config/database.yml +0 -3
- data/docs/SPEC.md +0 -2012
- data/docs/UI.md +0 -32
- data/docs/blog/001-why-build-a-data-import-engine.md +0 -166
- data/docs/blog/002-scaffolding-a-rails-engine.md +0 -188
- data/docs/blog/003-configuration-dsl.md +0 -222
- data/docs/blog/004-store-model-jsonb.md +0 -237
- data/docs/blog/005-target-dsl.md +0 -284
- data/docs/blog/006-parsing-csv-sources.md +0 -300
- data/docs/blog/007-orchestrator.md +0 -247
- data/docs/blog/008-actioncable-stimulus.md +0 -376
- data/docs/blog/009-phlex-ui-components.md +0 -446
- data/docs/blog/010-controllers-routing.md +0 -374
- data/docs/blog/011-generators.md +0 -364
- data/docs/blog/012-json-api-sources.md +0 -323
- data/docs/blog/013-testing-rails-engine.md +0 -618
- data/docs/blog/014-dry-run.md +0 -307
- data/docs/blog/015-publishing-retro.md +0 -264
- data/docs/blog/016-erb-view-templates.md +0 -431
- data/docs/blog/017-showcase-final-retro.md +0 -220
- data/docs/blog/BACKLOG.md +0 -8
- data/docs/blog/SERIES.md +0 -154
- data/lib/data_porter/components/failure_alert.rb +0 -20
- data/lib/data_porter/components/preview_table.rb +0 -54
- data/lib/data_porter/components/progress_bar.rb +0 -33
- data/lib/data_porter/components/results_summary.rb +0 -19
- data/lib/data_porter/components/status_badge.rb +0 -16
- data/lib/data_porter/components/summary_cards.rb +0 -30
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
Show Task
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Show detailed task information with rich context and insights.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS
|
|
7
|
-
|
|
8
|
-
## Enhanced Task Display
|
|
9
|
-
|
|
10
|
-
Parse arguments to determine what to show and how.
|
|
11
|
-
|
|
12
|
-
### 1. **Smart Task Selection**
|
|
13
|
-
|
|
14
|
-
Based on $ARGUMENTS:
|
|
15
|
-
- Number → Show specific task with full context
|
|
16
|
-
- "current" → Show active in-progress task(s)
|
|
17
|
-
- "next" → Show recommended next task
|
|
18
|
-
- "blocked" → Show all blocked tasks with reasons
|
|
19
|
-
- "critical" → Show critical path tasks
|
|
20
|
-
- Multiple IDs → Comparative view
|
|
21
|
-
|
|
22
|
-
### 2. **Contextual Information**
|
|
23
|
-
|
|
24
|
-
For each task, intelligently include:
|
|
25
|
-
|
|
26
|
-
**Core Details**
|
|
27
|
-
- Full task information (id, title, description, details)
|
|
28
|
-
- Current status with history
|
|
29
|
-
- Test strategy and acceptance criteria
|
|
30
|
-
- Priority and complexity analysis
|
|
31
|
-
|
|
32
|
-
**Relationships**
|
|
33
|
-
- Dependencies (what it needs)
|
|
34
|
-
- Dependents (what needs it)
|
|
35
|
-
- Parent/subtask hierarchy
|
|
36
|
-
- Related tasks (similar work)
|
|
37
|
-
|
|
38
|
-
**Time Intelligence**
|
|
39
|
-
- Created/updated timestamps
|
|
40
|
-
- Time in current status
|
|
41
|
-
- Estimated vs actual time
|
|
42
|
-
- Historical completion patterns
|
|
43
|
-
|
|
44
|
-
### 3. **Visual Enhancements**
|
|
45
|
-
|
|
46
|
-
```
|
|
47
|
-
📋 Task #45: Implement User Authentication
|
|
48
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
49
|
-
Status: 🟡 in-progress (2 hours)
|
|
50
|
-
Priority: 🔴 High | Complexity: 73/100
|
|
51
|
-
|
|
52
|
-
Dependencies: ✅ #41, ✅ #42, ⏳ #43 (blocked)
|
|
53
|
-
Blocks: #46, #47, #52
|
|
54
|
-
|
|
55
|
-
Progress: ████████░░ 80% complete
|
|
56
|
-
|
|
57
|
-
Recent Activity:
|
|
58
|
-
- 2h ago: Status changed to in-progress
|
|
59
|
-
- 4h ago: Dependency #42 completed
|
|
60
|
-
- Yesterday: Task expanded with 3 subtasks
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
### 4. **Intelligent Insights**
|
|
64
|
-
|
|
65
|
-
Based on task analysis:
|
|
66
|
-
- **Risk Assessment**: Complexity vs time remaining
|
|
67
|
-
- **Bottleneck Analysis**: Is this blocking critical work?
|
|
68
|
-
- **Recommendation**: Suggested approach or concerns
|
|
69
|
-
- **Similar Tasks**: How others completed similar work
|
|
70
|
-
|
|
71
|
-
### 5. **Action Suggestions**
|
|
72
|
-
|
|
73
|
-
Context-aware next steps:
|
|
74
|
-
- If blocked → Show how to unblock
|
|
75
|
-
- If complex → Suggest expansion
|
|
76
|
-
- If in-progress → Show completion checklist
|
|
77
|
-
- If done → Show dependent tasks ready to start
|
|
78
|
-
|
|
79
|
-
### 6. **Multi-Task View**
|
|
80
|
-
|
|
81
|
-
When showing multiple tasks:
|
|
82
|
-
- Common dependencies
|
|
83
|
-
- Optimal completion order
|
|
84
|
-
- Parallel work opportunities
|
|
85
|
-
- Combined complexity analysis
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
Smart Workflow
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Execute an intelligent workflow based on current project state and recent commands.
|
|
5
|
-
|
|
6
|
-
This command analyzes:
|
|
7
|
-
1. Recent commands you've run
|
|
8
|
-
2. Current project state
|
|
9
|
-
3. Time of day / day of week
|
|
10
|
-
4. Your working patterns
|
|
11
|
-
|
|
12
|
-
Arguments: $ARGUMENTS
|
|
13
|
-
|
|
14
|
-
## Intelligent Workflow Selection
|
|
15
|
-
|
|
16
|
-
Based on context, I'll determine the best workflow:
|
|
17
|
-
|
|
18
|
-
### Context Analysis
|
|
19
|
-
- Previous command executed
|
|
20
|
-
- Current task states
|
|
21
|
-
- Unfinished work from last session
|
|
22
|
-
- Your typical patterns
|
|
23
|
-
|
|
24
|
-
### Smart Execution
|
|
25
|
-
|
|
26
|
-
If last command was:
|
|
27
|
-
- `status` → Likely starting work → Run daily standup
|
|
28
|
-
- `complete` → Task finished → Find next task
|
|
29
|
-
- `list pending` → Planning → Suggest sprint planning
|
|
30
|
-
- `expand` → Breaking down work → Show complexity analysis
|
|
31
|
-
- `init` → New project → Show onboarding workflow
|
|
32
|
-
|
|
33
|
-
If no recent commands:
|
|
34
|
-
- Morning? → Daily standup workflow
|
|
35
|
-
- Many pending tasks? → Sprint planning
|
|
36
|
-
- Tasks blocked? → Dependency resolution
|
|
37
|
-
- Friday? → Weekly review
|
|
38
|
-
|
|
39
|
-
### Workflow Composition
|
|
40
|
-
|
|
41
|
-
I'll chain appropriate commands:
|
|
42
|
-
1. Analyze current state
|
|
43
|
-
2. Execute primary workflow
|
|
44
|
-
3. Suggest follow-up actions
|
|
45
|
-
4. Prepare environment for coding
|
|
46
|
-
|
|
47
|
-
### Learning Mode
|
|
48
|
-
|
|
49
|
-
This command learns from your patterns:
|
|
50
|
-
- Track command sequences
|
|
51
|
-
- Note time preferences
|
|
52
|
-
- Remember common workflows
|
|
53
|
-
- Adapt to your style
|
|
54
|
-
|
|
55
|
-
Example flows detected:
|
|
56
|
-
- Morning: standup → next → start
|
|
57
|
-
- After lunch: status → continue task
|
|
58
|
-
- End of day: complete → commit → status
|
|
@@ -1,120 +0,0 @@
|
|
|
1
|
-
Sync README
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Export tasks to README.md with professional formatting.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS
|
|
7
|
-
|
|
8
|
-
Generate a well-formatted README with current task information.
|
|
9
|
-
|
|
10
|
-
## README Synchronization
|
|
11
|
-
|
|
12
|
-
Creates or updates README.md with beautifully formatted task information.
|
|
13
|
-
|
|
14
|
-
## Argument Parsing
|
|
15
|
-
|
|
16
|
-
Optional filters:
|
|
17
|
-
- "pending" → Only pending tasks
|
|
18
|
-
- "with-subtasks" → Include subtask details
|
|
19
|
-
- "by-priority" → Group by priority
|
|
20
|
-
- "sprint" → Current sprint only
|
|
21
|
-
|
|
22
|
-
## Execution
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
task-master sync-readme [--with-subtasks] [--status=<status>]
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
## README Generation
|
|
29
|
-
|
|
30
|
-
### 1. **Project Header**
|
|
31
|
-
```markdown
|
|
32
|
-
# Project Name
|
|
33
|
-
|
|
34
|
-
## 📋 Task Progress
|
|
35
|
-
|
|
36
|
-
Last Updated: 2024-01-15 10:30 AM
|
|
37
|
-
|
|
38
|
-
### Summary
|
|
39
|
-
- Total Tasks: 45
|
|
40
|
-
- Completed: 15 (33%)
|
|
41
|
-
- In Progress: 5 (11%)
|
|
42
|
-
- Pending: 25 (56%)
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### 2. **Task Sections**
|
|
46
|
-
Organized by status or priority:
|
|
47
|
-
- Progress indicators
|
|
48
|
-
- Task descriptions
|
|
49
|
-
- Dependencies noted
|
|
50
|
-
- Time estimates
|
|
51
|
-
|
|
52
|
-
### 3. **Visual Elements**
|
|
53
|
-
- Progress bars
|
|
54
|
-
- Status badges
|
|
55
|
-
- Priority indicators
|
|
56
|
-
- Completion checkmarks
|
|
57
|
-
|
|
58
|
-
## Smart Features
|
|
59
|
-
|
|
60
|
-
1. **Intelligent Grouping**
|
|
61
|
-
- By feature area
|
|
62
|
-
- By sprint/milestone
|
|
63
|
-
- By assigned developer
|
|
64
|
-
- By priority
|
|
65
|
-
|
|
66
|
-
2. **Progress Tracking**
|
|
67
|
-
- Overall completion
|
|
68
|
-
- Sprint velocity
|
|
69
|
-
- Burndown indication
|
|
70
|
-
- Time tracking
|
|
71
|
-
|
|
72
|
-
3. **Formatting Options**
|
|
73
|
-
- GitHub-flavored markdown
|
|
74
|
-
- Task checkboxes
|
|
75
|
-
- Collapsible sections
|
|
76
|
-
- Table format available
|
|
77
|
-
|
|
78
|
-
## Example Output
|
|
79
|
-
|
|
80
|
-
```markdown
|
|
81
|
-
## 🚀 Current Sprint
|
|
82
|
-
|
|
83
|
-
### In Progress
|
|
84
|
-
- [ ] 🔄 #5 **Implement user authentication** (60% complete)
|
|
85
|
-
- Dependencies: API design (#3 ✅)
|
|
86
|
-
- Subtasks: 4 (2 completed)
|
|
87
|
-
- Est: 8h / Spent: 5h
|
|
88
|
-
|
|
89
|
-
### Pending (High Priority)
|
|
90
|
-
- [ ] ⚡ #8 **Create dashboard UI**
|
|
91
|
-
- Blocked by: #5
|
|
92
|
-
- Complexity: High
|
|
93
|
-
- Est: 12h
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
## Customization
|
|
97
|
-
|
|
98
|
-
Based on arguments:
|
|
99
|
-
- Include/exclude sections
|
|
100
|
-
- Detail level control
|
|
101
|
-
- Custom grouping
|
|
102
|
-
- Filter by criteria
|
|
103
|
-
|
|
104
|
-
## Post-Sync
|
|
105
|
-
|
|
106
|
-
After generation:
|
|
107
|
-
1. Show diff preview
|
|
108
|
-
2. Backup existing README
|
|
109
|
-
3. Write new content
|
|
110
|
-
4. Commit reminder
|
|
111
|
-
5. Update timestamp
|
|
112
|
-
|
|
113
|
-
## Integration
|
|
114
|
-
|
|
115
|
-
Works well with:
|
|
116
|
-
- Git workflows
|
|
117
|
-
- CI/CD pipelines
|
|
118
|
-
- Project documentation
|
|
119
|
-
- Team updates
|
|
120
|
-
- Client reports
|
|
@@ -1,147 +0,0 @@
|
|
|
1
|
-
Task Master Main
|
|
2
|
-
# Task Master Command Reference
|
|
3
|
-
|
|
4
|
-
Comprehensive command structure for Task Master integration with Claude Code.
|
|
5
|
-
|
|
6
|
-
## Command Organization
|
|
7
|
-
|
|
8
|
-
Commands are organized hierarchically to match Task Master's CLI structure while providing enhanced Claude Code integration.
|
|
9
|
-
|
|
10
|
-
## Project Setup & Configuration
|
|
11
|
-
|
|
12
|
-
### `/taskmaster:init`
|
|
13
|
-
- `init-project` - Initialize new project (handles PRD files intelligently)
|
|
14
|
-
- `init-project-quick` - Quick setup with auto-confirmation (-y flag)
|
|
15
|
-
|
|
16
|
-
### `/taskmaster:models`
|
|
17
|
-
- `view-models` - View current AI model configuration
|
|
18
|
-
- `setup-models` - Interactive model configuration
|
|
19
|
-
- `set-main` - Set primary generation model
|
|
20
|
-
- `set-research` - Set research model
|
|
21
|
-
- `set-fallback` - Set fallback model
|
|
22
|
-
|
|
23
|
-
## Task Generation
|
|
24
|
-
|
|
25
|
-
### `/taskmaster:parse-prd`
|
|
26
|
-
- `parse-prd` - Generate tasks from PRD document
|
|
27
|
-
- `parse-prd-with-research` - Enhanced parsing with research mode
|
|
28
|
-
|
|
29
|
-
### `/taskmaster:generate`
|
|
30
|
-
- `generate-tasks` - Create individual task files from tasks.json
|
|
31
|
-
|
|
32
|
-
## Task Management
|
|
33
|
-
|
|
34
|
-
### `/taskmaster:list`
|
|
35
|
-
- `list-tasks` - Smart listing with natural language filters
|
|
36
|
-
- `list-tasks-with-subtasks` - Include subtasks in hierarchical view
|
|
37
|
-
- `list-tasks-by-status` - Filter by specific status
|
|
38
|
-
|
|
39
|
-
### `/taskmaster:set-status`
|
|
40
|
-
- `to-pending` - Reset task to pending
|
|
41
|
-
- `to-in-progress` - Start working on task
|
|
42
|
-
- `to-done` - Mark task complete
|
|
43
|
-
- `to-review` - Submit for review
|
|
44
|
-
- `to-deferred` - Defer task
|
|
45
|
-
- `to-cancelled` - Cancel task
|
|
46
|
-
|
|
47
|
-
### `/taskmaster:sync-readme`
|
|
48
|
-
- `sync-readme` - Export tasks to README.md with formatting
|
|
49
|
-
|
|
50
|
-
### `/taskmaster:update`
|
|
51
|
-
- `update-task` - Update tasks with natural language
|
|
52
|
-
- `update-tasks-from-id` - Update multiple tasks from a starting point
|
|
53
|
-
- `update-single-task` - Update specific task
|
|
54
|
-
|
|
55
|
-
### `/taskmaster:add-task`
|
|
56
|
-
- `add-task` - Add new task with AI assistance
|
|
57
|
-
|
|
58
|
-
### `/taskmaster:remove-task`
|
|
59
|
-
- `remove-task` - Remove task with confirmation
|
|
60
|
-
|
|
61
|
-
## Subtask Management
|
|
62
|
-
|
|
63
|
-
### `/taskmaster:add-subtask`
|
|
64
|
-
- `add-subtask` - Add new subtask to parent
|
|
65
|
-
- `convert-task-to-subtask` - Convert existing task to subtask
|
|
66
|
-
|
|
67
|
-
### `/taskmaster:remove-subtask`
|
|
68
|
-
- `remove-subtask` - Remove subtask (with optional conversion)
|
|
69
|
-
|
|
70
|
-
### `/taskmaster:clear-subtasks`
|
|
71
|
-
- `clear-subtasks` - Clear subtasks from specific task
|
|
72
|
-
- `clear-all-subtasks` - Clear all subtasks globally
|
|
73
|
-
|
|
74
|
-
## Task Analysis & Breakdown
|
|
75
|
-
|
|
76
|
-
### `/taskmaster:analyze-complexity`
|
|
77
|
-
- `analyze-complexity` - Analyze and generate expansion recommendations
|
|
78
|
-
|
|
79
|
-
### `/taskmaster:complexity-report`
|
|
80
|
-
- `complexity-report` - Display complexity analysis report
|
|
81
|
-
|
|
82
|
-
### `/taskmaster:expand`
|
|
83
|
-
- `expand-task` - Break down specific task
|
|
84
|
-
- `expand-all-tasks` - Expand all eligible tasks
|
|
85
|
-
- `with-research` - Enhanced expansion
|
|
86
|
-
|
|
87
|
-
## Task Navigation
|
|
88
|
-
|
|
89
|
-
### `/taskmaster:next`
|
|
90
|
-
- `next-task` - Intelligent next task recommendation
|
|
91
|
-
|
|
92
|
-
### `/taskmaster:show`
|
|
93
|
-
- `show-task` - Display detailed task information
|
|
94
|
-
|
|
95
|
-
### `/taskmaster:status`
|
|
96
|
-
- `project-status` - Comprehensive project dashboard
|
|
97
|
-
|
|
98
|
-
## Dependency Management
|
|
99
|
-
|
|
100
|
-
### `/taskmaster:add-dependency`
|
|
101
|
-
- `add-dependency` - Add task dependency
|
|
102
|
-
|
|
103
|
-
### `/taskmaster:remove-dependency`
|
|
104
|
-
- `remove-dependency` - Remove task dependency
|
|
105
|
-
|
|
106
|
-
### `/taskmaster:validate-dependencies`
|
|
107
|
-
- `validate-dependencies` - Check for dependency issues
|
|
108
|
-
|
|
109
|
-
### `/taskmaster:fix-dependencies`
|
|
110
|
-
- `fix-dependencies` - Automatically fix dependency problems
|
|
111
|
-
|
|
112
|
-
## Workflows & Automation
|
|
113
|
-
|
|
114
|
-
### `/taskmaster:workflows`
|
|
115
|
-
- `smart-workflow` - Context-aware intelligent workflow execution
|
|
116
|
-
- `command-pipeline` - Chain multiple commands together
|
|
117
|
-
- `auto-implement-tasks` - Advanced auto-implementation with code generation
|
|
118
|
-
|
|
119
|
-
## Utilities
|
|
120
|
-
|
|
121
|
-
### `/taskmaster:utils`
|
|
122
|
-
- `analyze-project` - Deep project analysis and insights
|
|
123
|
-
|
|
124
|
-
### `/taskmaster:setup`
|
|
125
|
-
- `install-taskmaster` - Comprehensive installation guide
|
|
126
|
-
- `quick-install-taskmaster` - One-line global installation
|
|
127
|
-
|
|
128
|
-
## Usage Patterns
|
|
129
|
-
|
|
130
|
-
### Natural Language
|
|
131
|
-
Most commands accept natural language arguments:
|
|
132
|
-
```
|
|
133
|
-
/taskmaster:add-task create user authentication system
|
|
134
|
-
/taskmaster:update mark all API tasks as high priority
|
|
135
|
-
/taskmaster:list show blocked tasks
|
|
136
|
-
```
|
|
137
|
-
|
|
138
|
-
### ID-Based Commands
|
|
139
|
-
Commands requiring IDs intelligently parse from $ARGUMENTS:
|
|
140
|
-
```
|
|
141
|
-
/taskmaster:show 45
|
|
142
|
-
/taskmaster:expand 23
|
|
143
|
-
/taskmaster:set-status/to-done 67
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
### Smart Defaults
|
|
147
|
-
Commands provide intelligent defaults and suggestions based on context.
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
To Cancelled
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Cancel a task permanently.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS (task ID)
|
|
7
|
-
|
|
8
|
-
## Cancelling a Task
|
|
9
|
-
|
|
10
|
-
This status indicates a task is no longer needed and won't be completed.
|
|
11
|
-
|
|
12
|
-
## Valid Reasons for Cancellation
|
|
13
|
-
|
|
14
|
-
- Requirements changed
|
|
15
|
-
- Feature deprecated
|
|
16
|
-
- Duplicate of another task
|
|
17
|
-
- Strategic pivot
|
|
18
|
-
- Technical approach invalidated
|
|
19
|
-
|
|
20
|
-
## Pre-Cancellation Checks
|
|
21
|
-
|
|
22
|
-
1. Confirm no critical dependencies
|
|
23
|
-
2. Check for partial implementation
|
|
24
|
-
3. Verify cancellation rationale
|
|
25
|
-
4. Document lessons learned
|
|
26
|
-
|
|
27
|
-
## Execution
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
task-master set-status --id=$ARGUMENTS --status=cancelled
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## Cancellation Impact
|
|
34
|
-
|
|
35
|
-
When cancelling:
|
|
36
|
-
1. **Dependency Updates**
|
|
37
|
-
- Notify dependent tasks
|
|
38
|
-
- Update project scope
|
|
39
|
-
- Recalculate timelines
|
|
40
|
-
|
|
41
|
-
2. **Clean-up Actions**
|
|
42
|
-
- Remove related branches
|
|
43
|
-
- Archive any work done
|
|
44
|
-
- Update documentation
|
|
45
|
-
- Close related issues
|
|
46
|
-
|
|
47
|
-
3. **Learning Capture**
|
|
48
|
-
- Document why cancelled
|
|
49
|
-
- Note what was learned
|
|
50
|
-
- Update estimation models
|
|
51
|
-
- Prevent future duplicates
|
|
52
|
-
|
|
53
|
-
## Historical Preservation
|
|
54
|
-
|
|
55
|
-
- Keep for reference
|
|
56
|
-
- Tag with cancellation reason
|
|
57
|
-
- Link to replacement if any
|
|
58
|
-
- Maintain audit trail
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
To Deferred
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Defer a task for later consideration.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS (task ID)
|
|
7
|
-
|
|
8
|
-
## Deferring a Task
|
|
9
|
-
|
|
10
|
-
This status indicates a task is valid but not currently actionable or prioritized.
|
|
11
|
-
|
|
12
|
-
## Valid Reasons for Deferral
|
|
13
|
-
|
|
14
|
-
- Waiting for external dependencies
|
|
15
|
-
- Reprioritized for future sprint
|
|
16
|
-
- Blocked by technical limitations
|
|
17
|
-
- Resource constraints
|
|
18
|
-
- Strategic timing considerations
|
|
19
|
-
|
|
20
|
-
## Execution
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
task-master set-status --id=$ARGUMENTS --status=deferred
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Deferral Management
|
|
27
|
-
|
|
28
|
-
When deferring:
|
|
29
|
-
1. **Document Reason**
|
|
30
|
-
- Capture why it's being deferred
|
|
31
|
-
- Set reactivation criteria
|
|
32
|
-
- Note any partial work completed
|
|
33
|
-
|
|
34
|
-
2. **Impact Analysis**
|
|
35
|
-
- Check dependent tasks
|
|
36
|
-
- Update project timeline
|
|
37
|
-
- Notify affected stakeholders
|
|
38
|
-
|
|
39
|
-
3. **Future Planning**
|
|
40
|
-
- Set review reminders
|
|
41
|
-
- Tag for specific milestone
|
|
42
|
-
- Preserve context for reactivation
|
|
43
|
-
- Link to blocking issues
|
|
44
|
-
|
|
45
|
-
## Smart Tracking
|
|
46
|
-
|
|
47
|
-
- Monitor deferral duration
|
|
48
|
-
- Alert when criteria met
|
|
49
|
-
- Prevent scope creep
|
|
50
|
-
- Regular review cycles
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
To Done
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Mark a task as completed.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS (task ID)
|
|
7
|
-
|
|
8
|
-
## Completing a Task
|
|
9
|
-
|
|
10
|
-
This command validates task completion and updates project state intelligently.
|
|
11
|
-
|
|
12
|
-
## Pre-Completion Checks
|
|
13
|
-
|
|
14
|
-
1. Verify test strategy was followed
|
|
15
|
-
2. Check if all subtasks are complete
|
|
16
|
-
3. Validate acceptance criteria met
|
|
17
|
-
4. Ensure code is committed
|
|
18
|
-
|
|
19
|
-
## Execution
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
task-master set-status --id=$ARGUMENTS --status=done
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Post-Completion Actions
|
|
26
|
-
|
|
27
|
-
1. **Update Dependencies**
|
|
28
|
-
- Identify newly unblocked tasks
|
|
29
|
-
- Update sprint progress
|
|
30
|
-
- Recalculate project timeline
|
|
31
|
-
|
|
32
|
-
2. **Documentation**
|
|
33
|
-
- Generate completion summary
|
|
34
|
-
- Update CLAUDE.md with learnings
|
|
35
|
-
- Log implementation approach
|
|
36
|
-
|
|
37
|
-
3. **Next Steps**
|
|
38
|
-
- Show newly available tasks
|
|
39
|
-
- Suggest logical next task
|
|
40
|
-
- Update velocity metrics
|
|
41
|
-
|
|
42
|
-
## Celebration & Learning
|
|
43
|
-
|
|
44
|
-
- Show impact of completion
|
|
45
|
-
- Display unblocked work
|
|
46
|
-
- Recognize achievement
|
|
47
|
-
- Capture lessons learned
|
|
@@ -1,39 +0,0 @@
|
|
|
1
|
-
To In Progress
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Start working on a task by setting its status to in-progress.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS (task ID)
|
|
7
|
-
|
|
8
|
-
## Starting Work on Task
|
|
9
|
-
|
|
10
|
-
This command does more than just change status - it prepares your environment for productive work.
|
|
11
|
-
|
|
12
|
-
## Pre-Start Checks
|
|
13
|
-
|
|
14
|
-
1. Verify dependencies are met
|
|
15
|
-
2. Check if another task is already in-progress
|
|
16
|
-
3. Ensure task details are complete
|
|
17
|
-
4. Validate test strategy exists
|
|
18
|
-
|
|
19
|
-
## Execution
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
task-master set-status --id=$ARGUMENTS --status=in-progress
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Environment Setup
|
|
26
|
-
|
|
27
|
-
After setting to in-progress:
|
|
28
|
-
1. Create/checkout appropriate git branch
|
|
29
|
-
2. Open relevant documentation
|
|
30
|
-
3. Set up test watchers if applicable
|
|
31
|
-
4. Display task details and acceptance criteria
|
|
32
|
-
5. Show similar completed tasks for reference
|
|
33
|
-
|
|
34
|
-
## Smart Suggestions
|
|
35
|
-
|
|
36
|
-
- Estimated completion time based on complexity
|
|
37
|
-
- Related files from similar tasks
|
|
38
|
-
- Potential blockers to watch for
|
|
39
|
-
- Recommended first steps
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
To Pending
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Set a task's status to pending.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS (task ID)
|
|
7
|
-
|
|
8
|
-
## Setting Task to Pending
|
|
9
|
-
|
|
10
|
-
This moves a task back to the pending state, useful for:
|
|
11
|
-
- Resetting erroneously started tasks
|
|
12
|
-
- Deferring work that was prematurely begun
|
|
13
|
-
- Reorganizing sprint priorities
|
|
14
|
-
|
|
15
|
-
## Execution
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
task-master set-status --id=$ARGUMENTS --status=pending
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
## Validation
|
|
22
|
-
|
|
23
|
-
Before setting to pending:
|
|
24
|
-
- Warn if task is currently in-progress
|
|
25
|
-
- Check if this will block other tasks
|
|
26
|
-
- Suggest documenting why it's being reset
|
|
27
|
-
- Preserve any work already done
|
|
28
|
-
|
|
29
|
-
## Smart Actions
|
|
30
|
-
|
|
31
|
-
After setting to pending:
|
|
32
|
-
- Update sprint planning if needed
|
|
33
|
-
- Notify about freed resources
|
|
34
|
-
- Suggest priority reassessment
|
|
35
|
-
- Log the status change with context
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
To Review
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Set a task's status to review.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS (task ID)
|
|
7
|
-
|
|
8
|
-
## Marking Task for Review
|
|
9
|
-
|
|
10
|
-
This status indicates work is complete but needs verification before final approval.
|
|
11
|
-
|
|
12
|
-
## When to Use Review Status
|
|
13
|
-
|
|
14
|
-
- Code complete but needs peer review
|
|
15
|
-
- Implementation done but needs testing
|
|
16
|
-
- Documentation written but needs proofreading
|
|
17
|
-
- Design complete but needs stakeholder approval
|
|
18
|
-
|
|
19
|
-
## Execution
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
task-master set-status --id=$ARGUMENTS --status=review
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Review Preparation
|
|
26
|
-
|
|
27
|
-
When setting to review:
|
|
28
|
-
1. **Generate Review Checklist**
|
|
29
|
-
- Link to PR/MR if applicable
|
|
30
|
-
- Highlight key changes
|
|
31
|
-
- Note areas needing attention
|
|
32
|
-
- Include test results
|
|
33
|
-
|
|
34
|
-
2. **Documentation**
|
|
35
|
-
- Update task with review notes
|
|
36
|
-
- Link relevant artifacts
|
|
37
|
-
- Specify reviewers if known
|
|
38
|
-
|
|
39
|
-
3. **Smart Actions**
|
|
40
|
-
- Create review reminders
|
|
41
|
-
- Track review duration
|
|
42
|
-
- Suggest reviewers based on expertise
|
|
43
|
-
- Prepare rollback plan if needed
|