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,82 +0,0 @@
|
|
|
1
|
-
Fix Dependencies
|
|
2
|
-
Automatically fix dependency issues found during validation.
|
|
3
|
-
|
|
4
|
-
## Automatic Dependency Repair
|
|
5
|
-
|
|
6
|
-
Intelligently fixes common dependency problems while preserving project logic.
|
|
7
|
-
|
|
8
|
-
## Execution
|
|
9
|
-
|
|
10
|
-
```bash
|
|
11
|
-
task-master fix-dependencies
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
## What Gets Fixed
|
|
15
|
-
|
|
16
|
-
### 1. **Auto-Fixable Issues**
|
|
17
|
-
- Remove references to deleted tasks
|
|
18
|
-
- Break simple circular dependencies
|
|
19
|
-
- Remove self-dependencies
|
|
20
|
-
- Clean up duplicate dependencies
|
|
21
|
-
|
|
22
|
-
### 2. **Smart Resolutions**
|
|
23
|
-
- Reorder dependencies to maintain logic
|
|
24
|
-
- Suggest task merging for over-dependent tasks
|
|
25
|
-
- Flatten unnecessary dependency chains
|
|
26
|
-
- Remove redundant transitive dependencies
|
|
27
|
-
|
|
28
|
-
### 3. **Manual Review Required**
|
|
29
|
-
- Complex circular dependencies
|
|
30
|
-
- Critical path modifications
|
|
31
|
-
- Business logic dependencies
|
|
32
|
-
- High-impact changes
|
|
33
|
-
|
|
34
|
-
## Fix Process
|
|
35
|
-
|
|
36
|
-
1. **Analysis Phase**
|
|
37
|
-
- Run validation check
|
|
38
|
-
- Categorize issues by type
|
|
39
|
-
- Determine fix strategy
|
|
40
|
-
|
|
41
|
-
2. **Execution Phase**
|
|
42
|
-
- Apply automatic fixes
|
|
43
|
-
- Log all changes made
|
|
44
|
-
- Preserve task relationships
|
|
45
|
-
|
|
46
|
-
3. **Verification Phase**
|
|
47
|
-
- Re-validate after fixes
|
|
48
|
-
- Show before/after comparison
|
|
49
|
-
- Highlight manual fixes needed
|
|
50
|
-
|
|
51
|
-
## Smart Features
|
|
52
|
-
|
|
53
|
-
- Preserves intended task flow
|
|
54
|
-
- Minimal disruption approach
|
|
55
|
-
- Creates fix history/log
|
|
56
|
-
- Suggests manual interventions
|
|
57
|
-
|
|
58
|
-
## Output Example
|
|
59
|
-
|
|
60
|
-
```
|
|
61
|
-
Dependency Auto-Fix Report
|
|
62
|
-
━━━━━━━━━━━━━━━━━━━━━━━━
|
|
63
|
-
Fixed Automatically:
|
|
64
|
-
✅ Removed 2 references to deleted tasks
|
|
65
|
-
✅ Resolved 1 self-dependency
|
|
66
|
-
✅ Cleaned 3 redundant dependencies
|
|
67
|
-
|
|
68
|
-
Manual Review Needed:
|
|
69
|
-
⚠️ Complex circular dependency: #12 → #15 → #18 → #12
|
|
70
|
-
Suggestion: Make #15 not depend on #12
|
|
71
|
-
⚠️ Task #45 has 8 dependencies
|
|
72
|
-
Suggestion: Break into subtasks
|
|
73
|
-
|
|
74
|
-
Run '/taskmaster:validate-dependencies' to verify fixes
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## Safety
|
|
78
|
-
|
|
79
|
-
- Preview mode available
|
|
80
|
-
- Rollback capability
|
|
81
|
-
- Change logging
|
|
82
|
-
- No data loss
|
data/.claude/commands/tm/help.md
DELETED
|
@@ -1,101 +0,0 @@
|
|
|
1
|
-
Help
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Show help for Task Master AI commands.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS
|
|
7
|
-
|
|
8
|
-
Display help for Task Master commands and available options.
|
|
9
|
-
|
|
10
|
-
## Task Master AI Command Help
|
|
11
|
-
|
|
12
|
-
### Quick Navigation
|
|
13
|
-
|
|
14
|
-
Type `/taskmaster:` and use tab completion to explore all commands.
|
|
15
|
-
|
|
16
|
-
### Command Categories
|
|
17
|
-
|
|
18
|
-
#### 🚀 Setup & Installation
|
|
19
|
-
- `/taskmaster:install-taskmaster` - Comprehensive installation guide
|
|
20
|
-
- `/taskmaster:quick-install-taskmaster` - One-line global install
|
|
21
|
-
|
|
22
|
-
#### 📋 Project Setup
|
|
23
|
-
- `/taskmaster:init-project` - Initialize new project
|
|
24
|
-
- `/taskmaster:init-project-quick` - Quick setup with auto-confirm
|
|
25
|
-
- `/taskmaster:view-models` - View AI configuration
|
|
26
|
-
- `/taskmaster:setup-models` - Configure AI providers
|
|
27
|
-
|
|
28
|
-
#### 🎯 Task Generation
|
|
29
|
-
- `/taskmaster:parse-prd` - Generate tasks from PRD
|
|
30
|
-
- `/taskmaster:parse-prd-with-research` - Enhanced parsing
|
|
31
|
-
- `/taskmaster:generate-tasks` - Create task files
|
|
32
|
-
|
|
33
|
-
#### 📝 Task Management
|
|
34
|
-
- `/taskmaster:list-tasks` - List all tasks
|
|
35
|
-
- `/taskmaster:list-tasks-by-status` - List tasks filtered by status
|
|
36
|
-
- `/taskmaster:list-tasks-with-subtasks` - List tasks with subtasks
|
|
37
|
-
- `/taskmaster:show-task` - Display task details
|
|
38
|
-
- `/taskmaster:add-task` - Create new task
|
|
39
|
-
- `/taskmaster:update-task` - Update single task
|
|
40
|
-
- `/taskmaster:update-tasks-from-id` - Update multiple tasks
|
|
41
|
-
- `/taskmaster:next-task` - Get next task recommendation
|
|
42
|
-
|
|
43
|
-
#### 🔄 Status Management
|
|
44
|
-
- `/taskmaster:to-pending` - Set task to pending
|
|
45
|
-
- `/taskmaster:to-in-progress` - Set task to in-progress
|
|
46
|
-
- `/taskmaster:to-done` - Set task to done
|
|
47
|
-
- `/taskmaster:to-review` - Set task to review
|
|
48
|
-
- `/taskmaster:to-deferred` - Set task to deferred
|
|
49
|
-
- `/taskmaster:to-cancelled` - Set task to cancelled
|
|
50
|
-
|
|
51
|
-
#### 🔍 Analysis & Breakdown
|
|
52
|
-
- `/taskmaster:analyze-complexity` - Analyze task complexity
|
|
53
|
-
- `/taskmaster:complexity-report` - View complexity report
|
|
54
|
-
- `/taskmaster:expand-task` - Break down complex task
|
|
55
|
-
- `/taskmaster:expand-all-tasks` - Expand all eligible tasks
|
|
56
|
-
|
|
57
|
-
#### 🔗 Dependencies
|
|
58
|
-
- `/taskmaster:add-dependency` - Add task dependency
|
|
59
|
-
- `/taskmaster:remove-dependency` - Remove dependency
|
|
60
|
-
- `/taskmaster:validate-dependencies` - Check for issues
|
|
61
|
-
- `/taskmaster:fix-dependencies` - Auto-fix dependency issues
|
|
62
|
-
|
|
63
|
-
#### 📦 Subtasks
|
|
64
|
-
- `/taskmaster:add-subtask` - Add subtask to task
|
|
65
|
-
- `/taskmaster:convert-task-to-subtask` - Convert task to subtask
|
|
66
|
-
- `/taskmaster:remove-subtask` - Remove subtask
|
|
67
|
-
- `/taskmaster:remove-subtasks` - Clear specific task subtasks
|
|
68
|
-
- `/taskmaster:remove-all-subtasks` - Clear all subtasks
|
|
69
|
-
|
|
70
|
-
#### 🗑️ Task Removal
|
|
71
|
-
- `/taskmaster:remove-task` - Remove task permanently
|
|
72
|
-
|
|
73
|
-
#### 🤖 Workflows
|
|
74
|
-
- `/taskmaster:smart-workflow` - Intelligent workflows
|
|
75
|
-
- `/taskmaster:command-pipeline` - Command chaining
|
|
76
|
-
- `/taskmaster:auto-implement-tasks` - Auto-implementation
|
|
77
|
-
|
|
78
|
-
#### 📊 Utilities
|
|
79
|
-
- `/taskmaster:analyze-project` - Project analysis
|
|
80
|
-
- `/taskmaster:project-status` - Project dashboard
|
|
81
|
-
- `/taskmaster:sync-readme` - Sync README with tasks
|
|
82
|
-
- `/taskmaster:learn` - Interactive learning
|
|
83
|
-
- `/taskmaster:tm-main` - Main Task Master interface
|
|
84
|
-
|
|
85
|
-
### Quick Start Examples
|
|
86
|
-
|
|
87
|
-
```
|
|
88
|
-
/taskmaster:list-tasks
|
|
89
|
-
/taskmaster:show-task 1.2
|
|
90
|
-
/taskmaster:add-task
|
|
91
|
-
/taskmaster:next-task
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
### Getting Started
|
|
95
|
-
|
|
96
|
-
1. Install: `/taskmaster:quick-install-taskmaster`
|
|
97
|
-
2. Initialize: `/taskmaster:init-project-quick`
|
|
98
|
-
3. Learn: `/taskmaster:learn`
|
|
99
|
-
4. Work: `/taskmaster:smart-workflow`
|
|
100
|
-
|
|
101
|
-
For detailed command info, run the specific command with `--help` or check command documentation.
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
Init Project Quick
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Quick initialization with auto-confirmation.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS
|
|
7
|
-
|
|
8
|
-
Initialize a Task Master project without prompts, accepting all defaults.
|
|
9
|
-
|
|
10
|
-
## Quick Setup
|
|
11
|
-
|
|
12
|
-
```bash
|
|
13
|
-
task-master init -y
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## What It Does
|
|
17
|
-
|
|
18
|
-
1. Creates `.taskmaster/` directory structure
|
|
19
|
-
2. Initializes empty `tasks.json`
|
|
20
|
-
3. Sets up default configuration
|
|
21
|
-
4. Uses directory name as project name
|
|
22
|
-
5. Skips all confirmation prompts
|
|
23
|
-
|
|
24
|
-
## Smart Defaults
|
|
25
|
-
|
|
26
|
-
- Project name: Current directory name
|
|
27
|
-
- Description: "Task Master Project"
|
|
28
|
-
- Model config: Existing environment vars
|
|
29
|
-
- Task structure: Standard format
|
|
30
|
-
|
|
31
|
-
## Next Steps
|
|
32
|
-
|
|
33
|
-
After quick init:
|
|
34
|
-
1. Configure AI models if needed:
|
|
35
|
-
```
|
|
36
|
-
/taskmaster:models/setup
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
2. Parse PRD if available:
|
|
40
|
-
```
|
|
41
|
-
/taskmaster:parse-prd <file>
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
3. Or create first task:
|
|
45
|
-
```
|
|
46
|
-
/taskmaster:add-task create initial setup
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
Perfect for rapid project setup!
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
Init Project
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Initialize a new Task Master project.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS
|
|
7
|
-
|
|
8
|
-
Parse arguments to determine initialization preferences.
|
|
9
|
-
|
|
10
|
-
## Initialization Process
|
|
11
|
-
|
|
12
|
-
1. **Parse Arguments**
|
|
13
|
-
- PRD file path (if provided)
|
|
14
|
-
- Project name
|
|
15
|
-
- Auto-confirm flag (-y)
|
|
16
|
-
|
|
17
|
-
2. **Project Setup**
|
|
18
|
-
```bash
|
|
19
|
-
task-master init
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
3. **Smart Initialization**
|
|
23
|
-
- Detect existing project files
|
|
24
|
-
- Suggest project name from directory
|
|
25
|
-
- Check for git repository
|
|
26
|
-
- Verify AI provider configuration
|
|
27
|
-
|
|
28
|
-
## Configuration Options
|
|
29
|
-
|
|
30
|
-
Based on arguments:
|
|
31
|
-
- `quick` / `-y` → Skip confirmations
|
|
32
|
-
- `<file.md>` → Use as PRD after init
|
|
33
|
-
- `--name=<name>` → Set project name
|
|
34
|
-
- `--description=<desc>` → Set description
|
|
35
|
-
|
|
36
|
-
## Post-Initialization
|
|
37
|
-
|
|
38
|
-
After successful init:
|
|
39
|
-
1. Show project structure created
|
|
40
|
-
2. Verify AI models configured
|
|
41
|
-
3. Suggest next steps:
|
|
42
|
-
- Parse PRD if available
|
|
43
|
-
- Configure AI providers
|
|
44
|
-
- Set up git hooks
|
|
45
|
-
- Create first tasks
|
|
46
|
-
|
|
47
|
-
## Integration
|
|
48
|
-
|
|
49
|
-
If PRD file provided:
|
|
50
|
-
```
|
|
51
|
-
/taskmaster:init my-prd.md
|
|
52
|
-
→ Automatically runs parse-prd after init
|
|
53
|
-
```
|
|
@@ -1,118 +0,0 @@
|
|
|
1
|
-
Install TaskMaster
|
|
2
|
-
Check if Task Master is installed and install it if needed.
|
|
3
|
-
|
|
4
|
-
This command helps you get Task Master set up globally on your system.
|
|
5
|
-
|
|
6
|
-
## Detection and Installation Process
|
|
7
|
-
|
|
8
|
-
1. **Check Current Installation**
|
|
9
|
-
```bash
|
|
10
|
-
# Check if task-master command exists
|
|
11
|
-
which task-master || echo "Task Master not found"
|
|
12
|
-
|
|
13
|
-
# Check npm global packages
|
|
14
|
-
npm list -g task-master-ai
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
2. **System Requirements Check**
|
|
18
|
-
```bash
|
|
19
|
-
# Verify Node.js is installed
|
|
20
|
-
node --version
|
|
21
|
-
|
|
22
|
-
# Verify npm is installed
|
|
23
|
-
npm --version
|
|
24
|
-
|
|
25
|
-
# Check Node version (need 16+)
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
3. **Install Task Master Globally**
|
|
29
|
-
If not installed, run:
|
|
30
|
-
```bash
|
|
31
|
-
npm install -g task-master-ai
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
4. **Verify Installation**
|
|
35
|
-
```bash
|
|
36
|
-
# Check version
|
|
37
|
-
task-master --version
|
|
38
|
-
|
|
39
|
-
# Verify command is available
|
|
40
|
-
which task-master
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
5. **Initial Setup**
|
|
44
|
-
```bash
|
|
45
|
-
# Initialize in current directory
|
|
46
|
-
task-master init
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
6. **Configure AI Provider**
|
|
50
|
-
Ensure you have at least one AI provider API key set:
|
|
51
|
-
```bash
|
|
52
|
-
# Check current configuration
|
|
53
|
-
task-master models --status
|
|
54
|
-
|
|
55
|
-
# If no API keys found, guide setup
|
|
56
|
-
echo "You'll need at least one API key:"
|
|
57
|
-
echo "- ANTHROPIC_API_KEY for Claude"
|
|
58
|
-
echo "- OPENAI_API_KEY for GPT models"
|
|
59
|
-
echo "- PERPLEXITY_API_KEY for research"
|
|
60
|
-
echo ""
|
|
61
|
-
echo "Set them in your shell profile or .env file"
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
7. **Quick Test**
|
|
65
|
-
```bash
|
|
66
|
-
# Create a test PRD
|
|
67
|
-
echo "Build a simple hello world API" > test-prd.txt
|
|
68
|
-
|
|
69
|
-
# Try parsing it
|
|
70
|
-
task-master parse-prd test-prd.txt -n 3
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
## Troubleshooting
|
|
74
|
-
|
|
75
|
-
If installation fails:
|
|
76
|
-
|
|
77
|
-
**Permission Errors:**
|
|
78
|
-
```bash
|
|
79
|
-
# Try with sudo (macOS/Linux)
|
|
80
|
-
sudo npm install -g task-master-ai
|
|
81
|
-
|
|
82
|
-
# Or fix npm permissions
|
|
83
|
-
npm config set prefix ~/.npm-global
|
|
84
|
-
export PATH=~/.npm-global/bin:$PATH
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
**Network Issues:**
|
|
88
|
-
```bash
|
|
89
|
-
# Use different registry
|
|
90
|
-
npm install -g task-master-ai --registry https://registry.npmjs.org/
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
**Node Version Issues:**
|
|
94
|
-
```bash
|
|
95
|
-
# Install Node 20+ via nvm
|
|
96
|
-
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
|
|
97
|
-
nvm install 20
|
|
98
|
-
nvm use 20
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
## Success Confirmation
|
|
102
|
-
|
|
103
|
-
Once installed, you should see:
|
|
104
|
-
```
|
|
105
|
-
✅ Task Master installed
|
|
106
|
-
✅ Command 'task-master' available globally
|
|
107
|
-
✅ AI provider configured
|
|
108
|
-
✅ Ready to use slash commands!
|
|
109
|
-
|
|
110
|
-
Try: /taskmaster:init your-prd.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
## Next Steps
|
|
114
|
-
|
|
115
|
-
After installation:
|
|
116
|
-
1. Run `/taskmaster:status` to verify setup
|
|
117
|
-
2. Configure AI providers with `/taskmaster:setup-models`
|
|
118
|
-
3. Start using Task Master commands!
|
|
@@ -1,106 +0,0 @@
|
|
|
1
|
-
Learn
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Learn about Task Master capabilities through interactive exploration.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS
|
|
7
|
-
|
|
8
|
-
## Interactive Task Master Learning
|
|
9
|
-
|
|
10
|
-
Based on your input, I'll help you discover capabilities:
|
|
11
|
-
|
|
12
|
-
### 1. **What are you trying to do?**
|
|
13
|
-
|
|
14
|
-
If $ARGUMENTS contains:
|
|
15
|
-
- "start" / "begin" → Show project initialization workflows
|
|
16
|
-
- "manage" / "organize" → Show task management commands
|
|
17
|
-
- "automate" / "auto" → Show automation workflows
|
|
18
|
-
- "analyze" / "report" → Show analysis tools
|
|
19
|
-
- "fix" / "problem" → Show troubleshooting commands
|
|
20
|
-
- "fast" / "quick" → Show efficiency shortcuts
|
|
21
|
-
|
|
22
|
-
### 2. **Intelligent Suggestions**
|
|
23
|
-
|
|
24
|
-
Based on your project state:
|
|
25
|
-
|
|
26
|
-
**No tasks yet?**
|
|
27
|
-
```
|
|
28
|
-
You'll want to start with:
|
|
29
|
-
1. /project:task-master:init <prd-file>
|
|
30
|
-
→ Creates tasks from requirements
|
|
31
|
-
|
|
32
|
-
2. /project:task-master:parse-prd <file>
|
|
33
|
-
→ Alternative task generation
|
|
34
|
-
|
|
35
|
-
Try: /project:task-master:init demo-prd.md
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
**Have tasks?**
|
|
39
|
-
Let me analyze what you might need...
|
|
40
|
-
- Many pending tasks? → Learn sprint planning
|
|
41
|
-
- Complex tasks? → Learn task expansion
|
|
42
|
-
- Daily work? → Learn workflow automation
|
|
43
|
-
|
|
44
|
-
### 3. **Command Discovery**
|
|
45
|
-
|
|
46
|
-
**By Category:**
|
|
47
|
-
- 📋 Task Management: list, show, add, update, complete
|
|
48
|
-
- 🔄 Workflows: auto-implement, sprint-plan, daily-standup
|
|
49
|
-
- 🛠️ Utilities: check-health, complexity-report, sync-memory
|
|
50
|
-
- 🔍 Analysis: validate-deps, show dependencies
|
|
51
|
-
|
|
52
|
-
**By Scenario:**
|
|
53
|
-
- "I want to see what to work on" → `/project:task-master:next`
|
|
54
|
-
- "I need to break this down" → `/project:task-master:expand <id>`
|
|
55
|
-
- "Show me everything" → `/project:task-master:status`
|
|
56
|
-
- "Just do it for me" → `/project:workflows:auto-implement`
|
|
57
|
-
|
|
58
|
-
### 4. **Power User Patterns**
|
|
59
|
-
|
|
60
|
-
**Command Chaining:**
|
|
61
|
-
```
|
|
62
|
-
/project:task-master:next
|
|
63
|
-
/project:task-master:start <id>
|
|
64
|
-
/project:workflows:auto-implement
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
**Smart Filters:**
|
|
68
|
-
```
|
|
69
|
-
/project:task-master:list pending high
|
|
70
|
-
/project:task-master:list blocked
|
|
71
|
-
/project:task-master:list 1-5 tree
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
**Automation:**
|
|
75
|
-
```
|
|
76
|
-
/project:workflows:pipeline init → expand-all → sprint-plan
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
### 5. **Learning Path**
|
|
80
|
-
|
|
81
|
-
Based on your experience level:
|
|
82
|
-
|
|
83
|
-
**Beginner Path:**
|
|
84
|
-
1. init → Create project
|
|
85
|
-
2. status → Understand state
|
|
86
|
-
3. next → Find work
|
|
87
|
-
4. complete → Finish task
|
|
88
|
-
|
|
89
|
-
**Intermediate Path:**
|
|
90
|
-
1. expand → Break down complex tasks
|
|
91
|
-
2. sprint-plan → Organize work
|
|
92
|
-
3. complexity-report → Understand difficulty
|
|
93
|
-
4. validate-deps → Ensure consistency
|
|
94
|
-
|
|
95
|
-
**Advanced Path:**
|
|
96
|
-
1. pipeline → Chain operations
|
|
97
|
-
2. smart-flow → Context-aware automation
|
|
98
|
-
3. Custom commands → Extend the system
|
|
99
|
-
|
|
100
|
-
### 6. **Try This Now**
|
|
101
|
-
|
|
102
|
-
Based on what you asked about, try:
|
|
103
|
-
[Specific command suggestion based on $ARGUMENTS]
|
|
104
|
-
|
|
105
|
-
Want to learn more about a specific command?
|
|
106
|
-
Type: /project:help <command-name>
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
List Tasks By Status
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
List tasks filtered by a specific status.
|
|
5
|
-
|
|
6
|
-
Arguments: $ARGUMENTS
|
|
7
|
-
|
|
8
|
-
Parse the status from arguments and list only tasks matching that status.
|
|
9
|
-
|
|
10
|
-
## Status Options
|
|
11
|
-
- `pending` - Not yet started
|
|
12
|
-
- `in-progress` - Currently being worked on
|
|
13
|
-
- `done` - Completed
|
|
14
|
-
- `review` - Awaiting review
|
|
15
|
-
- `deferred` - Postponed
|
|
16
|
-
- `cancelled` - Cancelled
|
|
17
|
-
|
|
18
|
-
## Execution
|
|
19
|
-
|
|
20
|
-
Based on $ARGUMENTS, run:
|
|
21
|
-
```bash
|
|
22
|
-
task-master list --status=$ARGUMENTS
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Enhanced Display
|
|
26
|
-
|
|
27
|
-
For the filtered results:
|
|
28
|
-
- Group by priority within the status
|
|
29
|
-
- Show time in current status
|
|
30
|
-
- Highlight tasks approaching deadlines
|
|
31
|
-
- Display blockers and dependencies
|
|
32
|
-
- Suggest next actions for each status group
|
|
33
|
-
|
|
34
|
-
## Intelligent Insights
|
|
35
|
-
|
|
36
|
-
Based on the status filter:
|
|
37
|
-
- **Pending**: Show recommended start order
|
|
38
|
-
- **In-Progress**: Display idle time warnings
|
|
39
|
-
- **Done**: Show newly unblocked tasks
|
|
40
|
-
- **Review**: Indicate review duration
|
|
41
|
-
- **Deferred**: Show reactivation criteria
|
|
42
|
-
- **Cancelled**: Display impact analysis
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
List Tasks With Subtasks
|
|
2
|
-
List all tasks including their subtasks in a hierarchical view.
|
|
3
|
-
|
|
4
|
-
This command shows all tasks with their nested subtasks, providing a complete project overview.
|
|
5
|
-
|
|
6
|
-
## Execution
|
|
7
|
-
|
|
8
|
-
Run the Task Master list command with subtasks flag:
|
|
9
|
-
```bash
|
|
10
|
-
task-master list --with-subtasks
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## Enhanced Display
|
|
14
|
-
|
|
15
|
-
I'll organize the output to show:
|
|
16
|
-
- Parent tasks with clear indicators
|
|
17
|
-
- Nested subtasks with proper indentation
|
|
18
|
-
- Status badges for quick scanning
|
|
19
|
-
- Dependencies and blockers highlighted
|
|
20
|
-
- Progress indicators for tasks with subtasks
|
|
21
|
-
|
|
22
|
-
## Smart Filtering
|
|
23
|
-
|
|
24
|
-
Based on the task hierarchy:
|
|
25
|
-
- Show completion percentage for parent tasks
|
|
26
|
-
- Highlight blocked subtask chains
|
|
27
|
-
- Group by functional areas
|
|
28
|
-
- Indicate critical path items
|
|
29
|
-
|
|
30
|
-
This gives you a complete tree view of your project structure.
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
List Tasks
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
List tasks with intelligent argument parsing.
|
|
5
|
-
|
|
6
|
-
Parse arguments to determine filters and display options:
|
|
7
|
-
- Status: pending, in-progress, done, review, deferred, cancelled
|
|
8
|
-
- Priority: high, medium, low (or priority:high)
|
|
9
|
-
- Special: subtasks, tree, dependencies, blocked
|
|
10
|
-
- IDs: Direct numbers (e.g., "1,3,5" or "1-5")
|
|
11
|
-
- Complex: "pending high" = pending AND high priority
|
|
12
|
-
|
|
13
|
-
Arguments: $ARGUMENTS
|
|
14
|
-
|
|
15
|
-
Let me parse your request intelligently:
|
|
16
|
-
|
|
17
|
-
1. **Detect Filter Intent**
|
|
18
|
-
- If arguments contain status keywords → filter by status
|
|
19
|
-
- If arguments contain priority → filter by priority
|
|
20
|
-
- If arguments contain "subtasks" → include subtasks
|
|
21
|
-
- If arguments contain "tree" → hierarchical view
|
|
22
|
-
- If arguments contain numbers → show specific tasks
|
|
23
|
-
- If arguments contain "blocked" → show blocked tasks only
|
|
24
|
-
|
|
25
|
-
2. **Smart Combinations**
|
|
26
|
-
Examples of what I understand:
|
|
27
|
-
- "pending high" → pending tasks with high priority
|
|
28
|
-
- "done today" → tasks completed today
|
|
29
|
-
- "blocked" → tasks with unmet dependencies
|
|
30
|
-
- "1-5" → tasks 1 through 5
|
|
31
|
-
- "subtasks tree" → hierarchical view with subtasks
|
|
32
|
-
|
|
33
|
-
3. **Execute Appropriate Query**
|
|
34
|
-
Based on parsed intent, run the most specific task-master command
|
|
35
|
-
|
|
36
|
-
4. **Enhanced Display**
|
|
37
|
-
- Group by relevant criteria
|
|
38
|
-
- Show most important information first
|
|
39
|
-
- Use visual indicators for quick scanning
|
|
40
|
-
- Include relevant metrics
|
|
41
|
-
|
|
42
|
-
5. **Intelligent Suggestions**
|
|
43
|
-
Based on what you're viewing, suggest next actions:
|
|
44
|
-
- Many pending? → Suggest priority order
|
|
45
|
-
- Many blocked? → Show dependency resolution
|
|
46
|
-
- Looking at specific tasks? → Show related tasks
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
Next Task
|
|
2
|
-
|
|
3
|
-
Arguments: $ARGUMENTS
|
|
4
|
-
Intelligently determine and prepare the next action based on comprehensive context.
|
|
5
|
-
|
|
6
|
-
This enhanced version of 'next' considers:
|
|
7
|
-
- Current task states
|
|
8
|
-
- Recent activity
|
|
9
|
-
- Time constraints
|
|
10
|
-
- Dependencies
|
|
11
|
-
- Your working patterns
|
|
12
|
-
|
|
13
|
-
Arguments: $ARGUMENTS
|
|
14
|
-
|
|
15
|
-
## Intelligent Next Action
|
|
16
|
-
|
|
17
|
-
### 1. **Context Gathering**
|
|
18
|
-
Let me analyze the current situation:
|
|
19
|
-
- Active tasks (in-progress)
|
|
20
|
-
- Recently completed tasks
|
|
21
|
-
- Blocked tasks
|
|
22
|
-
- Time since last activity
|
|
23
|
-
- Arguments provided: $ARGUMENTS
|
|
24
|
-
|
|
25
|
-
### 2. **Smart Decision Tree**
|
|
26
|
-
|
|
27
|
-
**If you have an in-progress task:**
|
|
28
|
-
- Has it been idle > 2 hours? → Suggest resuming or switching
|
|
29
|
-
- Near completion? → Show remaining steps
|
|
30
|
-
- Blocked? → Find alternative task
|
|
31
|
-
|
|
32
|
-
**If no in-progress tasks:**
|
|
33
|
-
- Unblocked high-priority tasks? → Start highest
|
|
34
|
-
- Complex tasks need breakdown? → Suggest expansion
|
|
35
|
-
- All tasks blocked? → Show dependency resolution
|
|
36
|
-
|
|
37
|
-
**Special arguments handling:**
|
|
38
|
-
- "quick" → Find task < 2 hours
|
|
39
|
-
- "easy" → Find low complexity task
|
|
40
|
-
- "important" → Find high priority regardless of complexity
|
|
41
|
-
- "continue" → Resume last worked task
|
|
42
|
-
|
|
43
|
-
### 3. **Preparation Workflow**
|
|
44
|
-
|
|
45
|
-
Based on selected task:
|
|
46
|
-
1. Show full context and history
|
|
47
|
-
2. Set up development environment
|
|
48
|
-
3. Run relevant tests
|
|
49
|
-
4. Open related files
|
|
50
|
-
5. Show similar completed tasks
|
|
51
|
-
6. Estimate completion time
|
|
52
|
-
|
|
53
|
-
### 4. **Alternative Suggestions**
|
|
54
|
-
|
|
55
|
-
Always provide options:
|
|
56
|
-
- Primary recommendation
|
|
57
|
-
- Quick alternative (< 1 hour)
|
|
58
|
-
- Strategic option (unblocks most tasks)
|
|
59
|
-
- Learning option (new technology/skill)
|
|
60
|
-
|
|
61
|
-
### 5. **Workflow Integration**
|
|
62
|
-
|
|
63
|
-
Seamlessly connect to:
|
|
64
|
-
- `/project:task-master:start [selected]`
|
|
65
|
-
- `/project:workflows:auto-implement`
|
|
66
|
-
- `/project:task-master:expand` (if complex)
|
|
67
|
-
- `/project:utils:complexity-report` (if unsure)
|
|
68
|
-
|
|
69
|
-
The goal: Zero friction from decision to implementation.
|