@programinglive/dev-workflow-mcp-server 1.5.0 → 1.5.2
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.
- package/.agent/workflows/dev-workflow-bugfix.md +250 -250
- package/.agent/workflows/dev-workflow-feature.md +201 -201
- package/.agent/workflows/dev-workflow-full-cycle.md +400 -400
- package/.agent/workflows/dev-workflow-refactor.md +238 -238
- package/.github/ISSUE_TEMPLATE/bug_report.md +34 -34
- package/.github/ISSUE_TEMPLATE/feature_request.md +25 -25
- package/.github/pull_request_template.md +22 -22
- package/.github/workflows/npm-publish.yml +50 -47
- package/.husky/commit-msg +0 -0
- package/CHANGELOG.md +750 -491
- package/CODE_OF_CONDUCT.md +79 -79
- package/CONTRIBUTING.md +60 -60
- package/LICENSE +21 -21
- package/README.md +632 -609
- package/SECURITY.md +20 -20
- package/db/index.js +204 -204
- package/docs/NETLIFY_DEPLOYMENT.md +125 -0
- package/docs/PLESK_DEPLOYMENT.md +170 -0
- package/docs/WORKFLOW-BEST-PRACTICES.md +58 -0
- package/docs/antigravity/EXAMPLES.md +535 -535
- package/docs/antigravity/GETTING-STARTED.md +292 -292
- package/docs/antigravity/TROUBLESHOOTING.md +742 -742
- package/docs/antigravity/WALKTHROUGH.md +25 -25
- package/docs/antigravity/WORKFLOW-TEMPLATES.md +670 -670
- package/docs/product/PRD.md +67 -64
- package/docs/release-notes/RELEASE_NOTES.md +226 -132
- package/docs/web-dashboard.md +175 -163
- package/exec.js +49 -49
- package/index.js +279 -279
- package/install.js +73 -73
- package/package.json +11 -9
- package/release-wrapper.js +192 -157
- package/scripts/build-docs.js +63 -63
- package/scripts/hello-world.js +1 -1
- package/scripts/release.cjs +252 -252
- package/scripts/update-release-notes.cjs +178 -182
- package/server.json +23 -0
- package/tailwind.config.js +8 -10
- package/tests/build.test.js +83 -48
- package/tests/exec.test.js +35 -35
- package/tests/handlers.test.js +1058 -980
- package/tests/hello-world.test.js +13 -13
- package/tests/mcpRegistry.test.js +65 -0
- package/tests/release-wrapper.test.js +107 -105
- package/tests/workflowState.test.js +505 -502
- package/tools/definitions.js +332 -332
- package/tools/handlers.js +1019 -1019
- package/vite.config.js +43 -43
- package/vite.web.config.js +23 -0
- package/web/README.md +36 -0
- package/web/app/docs/page.tsx +202 -0
- package/web/app/favicon.ico +0 -0
- package/web/app/globals.css +91 -0
- package/web/app/layout.tsx +36 -0
- package/web/app/page.tsx +15 -0
- package/web/components/ApiReference.tsx +20 -0
- package/web/components/Features.tsx +61 -0
- package/web/components/Footer.tsx +9 -0
- package/web/components/Hero.tsx +96 -0
- package/web/components/History.tsx +143 -0
- package/web/components/Navbar.tsx +64 -0
- package/web/components/Terminal.tsx +114 -0
- package/web/eslint.config.mjs +18 -0
- package/web/lib/db.js +131 -0
- package/web/lib/docs.js +73 -0
- package/web/netlify.toml +3 -0
- package/web/next.config.ts +12 -0
- package/web/package-lock.json +6560 -0
- package/web/package.json +28 -0
- package/web/postcss.config.mjs +9 -0
- package/web/public/assets/android-chrome-192x192.png +0 -0
- package/web/public/assets/android-chrome-512x512.png +0 -0
- package/web/public/assets/apple-touch-icon.png +0 -0
- package/web/public/assets/favicon-16x16.png +0 -0
- package/web/public/assets/favicon-32x32.png +0 -0
- package/web/public/assets/favicon.ico +0 -0
- package/web/public/assets/favicon.png +0 -0
- package/web/public/assets/logo.png +0 -0
- package/web/public/assets/og-preview.png +0 -0
- package/web/public/assets/site.webmanifest +1 -0
- package/web/public/file.svg +1 -0
- package/web/public/globe.svg +1 -0
- package/web/public/next.svg +1 -0
- package/web/public/vercel.svg +1 -0
- package/web/public/window.svg +1 -0
- package/web/server.js +31 -159
- package/web/tailwind.config.ts +19 -0
- package/web/tsconfig.json +42 -0
- package/workflow-state.js +612 -626
- package/dist/docs/EXAMPLES.html +0 -411
- package/dist/docs/GETTING-STARTED.html +0 -233
- package/dist/docs/README.html +0 -535
- package/dist/docs/RELEASE_NOTES.html +0 -167
- package/dist/docs/TROUBLESHOOTING.html +0 -542
- package/dist/docs/WORKFLOW-TEMPLATES.html +0 -591
- package/dist/docs/web-dashboard.html +0 -158
- package/web/public/index.html +0 -1046
- package/web/public/input.css +0 -3
- package/web/public/output.css +0 -1
|
@@ -1,201 +1,201 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Feature development workflow using dev-workflow MCP server
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# Feature Development Workflow
|
|
6
|
-
|
|
7
|
-
This workflow guides you through developing a new feature with the dev-workflow MCP server.
|
|
8
|
-
|
|
9
|
-
## When to Use
|
|
10
|
-
|
|
11
|
-
- Adding new functionality
|
|
12
|
-
- Building new components
|
|
13
|
-
- Implementing new features
|
|
14
|
-
|
|
15
|
-
## Workflow Steps
|
|
16
|
-
|
|
17
|
-
### 1. Start the Task
|
|
18
|
-
|
|
19
|
-
Begin by defining your feature:
|
|
20
|
-
|
|
21
|
-
```
|
|
22
|
-
Use start_task tool:
|
|
23
|
-
- description: "Add [feature name] to [component/area]"
|
|
24
|
-
- type: "feature"
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
The server confirms task start and moves you to the implementation phase.
|
|
28
|
-
|
|
29
|
-
### 2. Implement the Feature
|
|
30
|
-
|
|
31
|
-
Write your code as usual. The workflow doesn't interfere with your development process.
|
|
32
|
-
|
|
33
|
-
Tips:
|
|
34
|
-
- Keep commits atomic
|
|
35
|
-
- Follow coding standards
|
|
36
|
-
- Write clean, maintainable code
|
|
37
|
-
|
|
38
|
-
### 3. Mark as Fixed
|
|
39
|
-
|
|
40
|
-
Once implementation is complete:
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
Use mark_bug_fixed tool:
|
|
44
|
-
- summary: "[Brief description of what was implemented]"
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
The server reminds you that tests are now mandatory.
|
|
48
|
-
|
|
49
|
-
### 4. Create Tests
|
|
50
|
-
|
|
51
|
-
Write comprehensive tests:
|
|
52
|
-
- Unit tests for new functions/components
|
|
53
|
-
- Integration tests for interactions
|
|
54
|
-
- End-to-end tests for user flows (if applicable)
|
|
55
|
-
|
|
56
|
-
Then mark tests as created:
|
|
57
|
-
|
|
58
|
-
```
|
|
59
|
-
Use create_tests tool
|
|
60
|
-
(no parameters needed)
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
### 5. Run Tests
|
|
64
|
-
|
|
65
|
-
// turbo
|
|
66
|
-
Execute your test suite:
|
|
67
|
-
|
|
68
|
-
```bash
|
|
69
|
-
npm test
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
Record the results:
|
|
73
|
-
|
|
74
|
-
```
|
|
75
|
-
Use run_tests tool:
|
|
76
|
-
- passed: true (or false if tests failed)
|
|
77
|
-
- testCommand: "npm test"
|
|
78
|
-
- details: "[Number of tests, coverage, etc.]"
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
**Important:** If tests fail, fix them before proceeding. The workflow blocks commits with failing tests.
|
|
82
|
-
|
|
83
|
-
### 6. Create Documentation
|
|
84
|
-
|
|
85
|
-
Update relevant documentation:
|
|
86
|
-
- README with feature usage
|
|
87
|
-
- Inline code comments
|
|
88
|
-
- API documentation
|
|
89
|
-
- CHANGELOG entry
|
|
90
|
-
|
|
91
|
-
Then mark documentation as complete:
|
|
92
|
-
|
|
93
|
-
```
|
|
94
|
-
Use create_documentation tool:
|
|
95
|
-
- documentationType: "README" (or "inline-comments", "API-docs", "changelog")
|
|
96
|
-
- summary: "[What you documented]"
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
### 7. Commit and Push
|
|
100
|
-
|
|
101
|
-
The MCP server automatically stages, commits, and pushes:
|
|
102
|
-
|
|
103
|
-
```
|
|
104
|
-
Use commit_and_push tool:
|
|
105
|
-
- commitMessage: "feat([scope]): [description]"
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
Use conventional commit format:
|
|
109
|
-
- `feat(auth): add social login`
|
|
110
|
-
- `feat(ui): add dark mode toggle`
|
|
111
|
-
|
|
112
|
-
The branch is auto-detected (main or master). To specify a branch:
|
|
113
|
-
|
|
114
|
-
```
|
|
115
|
-
Use commit_and_push tool:
|
|
116
|
-
- commitMessage: "feat([scope]): [description]"
|
|
117
|
-
- branch: "feature/your-branch"
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
### 8. Perform Release
|
|
121
|
-
|
|
122
|
-
Record the release:
|
|
123
|
-
|
|
124
|
-
```
|
|
125
|
-
Use perform_release tool:
|
|
126
|
-
- command: "npm run release:minor" (features are usually minor versions)
|
|
127
|
-
- notes: "v[X.Y.Z] - [Feature highlights]"
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
### 9. Complete Task
|
|
131
|
-
|
|
132
|
-
Mark the task as complete:
|
|
133
|
-
|
|
134
|
-
```
|
|
135
|
-
Use complete_task tool:
|
|
136
|
-
- commitMessage: "feat([scope]): [description]" (same as commit message)
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
This resets the workflow for your next task.
|
|
140
|
-
|
|
141
|
-
## Example: Adding Shopping Cart
|
|
142
|
-
|
|
143
|
-
```
|
|
144
|
-
1. start_task:
|
|
145
|
-
description: "Add shopping cart functionality"
|
|
146
|
-
type: "feature"
|
|
147
|
-
|
|
148
|
-
2. [Implement cart component, add/remove logic, localStorage persistence]
|
|
149
|
-
|
|
150
|
-
3. mark_bug_fixed:
|
|
151
|
-
summary: "Shopping cart with add/remove items and localStorage persistence"
|
|
152
|
-
|
|
153
|
-
4. [Write cart tests: add item, remove item, update quantity, persistence]
|
|
154
|
-
|
|
155
|
-
5. create_tests
|
|
156
|
-
|
|
157
|
-
6. Run: npm test
|
|
158
|
-
|
|
159
|
-
7. run_tests:
|
|
160
|
-
passed: true
|
|
161
|
-
testCommand: "npm test"
|
|
162
|
-
details: "12 cart tests added, all pass. Coverage: 94%"
|
|
163
|
-
|
|
164
|
-
8. [Update README with cart API, add inline comments]
|
|
165
|
-
|
|
166
|
-
9. create_documentation:
|
|
167
|
-
documentationType: "README"
|
|
168
|
-
summary: "Added shopping cart API documentation and usage examples"
|
|
169
|
-
|
|
170
|
-
10. commit_and_push:
|
|
171
|
-
commitMessage: "feat(cart): add shopping cart with localStorage persistence"
|
|
172
|
-
|
|
173
|
-
11. perform_release:
|
|
174
|
-
command: "npm run release:minor"
|
|
175
|
-
notes: "v1.5.0 - Shopping cart feature"
|
|
176
|
-
|
|
177
|
-
12. complete_task:
|
|
178
|
-
commitMessage: "feat(cart): add shopping cart with localStorage persistence"
|
|
179
|
-
```
|
|
180
|
-
|
|
181
|
-
## Quick Reference
|
|
182
|
-
|
|
183
|
-
```
|
|
184
|
-
1. start_task → 2. Code → 3. mark_bug_fixed → 4. Write tests
|
|
185
|
-
→ 5. create_tests → 6. run_tests → 7. Document → 8. create_documentation
|
|
186
|
-
→ 9. commit_and_push → 10. perform_release → 11. complete_task
|
|
187
|
-
```
|
|
188
|
-
|
|
189
|
-
## Tips
|
|
190
|
-
|
|
191
|
-
- **Keep features small** - One complete feature per workflow
|
|
192
|
-
- **Test thoroughly** - Don't skip tests
|
|
193
|
-
- **Document as you go** - Don't wait until the end
|
|
194
|
-
- **Use conventional commits** - feat(scope): description
|
|
195
|
-
- **Minor versions** - Features bump minor version (X.Y.0)
|
|
196
|
-
|
|
197
|
-
## Need Help?
|
|
198
|
-
|
|
199
|
-
- Check `get_workflow_status` to see where you are
|
|
200
|
-
- Review [EXAMPLES.md](../docs/antigravity/EXAMPLES.md) for detailed examples
|
|
201
|
-
- See [TROUBLESHOOTING.md](../docs/antigravity/TROUBLESHOOTING.md) for common issues
|
|
1
|
+
---
|
|
2
|
+
description: Feature development workflow using dev-workflow MCP server
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Feature Development Workflow
|
|
6
|
+
|
|
7
|
+
This workflow guides you through developing a new feature with the dev-workflow MCP server.
|
|
8
|
+
|
|
9
|
+
## When to Use
|
|
10
|
+
|
|
11
|
+
- Adding new functionality
|
|
12
|
+
- Building new components
|
|
13
|
+
- Implementing new features
|
|
14
|
+
|
|
15
|
+
## Workflow Steps
|
|
16
|
+
|
|
17
|
+
### 1. Start the Task
|
|
18
|
+
|
|
19
|
+
Begin by defining your feature:
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
Use start_task tool:
|
|
23
|
+
- description: "Add [feature name] to [component/area]"
|
|
24
|
+
- type: "feature"
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
The server confirms task start and moves you to the implementation phase.
|
|
28
|
+
|
|
29
|
+
### 2. Implement the Feature
|
|
30
|
+
|
|
31
|
+
Write your code as usual. The workflow doesn't interfere with your development process.
|
|
32
|
+
|
|
33
|
+
Tips:
|
|
34
|
+
- Keep commits atomic
|
|
35
|
+
- Follow coding standards
|
|
36
|
+
- Write clean, maintainable code
|
|
37
|
+
|
|
38
|
+
### 3. Mark as Fixed
|
|
39
|
+
|
|
40
|
+
Once implementation is complete:
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
Use mark_bug_fixed tool:
|
|
44
|
+
- summary: "[Brief description of what was implemented]"
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
The server reminds you that tests are now mandatory.
|
|
48
|
+
|
|
49
|
+
### 4. Create Tests
|
|
50
|
+
|
|
51
|
+
Write comprehensive tests:
|
|
52
|
+
- Unit tests for new functions/components
|
|
53
|
+
- Integration tests for interactions
|
|
54
|
+
- End-to-end tests for user flows (if applicable)
|
|
55
|
+
|
|
56
|
+
Then mark tests as created:
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
Use create_tests tool
|
|
60
|
+
(no parameters needed)
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### 5. Run Tests
|
|
64
|
+
|
|
65
|
+
// turbo
|
|
66
|
+
Execute your test suite:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npm test
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Record the results:
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
Use run_tests tool:
|
|
76
|
+
- passed: true (or false if tests failed)
|
|
77
|
+
- testCommand: "npm test"
|
|
78
|
+
- details: "[Number of tests, coverage, etc.]"
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
**Important:** If tests fail, fix them before proceeding. The workflow blocks commits with failing tests.
|
|
82
|
+
|
|
83
|
+
### 6. Create Documentation
|
|
84
|
+
|
|
85
|
+
Update relevant documentation:
|
|
86
|
+
- README with feature usage
|
|
87
|
+
- Inline code comments
|
|
88
|
+
- API documentation
|
|
89
|
+
- CHANGELOG entry
|
|
90
|
+
|
|
91
|
+
Then mark documentation as complete:
|
|
92
|
+
|
|
93
|
+
```
|
|
94
|
+
Use create_documentation tool:
|
|
95
|
+
- documentationType: "README" (or "inline-comments", "API-docs", "changelog")
|
|
96
|
+
- summary: "[What you documented]"
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### 7. Commit and Push
|
|
100
|
+
|
|
101
|
+
The MCP server automatically stages, commits, and pushes:
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
Use commit_and_push tool:
|
|
105
|
+
- commitMessage: "feat([scope]): [description]"
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Use conventional commit format:
|
|
109
|
+
- `feat(auth): add social login`
|
|
110
|
+
- `feat(ui): add dark mode toggle`
|
|
111
|
+
|
|
112
|
+
The branch is auto-detected (main or master). To specify a branch:
|
|
113
|
+
|
|
114
|
+
```
|
|
115
|
+
Use commit_and_push tool:
|
|
116
|
+
- commitMessage: "feat([scope]): [description]"
|
|
117
|
+
- branch: "feature/your-branch"
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### 8. Perform Release
|
|
121
|
+
|
|
122
|
+
Record the release:
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
Use perform_release tool:
|
|
126
|
+
- command: "npm run release:minor" (features are usually minor versions)
|
|
127
|
+
- notes: "v[X.Y.Z] - [Feature highlights]"
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
### 9. Complete Task
|
|
131
|
+
|
|
132
|
+
Mark the task as complete:
|
|
133
|
+
|
|
134
|
+
```
|
|
135
|
+
Use complete_task tool:
|
|
136
|
+
- commitMessage: "feat([scope]): [description]" (same as commit message)
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
This resets the workflow for your next task.
|
|
140
|
+
|
|
141
|
+
## Example: Adding Shopping Cart
|
|
142
|
+
|
|
143
|
+
```
|
|
144
|
+
1. start_task:
|
|
145
|
+
description: "Add shopping cart functionality"
|
|
146
|
+
type: "feature"
|
|
147
|
+
|
|
148
|
+
2. [Implement cart component, add/remove logic, localStorage persistence]
|
|
149
|
+
|
|
150
|
+
3. mark_bug_fixed:
|
|
151
|
+
summary: "Shopping cart with add/remove items and localStorage persistence"
|
|
152
|
+
|
|
153
|
+
4. [Write cart tests: add item, remove item, update quantity, persistence]
|
|
154
|
+
|
|
155
|
+
5. create_tests
|
|
156
|
+
|
|
157
|
+
6. Run: npm test
|
|
158
|
+
|
|
159
|
+
7. run_tests:
|
|
160
|
+
passed: true
|
|
161
|
+
testCommand: "npm test"
|
|
162
|
+
details: "12 cart tests added, all pass. Coverage: 94%"
|
|
163
|
+
|
|
164
|
+
8. [Update README with cart API, add inline comments]
|
|
165
|
+
|
|
166
|
+
9. create_documentation:
|
|
167
|
+
documentationType: "README"
|
|
168
|
+
summary: "Added shopping cart API documentation and usage examples"
|
|
169
|
+
|
|
170
|
+
10. commit_and_push:
|
|
171
|
+
commitMessage: "feat(cart): add shopping cart with localStorage persistence"
|
|
172
|
+
|
|
173
|
+
11. perform_release:
|
|
174
|
+
command: "npm run release:minor"
|
|
175
|
+
notes: "v1.5.0 - Shopping cart feature"
|
|
176
|
+
|
|
177
|
+
12. complete_task:
|
|
178
|
+
commitMessage: "feat(cart): add shopping cart with localStorage persistence"
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
## Quick Reference
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
1. start_task → 2. Code → 3. mark_bug_fixed → 4. Write tests
|
|
185
|
+
→ 5. create_tests → 6. run_tests → 7. Document → 8. create_documentation
|
|
186
|
+
→ 9. commit_and_push → 10. perform_release → 11. complete_task
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
## Tips
|
|
190
|
+
|
|
191
|
+
- **Keep features small** - One complete feature per workflow
|
|
192
|
+
- **Test thoroughly** - Don't skip tests
|
|
193
|
+
- **Document as you go** - Don't wait until the end
|
|
194
|
+
- **Use conventional commits** - feat(scope): description
|
|
195
|
+
- **Minor versions** - Features bump minor version (X.Y.0)
|
|
196
|
+
|
|
197
|
+
## Need Help?
|
|
198
|
+
|
|
199
|
+
- Check `get_workflow_status` to see where you are
|
|
200
|
+
- Review [EXAMPLES.md](../docs/antigravity/EXAMPLES.md) for detailed examples
|
|
201
|
+
- See [TROUBLESHOOTING.md](../docs/antigravity/TROUBLESHOOTING.md) for common issues
|