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,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
@@ -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.