@programinglive/dev-workflow-mcp-server 1.8.0 → 1.9.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 (106) hide show
  1. package/.env.example +21 -1
  2. package/AGENTS.md +25 -0
  3. package/README.md +257 -664
  4. package/index.js +5 -4
  5. package/package.json +11 -6
  6. package/scripts/bootstrap-unix.sh +55 -0
  7. package/scripts/bootstrap-windows.ps1 +75 -0
  8. package/scripts/install-husky.js +43 -0
  9. package/scripts/setup-stack.js +436 -0
  10. package/tools/definitions.js +19 -0
  11. package/tools/handler-modules/commit-handlers.js +2 -1
  12. package/tools/handler-modules/index.js +13 -7
  13. package/tools/handler-modules/shared.js +7 -41
  14. package/tools/handler-modules/status-handlers.js +3 -1
  15. package/tools/handler-modules/workflow-handlers.js +26 -8
  16. package/workflow-state.js +10 -0
  17. package/.agent/workflows/dev-workflow-bugfix.md +0 -250
  18. package/.agent/workflows/dev-workflow-feature.md +0 -201
  19. package/.agent/workflows/dev-workflow-full-cycle.md +0 -400
  20. package/.agent/workflows/dev-workflow-refactor.md +0 -238
  21. package/.env.production +0 -16
  22. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -34
  23. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -25
  24. package/.github/pull_request_template.md +0 -22
  25. package/.github/workflows/github-release.yml +0 -131
  26. package/.husky/commit-msg +0 -3
  27. package/.husky/pre-commit +0 -2
  28. package/CHANGELOG.md +0 -1137
  29. package/docs/GCP_DEPLOYMENT.md +0 -298
  30. package/docs/NETLIFY_DEPLOYMENT.md +0 -125
  31. package/docs/PLESK_DEPLOYMENT.md +0 -170
  32. package/docs/PRD.md +0 -83
  33. package/docs/WORKFLOW-BEST-PRACTICES.md +0 -58
  34. package/docs/antigravity/EXAMPLES.md +0 -535
  35. package/docs/antigravity/GETTING-STARTED.md +0 -292
  36. package/docs/antigravity/TROUBLESHOOTING.md +0 -742
  37. package/docs/antigravity/WALKTHROUGH.md +0 -25
  38. package/docs/antigravity/WORKFLOW-TEMPLATES.md +0 -670
  39. package/docs/release-notes/RELEASE_NOTES.md +0 -516
  40. package/docs/web-dashboard.md +0 -175
  41. package/tailwind.config.js +0 -8
  42. package/tests/build.test.js +0 -74
  43. package/tests/db-adapters.test.js +0 -108
  44. package/tests/env-support.test.js +0 -46
  45. package/tests/exec.test.js +0 -35
  46. package/tests/handlers-commit.test.js +0 -174
  47. package/tests/handlers-release.test.js +0 -212
  48. package/tests/handlers-workflow.test.js +0 -68
  49. package/tests/handlers.test.js +0 -1142
  50. package/tests/hello-world.test.js +0 -13
  51. package/tests/mcpRegistry.test.js +0 -65
  52. package/tests/patch-release.test.js +0 -7
  53. package/tests/release-wrapper.test.js +0 -107
  54. package/tests/startup-resilience.test.js +0 -73
  55. package/tests/test-helpers.js +0 -50
  56. package/tests/workflowState.test.js +0 -520
  57. package/web/Dockerfile.api +0 -25
  58. package/web/README.md +0 -133
  59. package/web/__tests__/api/workflow-history.test.js +0 -63
  60. package/web/api-server.js +0 -211
  61. package/web/app/docs/page.tsx +0 -202
  62. package/web/app/favicon.ico +0 -0
  63. package/web/app/globals.css +0 -91
  64. package/web/app/history/page.tsx +0 -220
  65. package/web/app/layout.tsx +0 -39
  66. package/web/app/login/page.tsx +0 -142
  67. package/web/app/page.tsx +0 -13
  68. package/web/components/ApiReference.tsx +0 -20
  69. package/web/components/Features.tsx +0 -61
  70. package/web/components/Footer.tsx +0 -9
  71. package/web/components/Hero.tsx +0 -96
  72. package/web/components/History.tsx +0 -175
  73. package/web/components/Navbar.tsx +0 -208
  74. package/web/components/Terminal.tsx +0 -114
  75. package/web/components/ThemeProvider.tsx +0 -58
  76. package/web/eslint.config.mjs +0 -18
  77. package/web/lib/api-client.ts +0 -123
  78. package/web/lib/auth.js +0 -75
  79. package/web/lib/db.js +0 -131
  80. package/web/lib/docs.js +0 -73
  81. package/web/middleware/auth.js +0 -26
  82. package/web/netlify.toml +0 -8
  83. package/web/next.config.ts +0 -19
  84. package/web/package-lock.json +0 -10911
  85. package/web/package.json +0 -42
  86. package/web/postcss.config.mjs +0 -9
  87. package/web/public/assets/android-chrome-192x192.png +0 -0
  88. package/web/public/assets/android-chrome-512x512.png +0 -0
  89. package/web/public/assets/apple-touch-icon.png +0 -0
  90. package/web/public/assets/favicon-16x16.png +0 -0
  91. package/web/public/assets/favicon-32x32.png +0 -0
  92. package/web/public/assets/favicon.ico +0 -0
  93. package/web/public/assets/favicon.png +0 -0
  94. package/web/public/assets/logo.png +0 -0
  95. package/web/public/assets/og-preview.png +0 -0
  96. package/web/public/assets/site.webmanifest +0 -1
  97. package/web/public/file.svg +0 -1
  98. package/web/public/globe.svg +0 -1
  99. package/web/public/next.svg +0 -1
  100. package/web/public/vercel.svg +0 -1
  101. package/web/public/window.svg +0 -1
  102. package/web/scripts/db-query-history.js +0 -120
  103. package/web/scripts/smoke-test.js +0 -30
  104. package/web/server.js +0 -184
  105. package/web/tailwind.config.ts +0 -20
  106. package/web/tsconfig.json +0 -42
@@ -1,516 +0,0 @@
1
- # Release Notes
2
-
3
- Authoritative history of user-visible changes for the Development Workflow MCP Server. Each entry highlights the improvements that shipped with the tagged version.
4
-
5
- | Version | Date | Notes |
6
- |---------|------|-------|
7
- | 1.7.17 | 2025-12-26 | update release notes for v1.7.16 (0afd96b) |
8
- | 1.7.16 | 2025-12-24 | align database schema with dashboard and improve user ID handling (69e7f38) |
9
- | 1.7.15 | 2025-12-19 | optimize startup performance and add database connection resilience (bff2714) |
10
- | 1.7.14 | 2025-12-19 | add API dependencies and update login to use API client (94bb42f) |
11
- | 1.7.13 | 2025-12-18 | remote db connection, history api 500 errors, and windows startup (ce559a6) |
12
- | 1.7.12 | 2025-12-17 | post-release cleanup v1.7.11 (c2ee733) |
13
- | 1.7.11 | 2025-12-17 | test: comprehensive DB adapter tests, env support, and warning fixes (64b029a) |
14
- | 1.7.10 | 2025-12-16 | update release notes and finalize ci config (92ac78a) |
15
- | 1.7.9 | 2025-12-16 | **ci:** apply official npm trusted publishing config (9256583) |
16
- | 1.7.8 | 2025-12-16 | **ci:** remove all token config for pure OIDC publishing (d4759cc) |
17
- | 1.7.7 | 2025-12-16 | **ci:** remove duplicates and apply robust trusted publishing config (eedb661) |
18
- | 1.7.6 | 2025-12-16 | **ci:** restore registry config with token fallback for Trusted Publishing (542615c) |
19
- | 1.7.5 | 2025-12-16 | **ci:** switch to tokenless trusted publishing (fdfc4a9) |
20
- | 1.7.4 | 2025-12-16 | **ci:** add id-token permission for npm provenance (8930338) |
21
- | 1.7.3 | 2025-12-16 | **ci:** add web dependencies installation step (7d5dc62) |
22
- | 1.7.2 | 2025-12-16 | **ci:** consolidate release and publish workflows (98e5b31) |
23
- | 1.7.1 | 2025-12-16 | build errors and warnings (dc24831) |
24
- | 1.7.0 | 2025-12-16 | See CHANGELOG for details. |
25
- | 1.6.3 | 2025-12-06 | update release notes for 1.6.2 (f0c2d49) |
26
- | 1.6.2 | 2025-12-06 | update release notest for 1.6.1 (72a9284) |
27
- | 1.6.1 | 2025-12-06 | add table header to release notes for release script compatibility (44e47fc) |
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
- ## 1.7.17 – 📝 Documentation
51
-
52
- Released on **2025-12-26**.
53
-
54
- - update release notes for v1.7.16 (0afd96b)
55
- - allow skipping release step (004e4fa)
56
- - add @programinglive/commiter setup (1d2a19d)
57
-
58
- ## 1.7.16 – 🐛 Bug Fixes
59
-
60
- Released on **2025-12-24**.
61
-
62
- - align database schema with dashboard and improve user ID handling (69e7f38)
63
- - cleanup temporary debugging scripts (a5e2b15)
64
- - sync version to 1.7.15 across web and landing pages (c520e4a)
65
- - update macOS MCP config instructions (1e368da)
66
-
67
- ## 1.7.15 – 🐛 Bug Fixes
68
-
69
- Released on **2025-12-19**.
70
-
71
- - optimize startup performance and add database connection resilience (bff2714)
72
- - refactor Navbar and History to use absolute API client URLs v1.7.18 (dc33eae)
73
- - sync all version labels to 1.7.14 and improve netlify routing (78712eb)
74
- - sync all version strings to 1.7.14 (e2a1795)
75
- - sync version to 1.7.14 and fix static routing via trailingSlash (1c152bd)
76
-
77
- ## 1.7.14 – ✨ Features
78
-
79
- Released on **2025-12-19**.
80
-
81
- - add API dependencies and update login to use API client (94bb42f)
82
- - add REST API server for frontend database access (cdb347c)
83
- - implement JWT authentication and update client (8efbe80)
84
- - remove session cookies, enforce JWT only (bacd83a)
85
- - add credentials:include to getCurrentUser to persist session (b8f2df5)
86
- - add root netlify.toml for monorepo support (54c5ed3)
87
- - enable trust proxy and force secure cookies for cross-domain session (2c5d6e8)
88
- - ensure getMe uses full API URL (b3bd0da)
89
- - force API URL to tunnel address to resolve cached old IP (1883731)
90
- - inline auth functions in API server (eefd73c)
91
- - remove duplicate variable declarations in API server (31d3621)
92
- - remove dynamic API route for static export (05a4dd0)
93
- - remove explicit publish path to fix netlify build (cd64bcf)
94
- - remove incorrect netlify publish dir for dynamic build (ea34cf4)
95
- - remove incorrect publish dir from netlify config (010236f)
96
- - restore static export for netlify deployment (685d841)
97
- - update API URL to use Cloudflare Tunnel for HTTPS (ab72f6c)
98
- - use apiClient in history page and add version indicator (4889669)
99
- - use npm install instead of ci to avoid lockfile issues (e5fae26)
100
- - bump version to 1.7.14 to ensure fresh build (f7d8886)
101
- - bump version to 1.7.15 for JWT frontend deploy (7850268)
102
- - cleanup post-release and update website version to 1.7.13 (7341d44)
103
- - save pending changes before release (4d4b1c9)
104
-
105
- ## 1.7.13 – 🐛 Bug Fixes
106
-
107
- Released on **2025-12-18**.
108
-
109
- - remote db connection, history api 500 errors, and windows startup (ce559a6)
110
-
111
- ## 1.7.12 – 📝 Documentation
112
-
113
- Released on **2025-12-17**.
114
-
115
- - post-release cleanup v1.7.11 (c2ee733)
116
- - add authentication system with login page and protected routes (2acb20e)
117
- - add Docker deployment support with PostgreSQL for GCP (3adb4cb)
118
- - expose PostgreSQL port for remote access (b1d4066)
119
- - revamp history page UI and remove history from landing (a9d0e4e)
120
- - simplify docker-compose to only PostgreSQL, improve logout button UI (4530862)
121
- - suppress 401 auth errors in console (b63e63b)
122
- - **web:** resolve 500 error on history API and auth sync (88bbff0)
123
- - configure commitlint and husky via commiter setup (4de6c84)
124
- - update website to v1.7.11 and fix dependencies (da80b1c)
125
-
126
- ## 1.7.11 – 📝 Documentation
127
-
128
- Released on **2025-12-16**.
129
-
130
- - fix version status in PRD (fa7912b)
131
- - implement .env support and fix mysql date persistence (096797c)
132
- ## 1.7.11 – 📝 Documentation & 🧪 Testing
133
-
134
- Released on **2025-12-17**.
135
-
136
- - test: comprehensive DB adapter tests for MySQL, PostgreSQL, and SQLite (64b029a)
137
- - test: implemented env support verification (64b029a)
138
- - test: fixed deprecation warnings and missing mock exports (64b029a)
139
- - docs: updated PRD and README with testing guide (64b029a)
140
-
141
- ## 1.7.10 – 🧹 Chores
142
-
143
- Released on **2025-12-16**.
144
-
145
- - update release notes and finalize ci config (92ac78a)
146
- - update PRD and release notes for v1.7.9 (024b3c2)
147
-
148
- ## 1.7.9 – 🐛 Bug Fixes
149
-
150
- Released on **2025-12-16**.
151
-
152
- - **ci:** apply official npm trusted publishing config (9256583)
153
- - Fixed recurring ENEEDAUTH errors by adhering strictly to npm's Trusted Publishing documentation.
154
- - Configuration now includes `registry-url` in `setup-node` combined with `id-token: write` permission.
155
- - Ensures a seamless, tokenless release process via OIDC.
156
-
157
- ## 1.7.8 – 🐛 Bug Fixes
158
-
159
- Released on **2025-12-16**.
160
-
161
- - **ci:** remove all token config for pure OIDC publishing (d4759cc)
162
-
163
- ## 1.7.7 – 🐛 Bug Fixes
164
-
165
- Released on **2025-12-16**.
166
-
167
- - **ci:** remove duplicates and apply robust trusted publishing config (eedb661)
168
-
169
- ## 1.7.6 – 🐛 Bug Fixes
170
-
171
- Released on **2025-12-16**.
172
-
173
- - **ci:** restore registry config with token fallback for Trusted Publishing (542615c)
174
-
175
- ## 1.7.5 – 🐛 Bug Fixes
176
-
177
- Released on **2025-12-16**.
178
-
179
- - **ci:** switch to tokenless trusted publishing (fdfc4a9)
180
-
181
- ## 1.7.4 – 🐛 Bug Fixes
182
-
183
- Released on **2025-12-16**.
184
-
185
- - **ci:** add id-token permission for npm provenance (8930338)
186
-
187
- ## 1.7.3 – 🐛 Bug Fixes
188
-
189
- Released on **2025-12-16**.
190
-
191
- - **ci:** add web dependencies installation step (7d5dc62)
192
-
193
- ## 1.7.2 – 🐛 Bug Fixes
194
-
195
- Released on **2025-12-16**.
196
-
197
- - **ci:** consolidate release and publish workflows (98e5b31)
198
-
199
- ## 1.7.1 – 🐛 Bug Fixes
200
-
201
- Released on **2025-12-16**.
202
-
203
- - build errors and warnings (dc24831)
204
- - suppress remaining build warnings (f7d9b2d)
205
- - handle null CustPL in birthday-customers.blade.php (ERP-19) (71b8f7e)
206
- - integrate database adapters into workflow state (370cbb4)
207
- - update PRD and add configuration guide (1dfccf5)
208
- - update release notes for 1.6.3 (afb9fb9)
209
- - add mysql2 and pg dependencies (94423d7)
210
- - **release:** null 🚀 (93a17e2)
211
- - **release:** null 🚀 (033097e)
212
- - **release:** null 🚀 (91c800a)
213
- - **release:** null 🚀 (f0958c4)
214
- - **release:** null 🚀 (ac3cc6e)
215
- - **release:** null 🚀 (f3f9a00)
216
- - **release:** null 🚀 (bcf7d95)
217
- - **release:** null 🚀 (74df6d6)
218
- - **release:** null 🚀 (0d9dc4d)
219
- - **release:** null 🚀 (9667012)
220
- - **release:** null 🚀 (db25d0c)
221
- - **release:** null 🚀 (50d5353)
222
- - **release:** null 🚀 (ee0a540)
223
- - **release:** null 🚀 (92558af)
224
- - **release:** null 🚀 (cd851ac)
225
- - **release:** null 🚀 (49ec562)
226
- - **release:** null 🚀 (bcc7a3c)
227
- - implement database adapters for sqlite, mysql, postgres (8e7416a)
228
- - persist active workflow state to database (d29546d)
229
-
230
- ## 1.7.0
231
-
232
- Released on **2025-12-16**.
233
-
234
- - See CHANGELOG for details.
235
-
236
- ## 1.6.3 – 📝 Documentation
237
-
238
- Released on **2025-12-06**.
239
-
240
- - update release notes for 1.6.2 (f0c2d49)
241
- - add light mode support to docs page (490cf22)
242
-
243
- ## 1.6.2 – 📝 Documentation
244
-
245
- Released on **2025-12-06**.
246
-
247
- - update release notest for 1.6.1 (72a9284)
248
- - update create_documentation test to verify PRD check and remove incompatible jest test (a7f2b28)
249
- - add PRD file existence check to create_documentation workflow step (62cdee3)
250
- - add PRD file existence check to create_documentation workflow step (6c51012)
251
-
252
- ## 1.6.1 – 🐛 Bug Fixes
253
-
254
- Released on **2025-12-06**.
255
-
256
- - add table header to release notes for release script compatibility (44e47fc)
257
- - add responsive vertical monitor support and dark/light mode toggle (5565765)
258
-
259
- ## Unreleased
260
-
261
- ## 1.5.11 — 2025-12-05
262
- - See CHANGELOG for details.
263
-
264
- ## 1.5.10 — 2025-12-05
265
- - See CHANGELOG for details.
266
-
267
- ## 1.5.9 — 2025-12-05
268
- - See CHANGELOG for details.
269
-
270
- ## 1.5.8 — 2025-12-05 — 🐛 Bug Fixes
271
- - **release:** amend tag to include release notes, remove build-docs.js and dist/docs (a3cea9b)
272
-
273
- ## 1.5.7 — 2025-12-05 — 🐛 Bug Fixes
274
- - **ci:** checkout main branch for release notes and remove RELEASE_NOTES.html generation (5d50dc0)
275
-
276
- ## 1.5.6 — 2025-12-05 — 🐛 Bug Fixes
277
- - **ci:** update github release workflow to use github-script (0990808)
278
-
279
- ## 1.5.5 — 2025-12-05 — 📝 Documentation
280
- - add unreleased note for release automation (a5478dc)
281
- - ensure GitHub release workflow writes release notes correctly
282
-
283
- ## 1.5.4 — 2025-12-05 — 🧹 Chores
284
- - **ci:** add github release automation workflow (80d5ded)
285
- - **release:** version 1.5.3 changes and changelog (c2698a7)
286
- - run release scripts via cjs (bc241c8)
287
- - **web:** update version display to 1.5.3 in docs page (25e37f3)
288
- - **web:** update version display to 1.5.3 in Hero component (b478449)
289
-
290
- ## 1.5.3 — 2025-12-05 — 🐛 Bug Fixes
291
- - correct package.json version from null to 1.5.2 for npm publish (be60c99)
292
- - **news:** improve error handling and form accessibility (5e0a1a8)
293
- - switch to static export for Netlify deployment (acddfd7)
294
- - **release:** null 🚀 (55d7f99)
295
- - **release:** prepare patch release 1.5.3 (5b92c42)
296
-
297
- ## 1.5.0 — 2025-12-02
298
- - See CHANGELOG for details.
299
-
300
- ## 1.4.11 — 2025-12-01 — 🐛 Bug Fixes
301
- - move vite to dependencies to ensure build works on production (62fc4c0)
302
- - resolve sentry permission issues (c739f8e)
303
-
304
- ## 1.4.10 — 2025-12-01 — ✨ Features
305
- - **dashboard:** implement random data generation for analytics chart (17e2073)
306
- - move dompdf to require and resolve debugbar production error (e5d1cb6)
307
-
308
- ## 1.4.9 — 2025-11-30 — ♻️ Refactors
309
- - **dashboard:** combine analytics charts and use local Chart.js (86ed3f4)
310
-
311
- ## 1.4.8 — 2025-11-30 — 🐛 Bug Fixes
312
- - **dashboard:** improve responsive layout for admin stats cards (33d5b39)
313
- - **dashboard:** improve responsive layout for admin stats cards (530400d)
314
-
315
- ## 1.4.7 — 2025-11-29 — ✨ Features
316
- - add core doc types (PRD/README/RELEASE_NOTES) and fix CI build (8ed0567)
317
- - update hero text and meta description to emphasize Indonesian programmer community (681547b)
318
- - display dynamic version in web dashboard from /api/version (69f561d)
319
- - add 1.4.3 release notes (8b165f7)
320
- - add MCP registry metadata (mcpName & server.json) (66caea1)
321
- - align MCP registry schema and docs (e4e732d)
322
- - **release:** 1.4.4 🚀 (05a968f)
323
- - **release:** 1.4.5 🚀 (7e823b9)
324
- - **release:** 1.4.6 🚀 (7e0b672)
325
-
326
- ## 1.4.6 — 2025-11-27 — 🧹 Chores
327
- - add MCP registry metadata (mcpName & server.json) (66caea1)
328
-
329
- ## 1.4.5 — 2025-11-27 — 🐛 Bug Fixes
330
- - display dynamic version in web dashboard from /api/version (69f561d)
331
-
332
- ## 1.4.4 — 2025-11-27 — ♻️ Refactors
333
- - consolidate workflow state to root .state folder only (3d69a14)
334
- - ensure release guard uses freshest workflow state (e07eb42)
335
- - remove invalid turbopack experimental config from next.config.ts (af0a7ea)
336
- - **web:** configure next.js root to silence warnings (22ed002)
337
- - **web:** improve mobile layout for hero section (53b26bf)
338
- - add Plesk deployment guide (de35675)
339
- - add 1.4.3 release notes (8b165f7)
340
- - fix release state detection (ed5dfd1)
341
- - prepare for release (a6ea2d0)
342
- - **release:** 1.4.2 (fac8999)
343
- - **release:** 1.4.2 🚀 (01b0b3c)
344
- - **release:** 1.4.3 🚀 (04d8c3b)
345
- - update task list (35663dd)
346
- - **web:** fix next.js lockfile warning (05ffce0)
347
- - add core doc types (PRD/README/RELEASE_NOTES) and fix CI build (8ed0567)
348
- - update hero text and meta description to emphasize Indonesian programmer community (681547b)
349
- - update program tracks and fix fast refresh warning (aa5bc9c)
350
-
351
- ## 1.4.3 — 2025-11-27 — 🧹 Chores
352
- - **release:** 1.4.2 (fac8999)
353
- - remove invalid turbopack experimental config from next.config.ts (af0a7ea)
354
- - add Plesk deployment guide (de35675)
355
- - update program tracks and fix fast refresh warning (aa5bc9c)
356
-
357
- ## 1.4.2 — 2025-11-27 — 🧹 Chores
358
- - fix release state detection (ed5dfd1)
359
- - prepare for release (a6ea2d0)
360
- - update task list (35663dd)
361
- - **web:** fix next.js lockfile warning (05ffce0)
362
- - ensure release guard uses freshest workflow state (e07eb42)
363
- - **web:** configure next.js root to silence warnings (22ed002)
364
- - **web:** improve mobile layout for hero section (53b26bf)
365
- - consolidate workflow state to root .state folder only (3d69a14)
366
-
367
- ## 1.4.1 — 2025-11-27 — 🐛 Bug Fixes
368
- - update build test to include postbuild (b1e2f48)
369
- - add custom server.js for Plesk (b3912cd)
370
- - migrate dashboard to Next.js with TypeScript and Tailwind CSS (bce1fec)
371
- - fix package.json scripts (fb25e98)
372
- - fix tsconfig and remove dist artifact (282759f)
373
-
374
- ## 1.4.0 — 2025-11-26
375
- - See CHANGELOG for details.
376
-
377
- ## 1.3.11 — 2025-11-23
378
- - Re-applied Plesk security fix (moved static files to `web/public/`).
379
- - Updated build configuration and server paths.
380
-
381
- ## 1.3.10 — 2025-11-23
382
- - Fixed workflow state synchronization issue that caused forced releases.
383
- - Added `docs/WORKFLOW-BEST-PRACTICES.md`.
384
-
385
- ## 1.3.9 — 2025-11-23
386
- - Improved documentation modal layout and readability.
387
-
388
- ## 1.3.8 — 2025-11-23
389
- - Fixed documentation loading in production by tracking `dist/docs` in git.
390
-
391
- ## 1.3.0 — 2025-11-22
392
- - Added comprehensive Antigravity integration documentation and examples.
393
- - Fixed Windows shell escaping for commit messages.
394
- - Fixed release scripts to support ESM projects.
395
- - Release guard now delegates to `@programinglive/commiter` and verifies the package is installed before running.
396
-
397
- ## 1.2.7 — 2025-11-13
398
- - Delegated release process to `@programinglive/commiter`.
399
-
400
- ## 1.2.6 — 2025-11-11
401
- - Exposed primary branch helper in CLI.
402
- - Updated documentation regarding commiter delegation.
403
-
404
- > **Notice:** Versions 1.2.2 through 1.2.5 were published briefly for packaging experiments and have been withdrawn.
405
-
406
- ## 1.2.1 — 2025-11-03
407
- - Packaging touch-up; functionality remains identical to 1.2.0.
408
-
409
- ## 1.2.0 — 2025-11-03
410
- - Reload the workflow state from disk for every tool call, preventing stale data when multiple clients manipulate the same project.
411
-
412
- ## 1.1.18 — 2025-11-03
413
- - `commit_and_push` now auto-detects the primary branch (preferring `main`, then `master`) when none is supplied.
414
-
415
- ## 1.1.17 — 2025-10-31
416
- - Release bookkeeping only; no user-facing changes.
417
-
418
- ## 1.1.16 — 2025-10-31
419
- - Added npm provenance metadata so published packages include supply-chain attestations.
420
-
421
- ## 1.1.15 — 2025-10-31
422
- - Documented the automated npm publish workflow and ensured CI builds include provenance before publishing.
423
-
424
- ## 1.1.14 — 2025-10-31
425
- - Improved project-root detection for workflow state, fixing issues when the server runs from nested directories.
426
-
427
- ## 1.1.13 — 2025-10-30
428
- - Version bump to distribute refreshed dashboard assets; no new functionality beyond 1.1.12.
429
-
430
- ## 1.1.12 — 2025-10-30
431
- - Added a `node index.js call <tool>` CLI helper to invoke MCP tools without a client integration.
432
- - Refreshed the web dashboard with a docs modal, dedicated docs API endpoints, and streamlined navigation.
433
-
434
- ## 1.1.11 — 2025-10-30
435
- - Introduced per-user workflow state stored under `.state/users/<id>/` to avoid collisions on shared repos.
436
- - Added a SQLite-backed project knowledge summary and the dashboard that visualizes history and trends.
437
- - Hardened resumable workflows by re-checking persisted summaries between steps.
438
-
439
- ## 1.1.10 — 2025-10-29
440
- - Shipped the initial project knowledge library with a persisted JSON summary for future database integrations.
441
-
442
- ## 1.1.9 — 2025-10-29
443
- - Made `run_full_workflow` resume intelligently from the current phase.
444
- - Expanded automated tests around README/exec updates and other workflow paths.
445
-
446
- ## 1.1.8 — 2025-10-27
447
- - Documented the `DEV_WORKFLOW_STATE_FILE` override for relocating workflow state outside the repository.
448
-
449
- ## 1.1.7 — 2025-10-26
450
- - Added prompts guiding developers to document changes immediately after tests pass.
451
-
452
- ## 1.1.6 — 2025-10-26
453
- - Prevented `.state` from being created at filesystem roots.
454
- - Enforced that commits must land before any release action can run.
455
-
456
- ## 1.1.5 — 2025-10-25
457
- - Introduced the release guard, blocking `npm run release:*` until every prerequisite tool has run.
458
- - Standardized per-project workflow state creation during installs.
459
-
460
- ## 1.1.4 — 2025-10-25
461
- - Ensured the install script always targets the project root when initializing `.state`.
462
-
463
- ## 1.1.3 — 2025-10-25
464
- - Packaged the MCP server for project-level installs with per-project workflow state isolation.
465
-
466
- ## 1.1.2 — 2025-10-25
467
- - Version alignment release with no additional changes versus 1.1.1.
468
-
469
- ## 1.1.1 — 2025-10-25
470
- - Added `force_complete_task`, letting teams close tasks early with an audit trail.
471
-
472
- ## 1.1.0 — 2025-10-25
473
- - Added smart staging checks before commit, and made `continue_workflow` auto-run the next action in the commit phase.
474
- - Enabled clean-tree commits to utilize `commit_and_push` and `perform_release` without manual staging.
475
- - Clarified documentation for the commit/push step.
476
-
477
- ## 1.0.11 — 2025-10-25
478
- - Added contextual "continue workflow" guidance describing the next recommended tool.
479
- - Blocked releases until commits are safely pushed.
480
-
481
- ## 1.0.10 — 2025-10-24
482
- - Modularized the workflow server internals for maintainability.
483
- - Expanded automated tests around the release push flow.
484
-
485
- ## 1.0.9 — 2025-10-23
486
- - Documented how local workflow state is managed across projects.
487
-
488
- ## 1.0.8 — 2025-10-21
489
- - Added explicit workflows for skipping tests with justification and dropping tasks mid-flight.
490
-
491
- ## 1.0.7 — 2025-10-20
492
- - Version alignment update; no new functionality recorded.
493
-
494
- ## 1.0.6 — 2025-10-20
495
- - Strengthened release tests to ensure prerequisites are met before tagging.
496
-
497
- ## 1.0.5 — 2025-10-20
498
- - Updated tests around `workflowState` persistence and validation.
499
-
500
- ## 1.0.4 — 2025-10-20
501
- - Added an enforced release step after the ready check to ensure workflow order.
502
- - Improved Windows compatibility by quoting commit messages safely.
503
-
504
- ## 1.0.3 — 2025-10-20
505
- - Added a project `.gitignore` and clarified cross-platform installation steps.
506
-
507
- ## 1.0.2 — 2025-10-19
508
- - Hardened `run_tests` argument validation and normalized tool call arguments.
509
- - Expanded documentation around tool payload requirements.
510
-
511
- ## 1.0.1 — 2025-10-18
512
- - Configured release tooling to support semantic version tagging moving forward.
513
-
514
- ## 1.0.0 — 2025-10-18
515
- - Initial public release with the full MCP workflow (start → fix → tests → docs → commit → release → complete).
516
- - Launched project governance, contribution guidelines, and tooling scaffolding.
@@ -1,175 +0,0 @@
1
- # Dev Workflow Web Dashboard
2
-
3
- Learn how to start and use the Dev Workflow dashboard included with the MCP server. The dashboard exposes project history, summaries, and aggregates through a small Node.js service.
4
-
5
- ## Prerequisites
6
-
7
- Before launching the dashboard, confirm the following:
8
-
9
- - Node.js 18+ installed (same requirement as the MCP server)
10
- - Project dependencies installed with `npm install`
11
- - Workflow history stored under `.state/` (created automatically when using the MCP server)
12
-
13
- > **Plesk users:** follow the [Plesk installation guide](../README.md#option-3-install-on-plesk-hosting) first and ensure SSH access is enabled.
14
-
15
- ## Features
16
-
17
- - **Task history browser** – Paginated list of completed workflow entries.
18
- - **Summary stats** – Counts of tasks by type and recent activity timeline.
19
- - **Aggregated trends** – Daily, monthly, or yearly breakdowns of workflow activity.
20
- - **Multi-user support** – Switch between user identifiers recorded in the `.state` directory.
21
-
22
- ## Getting Started
23
-
24
- Launch the dashboard from your project directory:
25
-
26
- ```bash
27
- npm run web
28
- ```
29
-
30
- When the server is ready you will see:
31
-
32
- ```
33
- 🌐 Dev Workflow Dashboard running at http://localhost:3111
34
- ```
35
-
36
- Open the URL in your browser. If port 3111 is in use, the script automatically selects a nearby free port.
37
-
38
- ### Choosing a Port
39
-
40
- Set `DEV_WORKFLOW_WEB_PORT` to force a specific port:
41
-
42
- ```bash
43
- DEV_WORKFLOW_WEB_PORT=5000 npm run web
44
- ```
45
-
46
- ### Selecting a User
47
-
48
- The dashboard defaults to the `default` user. Append `?user=<USER_ID>` to view another user’s data. User IDs map to the subdirectories under `.state/users/`.
49
-
50
- ```
51
- http://localhost:3111/?user=my-teammate
52
- ```
53
-
54
- ## Navigation
55
-
56
- The HTML frontend lives in `web/index.html`. The default UI includes:
57
-
58
- - **Summary cards** – Total tasks completed and last active date.
59
- - **Recent tasks table** – Paginated entries with task descriptions and timestamps.
60
- - **Charts** (if script extensions are enabled) – Visual trends per frequency selection.
61
-
62
- ## API Reference
63
-
64
- Interact with the dashboard programmatically using the JSON endpoints served by `web/server.js`.
65
-
66
- ### `GET /api/summary`
67
-
68
- Returns aggregate statistics for a user.
69
-
70
- **Query parameters**
71
-
72
- - `user` *(optional, string)* – User identifier (default `default`).
73
-
74
- **Response**
75
-
76
- ```json
77
- {
78
- "summary": {
79
- "totalTasks": 12,
80
- "taskTypes": { "feature": 8, "bugfix": 3, "refactor": 1 },
81
- "lastActive": "2025-10-01T09:25:41.123Z",
82
- "recentTasks": [
83
- { "description": "feat: add billing webhooks", "type": "feature", "timestamp": "2025-10-01T09:25:41.123Z" }
84
- ],
85
- "updatedAt": "2025-10-01T09:30:00.000Z"
86
- }
87
- }
88
- ```
89
-
90
- ### `GET /api/history`
91
-
92
- Returns paginated task history.
93
-
94
- **Query parameters**
95
-
96
- - `user` *(optional, string)* – User identifier (default `default`).
97
- - `page` *(optional, number)* – Page number (default `1`).
98
- - `pageSize` *(optional, number)* – Items per page (default `20`, max `100`).
99
- - `startDate` *(optional, string)* – Filter by ISO date (inclusive).
100
- - `endDate` *(optional, string)* – Filter by ISO date (inclusive).
101
-
102
- **Response**
103
-
104
- ```json
105
- {
106
- "entries": [
107
- {
108
- "id": 42,
109
- "user_id": "default",
110
- "task_description": "feat: add reporting endpoint",
111
- "task_type": "feature",
112
- "commit_message": "feat: add reporting endpoint",
113
- "timestamp": "2025-09-30T09:18:00.000Z"
114
- }
115
- ],
116
- "total": 42,
117
- "page": 1,
118
- "pageSize": 20
119
- }
120
- ```
121
-
122
- ### `GET /api/history-summary`
123
-
124
- Returns an array of task counts grouped by period.
125
-
126
- **Query parameters**
127
-
128
- - `user` *(optional, string)* – User identifier (default `default`).
129
- - `frequency` *(optional, string)* – `daily`, `monthly`, or `yearly` (default `daily`).
130
- - `startDate`, `endDate` *(optional, string)* – Limit range by ISO dates.
131
-
132
- **Response**
133
-
134
- ```json
135
- {
136
- "summary": [
137
- { "period": "2025-09-30", "count": 3 },
138
- { "period": "2025-09-29", "count": 1 }
139
- ]
140
- }
141
- ```
142
-
143
- ## Configuration
144
-
145
- | Variable | Description | Default |
146
- | --- | --- | --- |
147
- | `DEV_WORKFLOW_WEB_PORT` | Port for the dashboard | `3111` or next available |
148
- | `DEV_WORKFLOW_USER_ID` | User identifier when launching via MCP | auto-generated |
149
- | `DEV_WORKFLOW_STATE_FILE` | Overrides path to workflow state JSON | auto-detected |
150
-
151
- ## Troubleshooting
152
-
153
- | Symptom | Fix |
154
- | --- | --- |
155
- | Server fails with `better-sqlite3` build error | Install Python 3 and build tools (Windows) or ensure SQLite build dependencies exist (Linux/macOS). |
156
- | Dashboard shows empty data | Confirm the MCP server has generated `.state/users/<user>/workflow-state.json` and that the chosen `user` matches. |
157
- | Port already in use | Set `DEV_WORKFLOW_WEB_PORT` to a free port before running `npm run web`. |
158
-
159
- ## Deployment Options
160
-
161
- The web dashboard can be deployed in multiple ways:
162
-
163
- | Platform | Database Support | Best For |
164
- | --- | --- | --- |
165
- | Local (`npm run web`) | Full SQLite | Development and personal use |
166
- | [Netlify](./NETLIFY_DEPLOYMENT.md) | Static only | Public documentation site |
167
- | [Plesk](./PLESK_DEPLOYMENT.md) | Full SQLite | Self-hosted production |
168
-
169
- ## Related Topics
170
-
171
- - [Main README](../README.md)
172
- - [Netlify Deployment](./NETLIFY_DEPLOYMENT.md)
173
- - [Plesk Deployment](./PLESK_DEPLOYMENT.md)
174
- - [Workflow State Internals](./state.md) *(coming soon)*
175
- - [CLI Tools](../README.md#🛠️-available-tools)
@@ -1,8 +0,0 @@
1
- /** @type {import('tailwindcss').Config} */
2
- module.exports = {
3
- content: ["./web/public/**/*.{html,js}"],
4
- theme: {
5
- extend: {},
6
- },
7
- plugins: [],
8
- }