@programinglive/dev-workflow-mcp-server 1.4.6 → 1.5.1

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 (38) hide show
  1. package/CHANGELOG.md +114 -0
  2. package/docs/NETLIFY_DEPLOYMENT.md +125 -0
  3. package/docs/product/PRD.md +4 -2
  4. package/docs/release-notes/RELEASE_NOTES.md +32 -0
  5. package/docs/web-dashboard.md +12 -0
  6. package/package.json +1 -1
  7. package/server.json +13 -3
  8. package/tests/build.test.js +30 -0
  9. package/tests/mcpRegistry.test.js +13 -3
  10. package/web/app/api/history/route.ts +10 -17
  11. package/web/app/api/summary/route.ts +11 -13
  12. package/web/app/api/version/route.ts +4 -11
  13. package/web/netlify.toml +6 -0
  14. package/web/next.config.ts +1 -2
  15. package/web/package-lock.json +17 -428
  16. package/web/package.json +0 -1
  17. package/web-legacy/public/assets/android-chrome-192x192.png +0 -0
  18. package/web-legacy/public/assets/android-chrome-512x512.png +0 -0
  19. package/web-legacy/public/assets/apple-touch-icon.png +0 -0
  20. package/web-legacy/public/assets/favicon-16x16.png +0 -0
  21. package/web-legacy/public/assets/favicon-32x32.png +0 -0
  22. package/web-legacy/public/assets/favicon.ico +0 -0
  23. package/web-legacy/public/assets/favicon.png +0 -0
  24. package/web-legacy/public/assets/logo.png +0 -0
  25. package/web-legacy/public/assets/og-preview.png +0 -0
  26. package/web-legacy/public/assets/site.webmanifest +0 -1
  27. package/web-legacy/public/docs/EXAMPLES.html +0 -496
  28. package/web-legacy/public/docs/GETTING-STARTED.html +0 -318
  29. package/web-legacy/public/docs/README.html +0 -620
  30. package/web-legacy/public/docs/RELEASE_NOTES.html +0 -275
  31. package/web-legacy/public/docs/TROUBLESHOOTING.html +0 -627
  32. package/web-legacy/public/docs/WORKFLOW-TEMPLATES.html +0 -676
  33. package/web-legacy/public/docs/web-dashboard.html +0 -243
  34. package/web-legacy/public/index.html +0 -223
  35. package/web-legacy/public/input.css +0 -80
  36. package/web-legacy/public/main.js +0 -167
  37. package/web-legacy/public/output.css +0 -1559
  38. package/web-legacy/server.js +0 -207
@@ -1,627 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Troubleshooting Dev-Workflow MCP Server in Antigravity - Dev Workflow</title>
7
- <link rel="icon" type="image/png" href="/assets/favicon.png">
8
- <meta property="og:type" content="website">
9
- <meta property="og:url" content="https://commiter.programinglive.com/docs/TROUBLESHOOTING.md">
10
- <meta property="og:title" content="Troubleshooting Dev-Workflow MCP Server in Antigravity - Dev Workflow">
11
- <meta property="og:description" content="Detailed documentation for Dev Workflow MCP Server commands and usage.">
12
- <meta property="og:image" content="/assets/og-preview.png">
13
- <meta property="twitter:card" content="summary_large_image">
14
- <meta property="twitter:url" content="https://commiter.programinglive.com/docs/TROUBLESHOOTING.md">
15
- <meta property="twitter:title" content="Troubleshooting Dev-Workflow MCP Server in Antigravity - Dev Workflow">
16
- <meta property="twitter:description" content="Detailed documentation for Dev Workflow MCP Server commands and usage.">
17
- <meta property="twitter:image" content="/assets/og-preview.png">
18
- <link rel="stylesheet" href="/output.css">
19
- <script src="https://unpkg.com/lucide@latest"></script>
20
- </head>
21
- <body class="bg-[#0a0a0f] text-white font-sans antialiased selection:bg-primary/30 selection:text-white min-h-screen flex flex-col">
22
- <header class="fixed top-0 left-0 right-0 z-50 border-b border-white/10 bg-[#0a0a0f]/80 backdrop-blur-md">
23
- <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 h-16 flex items-center justify-between">
24
- <div class="flex items-center gap-3">
25
- <a href="/" class="flex items-center gap-3 hover:opacity-80 transition-opacity">
26
- <div class="w-10 h-10 rounded-lg overflow-hidden border border-white/10 shadow-lg shadow-primary/20">
27
- <img src="/assets/logo.png" alt="Dev Workflow Logo" class="w-full h-full object-cover">
28
- </div>
29
- <div>
30
- <h1 class="font-bold text-lg tracking-tight text-white">Dev Workflow</h1>
31
- <div class="flex items-center gap-2 text-xs text-gray-400">
32
- <span class="w-2 h-2 rounded-full bg-emerald-500 shadow-[0_0_8px_rgba(16,185,129,0.5)]"></span>
33
- <span>Documentation</span>
34
- </div>
35
- </div>
36
- </a>
37
- </div>
38
- <div class="flex items-center gap-4">
39
- <a href="/" class="flex items-center gap-2 px-4 py-2 bg-white/5 hover:bg-white/10 border border-white/10 rounded-full text-sm font-medium transition-all group">
40
- <i data-lucide="layout-dashboard" class="w-4 h-4 text-gray-400 group-hover:text-white transition-colors"></i>
41
- <span>Dashboard</span>
42
- </a>
43
- </div>
44
- </div>
45
- </header>
46
-
47
- <div class="flex-1 max-w-7xl mx-auto w-full px-4 sm:px-6 lg:px-8 pt-24 pb-12 flex gap-8">
48
- <aside class="hidden lg:block w-64 flex-shrink-0 fixed h-[calc(100vh-6rem)] overflow-y-auto pr-4 custom-scrollbar">
49
- <nav class="space-y-1">
50
- <a href="/" class="flex items-center gap-3 px-4 py-3 text-sm font-medium rounded-lg text-gray-400 hover:text-white hover:bg-white/5 transition-colors">
51
- <i data-lucide="arrow-left" class="w-4 h-4"></i>
52
- Back to Dashboard
53
- </a>
54
- </nav>
55
- <div class="mt-8 pt-8 border-t border-white/10">
56
- <h3 class="px-4 text-xs font-semibold text-gray-500 uppercase tracking-wider mb-2">Documentation</h3>
57
- <div class="space-y-1">
58
- <a href="/docs/README.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">README</a>
59
- <a href="/docs/web-dashboard.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">web dashboard</a>
60
- <a href="/docs/GETTING-STARTED.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">GETTING STARTED</a>
61
- <a href="/docs/EXAMPLES.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">EXAMPLES</a>
62
- <a href="/docs/WORKFLOW-TEMPLATES.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">WORKFLOW TEMPLATES</a>
63
- <a href="/docs/TROUBLESHOOTING.html" class="doc-link block px-4 py-2 text-sm font-medium hover:text-white hover:bg-white/5 rounded-lg transition-colors bg-white/5 text-white ring-1 ring-white/5">TROUBLESHOOTING</a>
64
- <a href="/docs/RELEASE_NOTES.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">RELEASE_NOTES</a>
65
- </div>
66
- </div>
67
- </aside>
68
-
69
- <main class="flex-1 lg:pl-72 min-w-0">
70
- <div class="bg-surface border border-white/10 rounded-xl p-8 backdrop-blur-sm">
71
- <header class="mb-8 border-b border-white/10 pb-6">
72
- <h1 class="text-3xl font-bold text-white mb-2">Troubleshooting Dev-Workflow MCP Server in Antigravity</h1>
73
- <p class="text-gray-400 font-mono text-sm">TROUBLESHOOTING.md</p>
74
- </header>
75
- <article class="prose prose-invert prose-lg max-w-none">
76
- <p>Common issues and solutions when using dev-workflow MCP server with Antigravity.</p>
77
- <h2>Table of Contents</h2>
78
- <ul>
79
- <li><a href="#mcp-server-not-appearing">MCP Server Not Appearing</a></li>
80
- <li><a href="#workflow-state-conflicts">Workflow State Conflicts</a></li>
81
- <li><a href="#git-conflicts-with-automated-commits">Git Conflicts with Automated Commits</a></li>
82
- <li><a href="#path-resolution-issues-on-windows">Path Resolution Issues on Windows</a></li>
83
- <li><a href="#sqlite-database-locking">SQLite Database Locking</a></li>
84
- <li><a href="#multi-user-workflow-isolation-problems">Multi-User Workflow Isolation Problems</a></li>
85
- <li><a href="#windsurf-editor-conflicts">Windsurf Editor Conflicts</a></li>
86
- <li><a href="#tests-not-running">Tests Not Running</a></li>
87
- <li><a href="#commit-and-push-failures">Commit and Push Failures</a></li>
88
- </ul>
89
- <hr>
90
- <h2>MCP Server Not Appearing</h2>
91
- <h3>Symptoms</h3>
92
- <ul>
93
- <li>Dev-workflow tools not visible in Antigravity</li>
94
- <li>MCP server commands not available</li>
95
- <li>No response when trying to use workflow tools</li>
96
- </ul>
97
- <h3>Solutions</h3>
98
- <h4>1. Verify Configuration Path</h4>
99
- <p>Check that <code>mcp_config.json</code> is in the correct location:</p>
100
- <p><strong>Windows:</strong></p>
101
- <pre><code class="language-powershell"># Check if file exists
102
- Test-Path &quot;C:\Users\$env:USERNAME\.gemini\antigravity\mcp_config.json&quot;
103
-
104
- # Or alternative location
105
- Test-Path &quot;$env:APPDATA\Antigravity\mcp_config.json&quot;
106
- </code></pre>
107
- <p><strong>macOS/Linux:</strong></p>
108
- <pre><code class="language-bash"># Check config file
109
- ls -la ~/.gemini/antigravity/mcp_config.json
110
- # or
111
- ls -la ~/Library/Application\ Support/Antigravity/mcp_config.json
112
- </code></pre>
113
- <h4>2. Validate JSON Syntax</h4>
114
- <p>Ensure <code>mcp_config.json</code> has valid JSON:</p>
115
- <pre><code class="language-json">{
116
- &quot;mcpServers&quot;: {
117
- &quot;dev-workflow&quot;: {
118
- &quot;command&quot;: &quot;node&quot;,
119
- &quot;args&quot;: [
120
- &quot;d:\\code\\dev-workflow-mcp-server\\index.js&quot;
121
- ]
122
- }
123
- }
124
- }
125
- </code></pre>
126
- <p>Common mistakes:</p>
127
- <ul>
128
- <li>❌ Missing quotes around strings</li>
129
- <li>❌ Trailing commas</li>
130
- <li>❌ Single quotes instead of double quotes</li>
131
- <li>❌ Unescaped backslashes on Windows</li>
132
- </ul>
133
- <p>Use a JSON validator: <code>node -e &quot;console.log(JSON.parse(require(&#39;fs&#39;).readFileSync(&#39;path/to/mcp_config.json&#39;)))&quot;</code></p>
134
- <h4>3. Check Node.js Path</h4>
135
- <p>Verify Node.js is accessible:</p>
136
- <pre><code class="language-bash">node --version
137
- </code></pre>
138
- <p>If not found, specify full Node.js path in config:</p>
139
- <pre><code class="language-json">{
140
- &quot;mcpServers&quot;: {
141
- &quot;dev-workflow&quot;: {
142
- &quot;command&quot;: &quot;C:\\Program Files\\nodejs\\node.exe&quot;,
143
- &quot;args&quot;: [&quot;d:\\code\\dev-workflow-mcp-server\\index.js&quot;]
144
- }
145
- }
146
- }
147
- </code></pre>
148
- <h4>4. Verify Server Path</h4>
149
- <p>Check that <code>index.js</code> exists:</p>
150
- <pre><code class="language-powershell"># Windows
151
- Test-Path &quot;d:\code\dev-workflow-mcp-server\index.js&quot;
152
- </code></pre>
153
- <pre><code class="language-bash"># macOS/Linux
154
- ls -la /path/to/dev-workflow-mcp-server/index.js
155
- </code></pre>
156
- <h4>5. Restart Antigravity</h4>
157
- <p>After configuration changes, <strong>fully restart Antigravity</strong>:</p>
158
- <ol>
159
- <li>Close all Antigravity windows</li>
160
- <li>Quit from system tray if present</li>
161
- <li>Reopen Antigravity</li>
162
- </ol>
163
- <h4>6. Check Server Logs</h4>
164
- <p>Run the server manually to see errors:</p>
165
- <pre><code class="language-bash">cd d:\code\dev-workflow-mcp-server
166
- node index.js
167
- </code></pre>
168
- <p>Look for error messages. Common issues:</p>
169
- <ul>
170
- <li>Missing dependencies (<code>npm install</code>)</li>
171
- <li>Permission errors</li>
172
- <li>Port conflicts</li>
173
- </ul>
174
- <hr>
175
- <h2>Workflow State Conflicts</h2>
176
- <h3>Symptoms</h3>
177
- <ul>
178
- <li>Workflow shows incorrect phase</li>
179
- <li>History from different projects appearing</li>
180
- <li>State not persisting between sessions</li>
181
- </ul>
182
- <h3>Solutions</h3>
183
- <h4>1. Check State File Location</h4>
184
- <p>Verify state file exists:</p>
185
- <pre><code class="language-bash"># In your project directory
186
- ls -la .state/workflow-state.json
187
- </code></pre>
188
- <p>If missing, the server creates it on first use.</p>
189
- <h4>2. Reset Workflow State</h4>
190
- <p>If state is corrupted:</p>
191
- <pre><code class="language-bash"># Backup existing state
192
- cp .state/workflow-state.json .state/workflow-state.json.backup
193
-
194
- # Start fresh (server recreates on next use)
195
- rm .state/workflow-state.json
196
- </code></pre>
197
- <p>Re-run <code>get_workflow_status</code> to initialize.</p>
198
- <h4>3. Per-Project Isolation</h4>
199
- <p>Ensure each project has its own state:</p>
200
- <pre><code class="language-bash"># Project A
201
- cd ~/projects/app-frontend
202
- npm install @programinglive/dev-workflow-mcp-server
203
- # Creates .state/ in app-frontend/
204
-
205
- # Project B
206
- cd ~/projects/app-backend
207
- npm install @programinglive/dev-workflow-mcp-server
208
- # Creates .state/ in app-backend/
209
- </code></pre>
210
- <h4>4. Custom State File Path</h4>
211
- <p>Override state location with environment variable:</p>
212
- <pre><code class="language-json">{
213
- &quot;mcpServers&quot;: {
214
- &quot;dev-workflow&quot;: {
215
- &quot;command&quot;: &quot;node&quot;,
216
- &quot;args&quot;: [&quot;d:\\code\\dev-workflow-mcp-server\\index.js&quot;],
217
- &quot;env&quot;: {
218
- &quot;DEV_WORKFLOW_STATE_FILE&quot;: &quot;d:\\projects\\my-app\\.state\\workflow-state.json&quot;
219
- }
220
- }
221
- }
222
- }
223
- </code></pre>
224
- <hr>
225
- <h2>Git Conflicts with Automated Commits</h2>
226
- <h3>Symptoms</h3>
227
- <ul>
228
- <li><code>commit_and_push</code> fails with merge conflicts</li>
229
- <li>Diverged branch errors</li>
230
- <li>Uncommitted changes blocking workflow</li>
231
- </ul>
232
- <h3>Solutions</h3>
233
- <h4>1. Pull Before Committing</h4>
234
- <p>Always pull latest changes first:</p>
235
- <pre><code class="language-bash">git pull origin main
236
- </code></pre>
237
- <p>Then run workflow commands.</p>
238
- <h4>2. Resolve Conflicts Manually</h4>
239
- <p>If conflicts occur:</p>
240
- <pre><code class="language-bash"># See conflicts
241
- git status
242
-
243
- # Resolve conflicts in files
244
- # Then:
245
- git add .
246
- git commit -m &quot;resolve conflicts&quot;
247
- git push
248
- </code></pre>
249
- <p>Then resume workflow with <code>get_workflow_status</code>.</p>
250
- <h4>3. Use Correct Branch</h4>
251
- <p>Ensure you&#39;re on the right branch:</p>
252
- <pre><code class="language-bash">git branch # Check current branch
253
- git checkout your-feature-branch
254
- </code></pre>
255
- <p>Then specify in workflow:</p>
256
- <pre><code>commit_and_push:
257
- commitMessage: &quot;feat: add feature&quot;
258
- branch: &quot;your-feature-branch&quot;
259
- </code></pre>
260
- <h4>4. Stash Uncommitted Changes</h4>
261
- <p>If you have uncommitted changes blocking the workflow:</p>
262
- <pre><code class="language-bash"># Stash changes
263
- git stash
264
-
265
- # Run workflow
266
- # ...
267
-
268
- # Restore changes
269
- git stash pop
270
- </code></pre>
271
- <hr>
272
- <h2>Path Resolution Issues on Windows</h2>
273
- <h3>Symptoms</h3>
274
- <ul>
275
- <li>&quot;Cannot find module&quot; errors</li>
276
- <li>Path not found errors</li>
277
- <li>Server fails to start</li>
278
- </ul>
279
- <h3>Solutions</h3>
280
- <h4>1. Use Escaped Backslashes</h4>
281
- <p>In JSON, escape backslashes:</p>
282
- <pre><code class="language-json">{
283
- &quot;args&quot;: [&quot;d:\\code\\dev-workflow-mcp-server\\index.js&quot;]
284
- }
285
- </code></pre>
286
- <p>Not:</p>
287
- <pre><code class="language-json">{
288
- &quot;args&quot;: [&quot;d:\code\dev-workflow-mcp-server\index.js&quot;] // ❌ Wrong
289
- }
290
- </code></pre>
291
- <h4>2. Use Forward Slashes</h4>
292
- <p>Alternative: use forward slashes (works on Windows):</p>
293
- <pre><code class="language-json">{
294
- &quot;args&quot;: [&quot;d:/code/dev-workflow-mcp-server/index.js&quot;]
295
- }
296
- </code></pre>
297
- <h4>3. Use Absolute Paths</h4>
298
- <p>Always use full paths, not relative:</p>
299
- <pre><code class="language-json">{
300
- &quot;args&quot;: [&quot;C:\\Users\\Username\\Projects\\dev-workflow-mcp-server\\index.js&quot;]
301
- }
302
- </code></pre>
303
- <h4>4. Avoid Spaces in Paths</h4>
304
- <p>If path has spaces, ensure proper escaping:</p>
305
- <pre><code class="language-json">{
306
- &quot;args&quot;: [&quot;C:\\Program Files\\My Project\\dev-workflow-mcp-server\\index.js&quot;]
307
- }
308
- </code></pre>
309
- <p>Or move to path without spaces.</p>
310
- <hr>
311
- <h2>SQLite Database Locking</h2>
312
- <h3>Symptoms</h3>
313
- <ul>
314
- <li>&quot;Database is locked&quot; errors</li>
315
- <li>Cannot save workflow state</li>
316
- <li>Timeouts when updating workflow</li>
317
- </ul>
318
- <h3>Solutions</h3>
319
- <h4>1. Close Other Processes</h4>
320
- <p>Ensure no other processes have the database open:</p>
321
- <pre><code class="language-powershell"># Windows: Find processes with file open
322
- handle .state\users\
323
-
324
- # macOS/Linux
325
- lsof .state/users/*/workflow-state.db
326
- </code></pre>
327
- <p>Close conflicting processes.</p>
328
- <h4>2. One MCP Server Per User</h4>
329
- <p>Don&#39;t run multiple MCP server instances for same user:</p>
330
- <ul>
331
- <li>Close other editors using the MCP server</li>
332
- <li>Ensure only one Antigravity instance is active</li>
333
- </ul>
334
- <h4>3. Use Different User IDs</h4>
335
- <p>If multiple users/editors need simultaneous access:</p>
336
- <pre><code class="language-json">{
337
- &quot;mcpServers&quot;: {
338
- &quot;dev-workflow&quot;: {
339
- &quot;command&quot;: &quot;node&quot;,
340
- &quot;args&quot;: [&quot;d:\\code\\dev-workflow-mcp-server\\index.js&quot;],
341
- &quot;env&quot;: {
342
- &quot;DEV_WORKFLOW_USER_ID&quot;: &quot;antigravity-user&quot;
343
- }
344
- }
345
- }
346
- }
347
- </code></pre>
348
- <p>In Windsurf:</p>
349
- <pre><code class="language-json">{
350
- &quot;env&quot;: {
351
- &quot;DEV_WORKFLOW_USER_ID&quot;: &quot;windsurf-user&quot;
352
- }
353
- }
354
- </code></pre>
355
- <h4>4. Repair Database</h4>
356
- <p>If database is corrupted:</p>
357
- <pre><code class="language-bash">cd .state/users/your-user-id/
358
-
359
- # Backup
360
- cp workflow-state.db workflow-state.db.backup
361
-
362
- # Check integrity
363
- sqlite3 workflow-state.db &quot;PRAGMA integrity_check;&quot;
364
-
365
- # If corrupted, start fresh
366
- rm workflow-state.db
367
- </code></pre>
368
- <hr>
369
- <h2>Multi-User Workflow Isolation Problems</h2>
370
- <h3>Symptoms</h3>
371
- <ul>
372
- <li>Users see each other&#39;s workflows</li>
373
- <li>History mixing between developers</li>
374
- <li>State conflicts on shared machines</li>
375
- </ul>
376
- <h3>Solutions</h3>
377
- <h4>1. Set Unique User IDs</h4>
378
- <p>Each developer should have unique <code>DEV_WORKFLOW_USER_ID</code>:</p>
379
- <p><strong>Developer Alice:</strong></p>
380
- <pre><code class="language-json">{
381
- &quot;mcpServers&quot;: {
382
- &quot;dev-workflow&quot;: {
383
- &quot;command&quot;: &quot;node&quot;,
384
- &quot;args&quot;: [&quot;d:\\code\\dev-workflow-mcp-server\\index.js&quot;],
385
- &quot;env&quot;: {
386
- &quot;DEV_WORKFLOW_USER_ID&quot;: &quot;alice&quot;
387
- }
388
- }
389
- }
390
- }
391
- </code></pre>
392
- <p><strong>Developer Bob:</strong></p>
393
- <pre><code class="language-json">{
394
- &quot;env&quot;: {
395
- &quot;DEV_WORKFLOW_USER_ID&quot;: &quot;bob&quot;
396
- }
397
- }
398
- </code></pre>
399
- <h4>2. Verify User Isolation</h4>
400
- <p>Check that separate DB files exist:</p>
401
- <pre><code class="language-bash">ls -la .state/users/
402
- # Should see:
403
- # alice/workflow-state.db
404
- # bob/workflow-state.db
405
- </code></pre>
406
- <h4>3. View Specific User History</h4>
407
- <p>In web dashboard:</p>
408
- <pre><code class="language-bash">npm run web
409
- # Open: http://localhost:3111?user=alice
410
- # Or: http://localhost:3111?user=bob
411
- </code></pre>
412
- <hr>
413
- <h2>Windsurf Editor Conflicts</h2>
414
- <h3>Symptoms</h3>
415
- <ul>
416
- <li>Workflow state corrupted when switching between Antigravity and Windsurf</li>
417
- <li>Both editors showing different workflow phases</li>
418
- <li>SQLite locking errors</li>
419
- </ul>
420
- <h3>Root Cause</h3>
421
- <p>Both editors try to use the same workflow state file simultaneously.</p>
422
- <h3>Solutions</h3>
423
- <h4>Solution 1: Use Different User IDs (Recommended)</h4>
424
- <p>Most reliable approach - complete isolation:</p>
425
- <p><strong>Antigravity config:</strong></p>
426
- <pre><code class="language-json">{
427
- &quot;mcpServers&quot;: {
428
- &quot;dev-workflow&quot;: {
429
- &quot;command&quot;: &quot;node&quot;,
430
- &quot;args&quot;: [&quot;d:\\code\\dev-workflow-mcp-server\\index.js&quot;],
431
- &quot;env&quot;: {
432
- &quot;DEV_WORKFLOW_USER_ID&quot;: &quot;antigravity&quot;
433
- }
434
- }
435
- }
436
- }
437
- </code></pre>
438
- <p><strong>Windsurf config:</strong></p>
439
- <pre><code class="language-json">{
440
- &quot;mcpServers&quot;: {
441
- &quot;dev-workflow&quot;: {
442
- &quot;command&quot;: &quot;node&quot;,
443
- &quot;args&quot;: [&quot;d:\\code\\dev-workflow-mcp-server\\index.js&quot;],
444
- &quot;env&quot;: {
445
- &quot;DEV_WORKFLOW_USER_ID&quot;: &quot;windsurf&quot;
446
- }
447
- }
448
- }
449
- }
450
- </code></pre>
451
- <p>This creates:</p>
452
- <ul>
453
- <li><code>.state/users/antigravity/workflow-state.db</code> for Antigravity</li>
454
- <li><code>.state/users/windsurf/workflow-state.db</code> for Windsurf</li>
455
- </ul>
456
- <h4>Solution 2: Use One Editor at a Time</h4>
457
- <p>If you want shared state:</p>
458
- <ol>
459
- <li><strong>Close Windsurf completely</strong> before opening Antigravity</li>
460
- <li>Or <strong>close Antigravity</strong> before opening Windsurf</li>
461
- <li>Only ONE editor should access workflow at a time</li>
462
- </ol>
463
- <h4>Solution 3: Separate Projects</h4>
464
- <p>Use the MCP server in different projects:</p>
465
- <ul>
466
- <li>Antigravity → Project A</li>
467
- <li>Windsurf → Project B</li>
468
- </ul>
469
- <p>Each project has isolated <code>.state/</code> directory.</p>
470
- <h4>Solution 4: Disable in One Editor</h4>
471
- <p>Keep MCP server active in only one editor:</p>
472
- <p>Remove or comment out from one config:</p>
473
- <pre><code class="language-json">{
474
- &quot;mcpServers&quot;: {
475
- // &quot;dev-workflow&quot;: { ... } // Disabled
476
- }
477
- }
478
- </code></pre>
479
- <hr>
480
- <h2>Tests Not Running</h2>
481
- <h3>Symptoms</h3>
482
- <ul>
483
- <li><code>run_tests</code> accepts any input</li>
484
- <li>Tests marked as passed but didn&#39;t actually run</li>
485
- <li>No test output shown</li>
486
- </ul>
487
- <h3>Explanation</h3>
488
- <p>The MCP server <strong>records</strong> test results; it doesn&#39;t execute tests. You must run tests manually first.</p>
489
- <h3>Solution</h3>
490
- <h4>1. Run Tests Manually</h4>
491
- <pre><code class="language-bash"># Run your test suite
492
- npm test
493
- # or
494
- npm run test
495
- # or
496
- yarn test
497
- </code></pre>
498
- <h4>2. Record Results</h4>
499
- <p>Then record in workflow:</p>
500
- <pre><code>run_tests:
501
- passed: true
502
- testCommand: &quot;npm test&quot;
503
- details: &quot;127 tests passed&quot;
504
- </code></pre>
505
- <h4>3. Workflow Blocking</h4>
506
- <p>The workflow <strong>blocks commits if you record <code>passed: false</code></strong>:</p>
507
- <pre><code>run_tests:
508
- passed: false
509
- testCommand: &quot;npm test&quot;
510
- details: &quot;3 tests failed&quot;
511
- </code></pre>
512
- <p>Response:</p>
513
- <pre><code>❌ Tests FAILED!
514
- 🚫 Cannot proceed with failing tests
515
- </code></pre>
516
- <p>Fix tests, re-run, then record:</p>
517
- <pre><code>run_tests:
518
- passed: true
519
- testCommand: &quot;npm test&quot;
520
- details: &quot;All 127 tests now pass&quot;
521
- </code></pre>
522
- <hr>
523
- <h2>Commit and Push Failures</h2>
524
- <h3>Symptoms</h3>
525
- <ul>
526
- <li><code>commit_and_push</code> fails</li>
527
- <li>No changes committ push rejected</li>
528
- <li>Authentication errors</li>
529
- </ul>
530
- <h3>Solutions</h3>
531
- <h4>1. Verify Git Configuration</h4>
532
- <pre><code class="language-bash">git config --list
533
-
534
- # Should have:
535
- # user.name=Your Name
536
- # user.email=your@email.com
537
- </code></pre>
538
- <p>If missing:</p>
539
- <pre><code class="language-bash">git config --global user.name &quot;Your Name&quot;
540
- git config --global user.email &quot;your@email.com&quot;
541
- </code></pre>
542
- <h4>2. Ensure Changes Exist</h4>
543
- <p>MCP server stages files with <code>git add .</code>. Verify changes:</p>
544
- <pre><code class="language-bash">git status
545
- </code></pre>
546
- <p>If no changes, the commit will fail.</p>
547
- <h4>3. Check Remote Configuration</h4>
548
- <pre><code class="language-bash">git remote -v
549
- </code></pre>
550
- <p>Should show:</p>
551
- <pre><code>origin https://github.com/user/repo.git (fetch)
552
- origin https://github.com/user/repo.git (push)
553
- </code></pre>
554
- <p>If missing:</p>
555
- <pre><code class="language-bash">git remote add origin https://github.com/user/repo.git
556
- </code></pre>
557
- <h4>4. Authentication Issues</h4>
558
- <p><strong>GitHub HTTPS:</strong></p>
559
- <pre><code class="language-bash"># Use personal access token
560
- git config --global credential.helper store
561
- git push # Enter token when prompted
562
- </code></pre>
563
- <p><strong>GitHub SSH:</strong></p>
564
- <pre><code class="language-bash"># Verify SSH key
565
- ssh -T git@github.com
566
-
567
- # Change remote to SSH
568
- git remote set-url origin git@github.com:user/repo.git
569
- </code></pre>
570
- <h4>5. Branch Protection</h4>
571
- <p>If branch is protected:</p>
572
- <ul>
573
- <li>Create a feature branch</li>
574
- <li>Push to feature branch instead:</li>
575
- </ul>
576
- <pre><code>commit_and_push:
577
- commitMessage: &quot;feat: add feature&quot;
578
- branch: &quot;feature/my-feature&quot;
579
- </code></pre>
580
- <hr>
581
- <h2>Getting More Help</h2>
582
- <h3>Enable Debug Logging</h3>
583
- <p>Run server with debug output:</p>
584
- <pre><code class="language-bash">NODE_ENV=development node index.js
585
- </code></pre>
586
- <h3>Check Server Health</h3>
587
- <p>Test manually:</p>
588
- <pre><code class="language-bash">cd dev-workflow-mcp-server
589
- node index.js
590
-
591
- # Type to test:
592
- # get_workflow_status
593
- </code></pre>
594
- <h3>Community Support</h3>
595
- <ul>
596
- <li><strong>GitHub Issues:</strong> <a href="https://github.com/programinglive/dev-workflow-mcp-server/issues">Report bugs</a></li>
597
- <li><strong>Discussions:</strong> <a href="https://github.com/programinglive/dev-workflow-mcp-server/discussions">Ask questions</a></li>
598
- </ul>
599
- <h3>Documentation</h3>
600
- <ul>
601
- <li><a href="./GETTING-STARTED.md">Getting Started</a></li>
602
- <li><a href="./EXAMPLES.md">Examples</a></li>
603
- <li><a href="./WORKFLOW-TEMPLATES.md">Workflow Templates</a></li>
604
- <li><a href="../../README.md">Main README</a></li>
605
- </ul>
606
- <hr>
607
- <p><strong>Still having issues?</strong> Open a GitHub issue with:</p>
608
- <ol>
609
- <li>Your <code>mcp_config.json</code> (redact sensitive paths)</li>
610
- <li>Error messages</li>
611
- <li>Steps to reproduce</li>
612
- <li>Antigravity version</li>
613
- <li>Node.js version (<code>node --version</code>)</li>
614
- <li>Operating system</li>
615
- </ol>
616
- <p>We&#39;re here to help! 🛠️</p>
617
-
618
- </article>
619
- </div>
620
- </main>
621
- </div>
622
-
623
- <script>
624
- lucide.createIcons();
625
- </script>
626
- </body>
627
- </html>