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

package/.github/workflows/npm-publish.yml

@@ -31,6 +31,9 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Install web dependencies
+        run: npm ci --prefix web
+
       - name: Build package
         run: npm run build
 

package/CHANGELOG.md

@@ -2,14 +2,263 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-## [1.5.0](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.0...v1.5.0) (2025-11-22)
+### [1.5.1](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.5.0...v1.5.1) (2025-12-02)
 
-## [1.4.0](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.3.9...v1.4.0) (2025-11-22)
+
+### 🏗️ Build System
+
+* add netlify.toml for static site deployment ([8667537](https://github.com/programinglive/dev-workflow-mcp-server/commit/8667537baf16889b830c46d3ffde5770589f868f))
+
+
+### ✨ Features
+
+* add Netlify deployment support for web dashboard ([c05a791](https://github.com/programinglive/dev-workflow-mcp-server/commit/c05a791b3dac12d708e971061c48d3783733f985))
+
+
+### 📝 Documentation
+
+* update generated web-dashboard.html ([96d47a5](https://github.com/programinglive/dev-workflow-mcp-server/commit/96d47a52a658b105d4d094e18156a8cfc2d13854))
+* update release notes for 1.5.0 ([d860460](https://github.com/programinglive/dev-workflow-mcp-server/commit/d860460826d179e94524807b1776f60854c1db4c))
+
+## [1.5.0](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.6...v1.5.0) (2025-12-02)
+
+
+### ♻️ Refactors
+
+* **dashboard:** combine analytics charts and use local Chart.js ([86ed3f4](https://github.com/programinglive/dev-workflow-mcp-server/commit/86ed3f4a88570b2f580cb1408e459da681288254))
+
+
+### ✨ Features
+
+* **dashboard:** implement random data generation for analytics chart ([17e2073](https://github.com/programinglive/dev-workflow-mcp-server/commit/17e20737b719392a2bd90cb1a6f4cc6084b54ab5))
+
+
+### 🐛 Bug Fixes
+
+* **dashboard:** improve responsive layout for admin stats cards ([33d5b39](https://github.com/programinglive/dev-workflow-mcp-server/commit/33d5b3929ffda733d2328d1e9214c17c1e3d2b40))
+* **dashboard:** improve responsive layout for admin stats cards ([530400d](https://github.com/programinglive/dev-workflow-mcp-server/commit/530400d6ce266d151c617b4b2c7ea56cb1b15042))
+* move build dependencies to dependencies section ([701b07c](https://github.com/programinglive/dev-workflow-mcp-server/commit/701b07c91d31007bc63899a8ddd6350773d4704f))
+* move dompdf to require and resolve debugbar production error ([e5d1cb6](https://github.com/programinglive/dev-workflow-mcp-server/commit/e5d1cb68f70f0980fbbd69f914b76bf0fb09af18))
+* move vite to dependencies to ensure build works on production ([62fc4c0](https://github.com/programinglive/dev-workflow-mcp-server/commit/62fc4c0fecf3ef4cfce231a2663bc67d34668c25))
+* resolve sentry permission issues ([c739f8e](https://github.com/programinglive/dev-workflow-mcp-server/commit/c739f8e2bc5b99d70d63dbc66cefc3fa3b187651))
+
+
+### 🧹 Chores
+
+* align MCP registry schema and docs ([e4e732d](https://github.com/programinglive/dev-workflow-mcp-server/commit/e4e732d6149a63ddf327ffb741f94d90103c903b))
+* **release:** 1.4.10 🚀 ([74fa5c1](https://github.com/programinglive/dev-workflow-mcp-server/commit/74fa5c11e44bf9c3b29981314c4d13469691fab2))
+* **release:** 1.4.11 🚀 ([28c7a62](https://github.com/programinglive/dev-workflow-mcp-server/commit/28c7a62422d247369ea6652d0bf31b874534a1e4))
+* **release:** 1.4.7 🚀 ([ab4c218](https://github.com/programinglive/dev-workflow-mcp-server/commit/ab4c2184a4fe5e410f54d3723af247ecb0d06f28))
+* **release:** 1.4.8 🚀 ([b60681b](https://github.com/programinglive/dev-workflow-mcp-server/commit/b60681b801be01919711302be38fb6e576f99a8b))
+* **release:** 1.4.9 🚀 ([3f73564](https://github.com/programinglive/dev-workflow-mcp-server/commit/3f73564197068b6a055d36df560322150c0ba6b4))
+* remove web-legacy ([5f0d29e](https://github.com/programinglive/dev-workflow-mcp-server/commit/5f0d29e087918e6891b7e41aa58e262c710d4a67))
+
+
+### 📝 Documentation
+
+* update release notes html for 1.4.11 ([e683ab6](https://github.com/programinglive/dev-workflow-mcp-server/commit/e683ab6b06bfd5bbcc2dbd6441c9d121bec74feb))
+
+### [1.4.11](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.10...v1.4.11) (2025-12-01)
+
+
+### 🐛 Bug Fixes
+
+* move vite to dependencies to ensure build works on production ([62fc4c0](https://github.com/programinglive/dev-workflow-mcp-server/commit/62fc4c0fecf3ef4cfce231a2663bc67d34668c25))
+* resolve sentry permission issues ([c739f8e](https://github.com/programinglive/dev-workflow-mcp-server/commit/c739f8e2bc5b99d70d63dbc66cefc3fa3b187651))
+
+### [1.4.10](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.9...v1.4.10) (2025-12-01)
+
+
+### ✨ Features
+
+* **dashboard:** implement random data generation for analytics chart ([17e2073](https://github.com/programinglive/dev-workflow-mcp-server/commit/17e20737b719392a2bd90cb1a6f4cc6084b54ab5))
+
+
+### 🐛 Bug Fixes
+
+* move dompdf to require and resolve debugbar production error ([e5d1cb6](https://github.com/programinglive/dev-workflow-mcp-server/commit/e5d1cb68f70f0980fbbd69f914b76bf0fb09af18))
+
+### [1.4.9](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.8...v1.4.9) (2025-11-30)
+
+
+### ♻️ Refactors
+
+* **dashboard:** combine analytics charts and use local Chart.js ([86ed3f4](https://github.com/programinglive/dev-workflow-mcp-server/commit/86ed3f4a88570b2f580cb1408e459da681288254))
+
+### [1.4.8](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.7...v1.4.8) (2025-11-30)
+
+
+### 🐛 Bug Fixes
+
+* **dashboard:** improve responsive layout for admin stats cards ([33d5b39](https://github.com/programinglive/dev-workflow-mcp-server/commit/33d5b3929ffda733d2328d1e9214c17c1e3d2b40))
+* **dashboard:** improve responsive layout for admin stats cards ([530400d](https://github.com/programinglive/dev-workflow-mcp-server/commit/530400d6ce266d151c617b4b2c7ea56cb1b15042))
+
+### [1.4.7](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.3...v1.4.7) (2025-11-29)
+
+
+### ✨ Features
+
+* add core doc types (PRD/README/RELEASE_NOTES) and fix CI build ([8ed0567](https://github.com/programinglive/dev-workflow-mcp-server/commit/8ed0567e8de772b95de6fb744a936b07ed3e1c32))
+* update hero text and meta description to emphasize Indonesian programmer community ([681547b](https://github.com/programinglive/dev-workflow-mcp-server/commit/681547b764b2fcf3a874cc637d9653c12bf62640))
+
+
+### 🐛 Bug Fixes
+
+* display dynamic version in web dashboard from /api/version ([69f561d](https://github.com/programinglive/dev-workflow-mcp-server/commit/69f561d369fa8347399fafe5dcdb3a2dbb485064))
+
+
+### 🧹 Chores
+
+* add 1.4.3 release notes ([8b165f7](https://github.com/programinglive/dev-workflow-mcp-server/commit/8b165f7a8201f6b8484dce60f3f907cb195abb83))
+* add MCP registry metadata (mcpName & server.json) ([66caea1](https://github.com/programinglive/dev-workflow-mcp-server/commit/66caea1d684473cfc916917faa42e16fc4ad9e14))
+* align MCP registry schema and docs ([e4e732d](https://github.com/programinglive/dev-workflow-mcp-server/commit/e4e732d6149a63ddf327ffb741f94d90103c903b))
+* **release:** 1.4.4 🚀 ([05a968f](https://github.com/programinglive/dev-workflow-mcp-server/commit/05a968fd08ca41e50d324893d993cb5117b2575c))
+* **release:** 1.4.5 🚀 ([7e823b9](https://github.com/programinglive/dev-workflow-mcp-server/commit/7e823b993c04c5372b4c6acbdf58c713458e8881))
+* **release:** 1.4.6 🚀 ([7e0b672](https://github.com/programinglive/dev-workflow-mcp-server/commit/7e0b67208756b2e6bb34f61ff0382022979b294e))
+
+### [1.4.6](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.5...v1.4.6) (2025-11-27)
+
+
+### 🧹 Chores
+
+* add MCP registry metadata (mcpName & server.json) ([66caea1](https://github.com/programinglive/dev-workflow-mcp-server/commit/66caea1d684473cfc916917faa42e16fc4ad9e14))
+
+### [1.4.5](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.4...v1.4.5) (2025-11-27)
+
+
+### 🐛 Bug Fixes
+
+* display dynamic version in web dashboard from /api/version ([69f561d](https://github.com/programinglive/dev-workflow-mcp-server/commit/69f561d369fa8347399fafe5dcdb3a2dbb485064))
+
+### [1.4.4](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.1...v1.4.4) (2025-11-27)
 
 
 ### ♻️ Refactors
 
-* **web:** move static files to public/ subdirectory for Plesk security ([f68c6b6](https://github.com/programinglive/dev-workflow-mcp-server/commit/f68c6b6321fa85e9537f8592dfcbc8fb718f77c4))
+* consolidate workflow state to root .state folder only ([3d69a14](https://github.com/programinglive/dev-workflow-mcp-server/commit/3d69a14e2abd7897bc91ede5e3c484b90eefc726))
+
+
+### 🐛 Bug Fixes
+
+* ensure release guard uses freshest workflow state ([e07eb42](https://github.com/programinglive/dev-workflow-mcp-server/commit/e07eb42179f17f2da282bff70392ce1b4652346a))
+* remove invalid turbopack experimental config from next.config.ts ([af0a7ea](https://github.com/programinglive/dev-workflow-mcp-server/commit/af0a7ea7906654755a2520693fd81d7fb6633c13))
+* **web:** configure next.js root to silence warnings ([22ed002](https://github.com/programinglive/dev-workflow-mcp-server/commit/22ed00256a4c6d7dbca13d2733baf0f4392b6650))
+* **web:** improve mobile layout for hero section ([53b26bf](https://github.com/programinglive/dev-workflow-mcp-server/commit/53b26bf3271cab3ac029be8ddb72a8d5312b150e))
+
+
+### 📝 Documentation
+
+* add Plesk deployment guide ([de35675](https://github.com/programinglive/dev-workflow-mcp-server/commit/de356753231d1bb29fd3c87fdd9d095932fae4b0))
+
+
+### 🧹 Chores
+
+* add 1.4.3 release notes ([8b165f7](https://github.com/programinglive/dev-workflow-mcp-server/commit/8b165f7a8201f6b8484dce60f3f907cb195abb83))
+* fix release state detection ([ed5dfd1](https://github.com/programinglive/dev-workflow-mcp-server/commit/ed5dfd15d296c555bd5c2731267a87ad4a371af9))
+* prepare for release ([a6ea2d0](https://github.com/programinglive/dev-workflow-mcp-server/commit/a6ea2d0c44f35f2a1e06c4e01bbe026177e9cff2))
+* **release:** 1.4.2 ([fac8999](https://github.com/programinglive/dev-workflow-mcp-server/commit/fac899992d370c0198954a6f7c97ab7645514e25))
+* **release:** 1.4.2 🚀 ([01b0b3c](https://github.com/programinglive/dev-workflow-mcp-server/commit/01b0b3c791c10b76c05bae01e4e8c5ce7435ce14))
+* **release:** 1.4.3 🚀 ([04d8c3b](https://github.com/programinglive/dev-workflow-mcp-server/commit/04d8c3b2873ce819633c95a12f6c48e73fe671ea))
+* update task list ([35663dd](https://github.com/programinglive/dev-workflow-mcp-server/commit/35663dd661d3b97a5fedb5013fbbca36e75605d8))
+* **web:** fix next.js lockfile warning ([05ffce0](https://github.com/programinglive/dev-workflow-mcp-server/commit/05ffce0b171cb804c6a14223521cd1fa876b80ae))
+
+
+### ✨ Features
+
+* add core doc types (PRD/README/RELEASE_NOTES) and fix CI build ([8ed0567](https://github.com/programinglive/dev-workflow-mcp-server/commit/8ed0567e8de772b95de6fb744a936b07ed3e1c32))
+* update hero text and meta description to emphasize Indonesian programmer community ([681547b](https://github.com/programinglive/dev-workflow-mcp-server/commit/681547b764b2fcf3a874cc637d9653c12bf62640))
+* update program tracks and fix fast refresh warning ([aa5bc9c](https://github.com/programinglive/dev-workflow-mcp-server/commit/aa5bc9cbc8a9bf9c9552e00e89b0b97ddeac0592))
+
+### [1.4.3](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.2...v1.4.3) (2025-11-27)
+
+
+### 🧹 Chores
+
+* **release:** 1.4.2 ([fac8999](https://github.com/programinglive/dev-workflow-mcp-server/commit/fac899992d370c0198954a6f7c97ab7645514e25))
+
+
+### 🐛 Bug Fixes
+
+* remove invalid turbopack experimental config from next.config.ts ([af0a7ea](https://github.com/programinglive/dev-workflow-mcp-server/commit/af0a7ea7906654755a2520693fd81d7fb6633c13))
+
+
+### 📝 Documentation
+
+* add Plesk deployment guide ([de35675](https://github.com/programinglive/dev-workflow-mcp-server/commit/de356753231d1bb29fd3c87fdd9d095932fae4b0))
+
+
+### ✨ Features
+
+* update program tracks and fix fast refresh warning ([aa5bc9c](https://github.com/programinglive/dev-workflow-mcp-server/commit/aa5bc9cbc8a9bf9c9552e00e89b0b97ddeac0592))
+
+### [1.4.2](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.1...v1.4.2) (2025-11-27)
+
+
+### 🧹 Chores
+
+* fix release state detection ([ed5dfd1](https://github.com/programinglive/dev-workflow-mcp-server/commit/ed5dfd15d296c555bd5c2731267a87ad4a371af9))
+* prepare for release ([a6ea2d0](https://github.com/programinglive/dev-workflow-mcp-server/commit/a6ea2d0c44f35f2a1e06c4e01bbe026177e9cff2))
+* update task list ([35663dd](https://github.com/programinglive/dev-workflow-mcp-server/commit/35663dd661d3b97a5fedb5013fbbca36e75605d8))
+* **web:** fix next.js lockfile warning ([05ffce0](https://github.com/programinglive/dev-workflow-mcp-server/commit/05ffce0b171cb804c6a14223521cd1fa876b80ae))
+
+
+### 🐛 Bug Fixes
+
+* ensure release guard uses freshest workflow state ([e07eb42](https://github.com/programinglive/dev-workflow-mcp-server/commit/e07eb42179f17f2da282bff70392ce1b4652346a))
+* **web:** configure next.js root to silence warnings ([22ed002](https://github.com/programinglive/dev-workflow-mcp-server/commit/22ed00256a4c6d7dbca13d2733baf0f4392b6650))
+* **web:** improve mobile layout for hero section ([53b26bf](https://github.com/programinglive/dev-workflow-mcp-server/commit/53b26bf3271cab3ac029be8ddb72a8d5312b150e))
+
+
+### ♻️ Refactors
+
+* consolidate workflow state to root .state folder only ([3d69a14](https://github.com/programinglive/dev-workflow-mcp-server/commit/3d69a14e2abd7897bc91ede5e3c484b90eefc726))
+
+### [1.4.1](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.4.0...v1.4.1) (2025-11-27)
+
+
+### 🐛 Bug Fixes
+
+* update build test to include postbuild ([b1e2f48](https://github.com/programinglive/dev-workflow-mcp-server/commit/b1e2f481334df825109e3f2934c88b8f14c1b4d0))
+
+
+### ✨ Features
+
+* add custom server.js for Plesk ([b3912cd](https://github.com/programinglive/dev-workflow-mcp-server/commit/b3912cdaf50085ae30cab553a9ebac2b7281ee28))
+
+## [1.4.0](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.3.12...v1.4.0) (2025-11-26)
+
+
+### ✨ Features
+
+* migrate dashboard to Next.js with TypeScript and Tailwind CSS ([bce1fec](https://github.com/programinglive/dev-workflow-mcp-server/commit/bce1fec98a7b5e5542644271a77ccaf1019dd83c))
+
+
+### 🧹 Chores
+
+* fix package.json scripts ([fb25e98](https://github.com/programinglive/dev-workflow-mcp-server/commit/fb25e98c763d4b5cac5c321f56a2e533577fc38b))
+* fix tsconfig and remove dist artifact ([282759f](https://github.com/programinglive/dev-workflow-mcp-server/commit/282759f14de6231ad6374dc891b551ca0d70ac28))
+
+### [1.3.12](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.3.11...v1.3.12) (2025-11-22)
+
+
+### 🐛 Bug Fixes
+
+* **scripts:** update release notes script and backfill versions ([808791e](https://github.com/programinglive/dev-workflow-mcp-server/commit/808791ec4a988fe557fa82be21fb92f6a34d792c))
+* **scripts:** update release notes script to support header format and backfill versions ([e4a5055](https://github.com/programinglive/dev-workflow-mcp-server/commit/e4a5055633ba4d83d43c85ee8b475cd761685519))
+
+### [1.3.11](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.3.10...v1.3.11) (2025-11-22)
+
+
+### ♻️ Refactors
+
+* **web:** move static files to public/ subdirectory for Plesk security ([3e5c321](https://github.com/programinglive/dev-workflow-mcp-server/commit/3e5c321d569e3594d9f29c8762513b95df8dbd84))
+
+### [1.3.10](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.3.9...v1.3.10) (2025-11-22)
+
+
+### 📝 Documentation
+
+* add workflow best practices to eliminate forced releases ([6bcac42](https://github.com/programinglive/dev-workflow-mcp-server/commit/6bcac42bc9f30cbfa0a27e36a90af303d244d863))
 
 ### [1.3.9](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.3.8...v1.3.9) (2025-11-22)
 

package/README.md

@@ -205,6 +205,7 @@ npm run web
 - **Environment overrides:** Honors `PORT` (common on hosts like Plesk/Render) or `DEV_WORKFLOW_WEB_PORT` before falling back to auto-selection.
 - **Query parameter:** `?user=<id>` lets you inspect another user’s history (defaults to `default`).
 - **API endpoints:**
+  - `GET /api/version` → current package version from `package.json` (used by dashboard to display version dynamically).
   - `GET /api/summary?user=<id>` → overall stats for the user.
   - `GET /api/history?user=<id>&page=1&pageSize=20&startDate=YYYY-MM-DD&endDate=YYYY-MM-DD` → paginated task history.
   - `GET /api/history-summary?user=<id>&frequency=daily|monthly|yearly` → aggregated counts over time.
@@ -227,6 +228,28 @@ For MCP server usage, point your client at `index.js` (source) to avoid stdio tr
 - Performance optimization
 - Embedding in other projects
 
+### MCP Tools Registry (Publishing)
+
+This package is configured for the official MCP Tools Registry using **npm package deployment**:
+
+- `package.json` declares `mcpName: "io.github.programinglive/dev-workflow-mcp-server"`.
+- `server.json` describes the server and links it to the npm package `@programinglive/dev-workflow-mcp-server`.
+
+To publish a new server version to the registry:
+
+1. Release a new npm version (for example):
+   - `npm test`
+   - `npm run release:patch` (runs your existing release pipeline and publishes to npm)
+2. Verify the new version exists on npm:
+   - `npm view @programinglive/dev-workflow-mcp-server version`
+3. Install the MCP publisher CLI (once per machine):
+   - `brew install mcp-publisher` (or follow the docs at https://modelcontextprotocol.info/tools/registry/publishing/)
+4. From this repo root, authenticate and publish:
+   - `mcp-publisher login github`
+   - `mcp-publisher publish`
+5. Optionally verify in the registry:
+   - `curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.programinglive/dev-workflow-mcp-server"`
+
 #### PowerShell CLI tip
 
 When invoking the lightweight CLI from PowerShell, use `--%` to prevent PowerShell from rewriting JSON arguments, for example:
@@ -431,7 +454,7 @@ Use run_tests with:
 Mark that documentation has been created/updated. This is required before committing.
 
 **Parameters:**
-- `documentationType` (enum, required): "README", "inline-comments", "API-docs", "changelog", or "other"
+- `documentationType` (enum, required): "PRD", "README", "RELEASE_NOTES", "inline-comments", "API-docs", "changelog", or "other"
 - `summary` (string, required): What was documented
 
 ### `check_ready_to_commit`

package/docs/NETLIFY_DEPLOYMENT.md

@@ -0,0 +1,125 @@
+# Netlify Deployment Guide
+
+Deploy the Dev Workflow web dashboard to Netlify for a public-facing documentation and demo site.
+
+## Overview
+
+The web dashboard can be deployed to Netlify as a static Next.js application. This deployment mode provides:
+
+- **Static documentation pages** - Full access to the `/docs` section
+- **Demo interface** - Showcase the workflow features
+- **API endpoints** - Serverless functions for version and npm download stats
+
+> **Note:** Database features (history, summary) return placeholder data in this deployment mode. For full functionality with persistent data, use the [local development server](./web-dashboard.md) or [Plesk deployment](./PLESK_DEPLOYMENT.md).
+
+## Live Site
+
+The official deployment is available at:
+- **Primary:** https://devworkflow.programinglive.com
+- **Netlify:** https://devworkflow.netlify.app
+
+## Prerequisites
+
+- Netlify account (free tier works)
+- Node.js 18+ for local builds
+- Git repository connected to Netlify (optional, for auto-deploy)
+
+## Quick Deploy
+
+### Option 1: Netlify CLI
+
+```bash
+# Install Netlify CLI
+npm install -g netlify-cli
+
+# Login to Netlify
+netlify login
+
+# Navigate to web directory
+cd web
+
+# Create new site and deploy
+netlify sites:create --name your-site-name
+netlify deploy --prod --build
+```
+
+### Option 2: Netlify Dashboard
+
+1. Go to [app.netlify.com](https://app.netlify.com)
+2. Click "Add new site" > "Import an existing project"
+3. Connect your GitHub repository
+4. Configure build settings:
+   - **Base directory:** `web`
+   - **Build command:** `npm run build`
+   - **Publish directory:** `.next`
+5. Deploy
+
+## Configuration
+
+The `web/netlify.toml` file configures the build:
+
+```toml
+[build]
+  command = "npm run build"
+  publish = ".next"
+
+[[plugins]]
+  package = "@netlify/plugin-nextjs"
+```
+
+## Custom Domain Setup
+
+1. Go to your site's **Domain management** in Netlify
+2. Click **Add a domain**
+3. Enter your subdomain (e.g., `devworkflow.yourdomain.com`)
+4. Add a CNAME record in your DNS provider:
+   - **Host:** `devworkflow` (or your subdomain)
+   - **Value:** `your-site-name.netlify.app`
+5. Click **Provision certificate** for HTTPS
+
+## API Endpoints
+
+The following API routes are available as Netlify Functions:
+
+| Endpoint | Description |
+| --- | --- |
+| `/api/version` | Returns current package version |
+| `/api/npm-downloads` | Returns monthly npm download count |
+| `/api/summary` | Returns placeholder summary data |
+| `/api/history` | Returns placeholder history data |
+| `/api/docs` | Returns documentation content |
+
+## Limitations
+
+When deployed to Netlify (static mode):
+
+- **No persistent database** - History and summary return empty/placeholder data
+- **No real-time updates** - Data is static between deployments
+- **Version is build-time** - Update `web/app/api/version/route.ts` before each release
+
+## Updating the Deployment
+
+### Manual Redeploy
+
+```bash
+cd web
+netlify deploy --prod --build
+```
+
+### Auto-Deploy (Recommended)
+
+Connect your GitHub repository to Netlify for automatic deployments on push to main branch.
+
+## Troubleshooting
+
+| Issue | Solution |
+| --- | --- |
+| 404 on custom domain | Provision SSL certificate in Netlify dashboard |
+| Build fails | Ensure `web/package.json` has no native dependencies |
+| Functions timeout | Netlify has 10s limit; optimize API routes |
+
+## Related
+
+- [Web Dashboard Guide](./web-dashboard.md)
+- [Plesk Deployment](./PLESK_DEPLOYMENT.md)
+- [Main README](../README.md)

package/docs/PLESK_DEPLOYMENT.md

@@ -0,0 +1,170 @@
+# Deploying dev-workflow-mcp-server to Plesk
+
+This guide covers deploying the dev-workflow MCP server (Node.js backend + Next.js frontend) to Plesk hosting.
+
+## Prerequisites
+
+- Plesk control panel access
+- Node.js 18+ installed on the server
+- Git installed on the server
+- Domain/subdomain configured in Plesk
+
+## Deployment Steps
+
+### 1. Set Up Node.js Application in Plesk
+
+1. Log in to Plesk control panel
+2. Go to **Domains** → Select your domain
+3. Click **Node.js** (or **Applications** if using newer Plesk)
+4. Click **Add Application**
+5. Configure:
+   - **Application root**: `/var/www/vhosts/yourdomain.com/dev-workflow-mcp-server` (or your path)
+   - **Startup file**: `index.js`
+   - **Node.js version**: 18.x or higher
+   - **Port**: Leave as auto (Plesk assigns a port)
+
+### 2. Clone Repository
+
+SSH into your Plesk server:
+
+```bash
+cd /var/www/vhosts/yourdomain.com
+git clone https://github.com/programinglive/dev-workflow-mcp-server.git
+cd dev-workflow-mcp-server
+```
+
+### 3. Install Dependencies
+
+```bash
+npm install
+```
+
+### 4. Build the Application
+
+```bash
+npm run build
+```
+
+This builds:
+- **Backend**: Vite bundle → `dist/index.mjs`
+- **Frontend**: Next.js static + server → `web/.next/`
+- **Docs**: HTML files → `dist/docs/`
+
+### 5. Configure Environment (if needed)
+
+Create `.env` file in the project root if you need custom settings:
+
+```bash
+# Example (adjust as needed)
+NODE_ENV=production
+PORT=3000
+```
+
+### 6. Start the Application
+
+In Plesk:
+1. Go back to **Node.js Applications**
+2. Find your application
+3. Click **Start** (or it may auto-start)
+
+Alternatively, via SSH:
+
+```bash
+npm start
+```
+
+### 7. Configure Reverse Proxy (Plesk)
+
+Plesk automatically sets up a reverse proxy. Verify:
+1. Go to **Domains** → Your domain → **Web Server Settings**
+2. Ensure **Proxy** is enabled
+3. Verify the proxy points to the Node.js app port
+
+### 8. Verify Deployment
+
+- Visit `https://yourdomain.com` → Should see the Next.js frontend
+- Visit `https://yourdomain.com/docs` → Should see documentation
+- Check browser console for any `_next/static` 500 errors
+
+If you see 500 errors on `_next/static` requests:
+- SSH to server and check logs: `tail -f /var/log/plesk/nodejs/yourdomain.com.log`
+- Ensure `.next` directory exists: `ls -la web/.next/`
+- Verify Node.js is running: `ps aux | grep node`
+
+### 9. Set Up Auto-Restart (Optional)
+
+In Plesk, the Node.js app should auto-restart on failure. To verify:
+1. Go to **Node.js Applications**
+2. Check **Restart policy** is set to auto-restart
+
+### 10. Enable HTTPS (Recommended)
+
+1. Go to **Domains** → Your domain → **SSL/TLS Certificates**
+2. Click **Install** (use Let's Encrypt free certificate)
+3. Plesk auto-redirects HTTP → HTTPS
+
+## Troubleshooting
+
+### `_next/static` returns 500
+
+**Cause**: Next.js build output not deployed or server crashed.
+
+**Fix**:
+```bash
+# SSH to server
+npm run build --prefix web
+npm start
+# Check logs
+tail -f /var/log/plesk/nodejs/yourdomain.com.log
+```
+
+### Application won't start
+
+**Check**:
+1. Node.js version: `node --version` (must be 18+)
+2. Dependencies: `npm install`
+3. Build output: `ls -la dist/` and `ls -la web/.next/`
+4. Logs: Check Plesk control panel logs
+
+### Port conflicts
+
+Plesk assigns ports automatically. If you get a port conflict:
+1. Go to **Node.js Applications** → Edit
+2. Let Plesk auto-assign a new port
+3. Restart the app
+
+## Updating the Application
+
+To deploy a new version:
+
+```bash
+cd /var/www/vhosts/yourdomain.com/dev-workflow-mcp-server
+git pull origin main
+npm install
+npm run build
+# Plesk will auto-restart the app
+```
+
+Or manually restart in Plesk control panel:
+1. **Node.js Applications** → Select app → **Restart**
+
+## Production Checklist
+
+- [ ] Node.js 18+ installed
+- [ ] `npm install` completed
+- [ ] `npm run build` succeeded (no errors)
+- [ ] `.next` directory exists with static files
+- [ ] HTTPS/SSL certificate installed
+- [ ] Reverse proxy configured
+- [ ] Application started and running
+- [ ] `https://yourdomain.com` loads without 500 errors
+- [ ] `_next/static` assets load correctly
+- [ ] Logs show no errors
+
+## Support
+
+For issues:
+1. Check Plesk logs: `/var/log/plesk/nodejs/`
+2. SSH and run `npm start` manually to see real-time errors
+3. Verify Node.js and npm versions
+4. Ensure all dependencies installed: `npm install`

package/docs/WORKFLOW-BEST-PRACTICES.md

@@ -0,0 +1,58 @@
+# Workflow Best Practices
+
+## Correct Release Workflow Order
+
+To avoid needing `--force` flag for releases, follow this exact order:
+
+1. **Start Task**: `mcp0_start_task`
+2. **Fix/Implement**: Make your code changes
+3. **Mark Fixed**: `mcp0_mark_bug_fixed`
+4. **Tests**: `mcp0_create_tests` + `mcp0_run_tests` (or `mcp0_skip_tests` with reason)
+5. **Documentation**: `mcp0_create_documentation`
+6. **Ready Check**: `mcp0_check_ready_to_commit`
+7. **Commit & Push**: `mcp0_commit_and_push`
+8. **Release**: `mcp0_perform_release` ⚠️ **MUST come BEFORE complete_task**
+9. **Complete**: `mcp0_complete_task`
+
+## Common Mistakes
+
+### ❌ Wrong Order (causes forced releases)
+```
+check_ready → commit → complete → release  // WRONG!
+```
+
+### ✅ Correct Order
+```
+check_ready → commit → release → complete  // CORRECT!
+```
+
+## Why This Matters
+
+- `complete_task` **resets the workflow state**
+- `perform_release` **checks the workflow state** before running
+- If you complete before releasing, the state is cleared and release guards fail
+- Using `--force` bypasses guards but doesn't fix the root cause
+
+## State Transitions
+
+1. After `commit_and_push`: `currentPhase = "release"`
+2. After `perform_release`: `currentPhase = "ready_to_complete"`, `released = true`
+3. After `complete_task`: State is reset to idle
+
+## Solution
+
+Always call `perform_release` BEFORE `complete_task`. Never use `--force` unless absolutely necessary.
+
+## Documentation Phase Expectations
+
+During the documentation step (`mcp0_create_documentation`), make sure the core project docs are created or updated as needed:
+
+1. `docs/product/PRD.md` – Product Requirements Document
+2. `README.md` – Project overview and usage
+3. `docs/release-notes/RELEASE_NOTES.md` – Release notes for changes in this task/version
+
+If one or more of these files already exist, **update them** instead of creating new variants. Use the `documentationType` argument to reflect what you touched:
+
+- `"PRD"` when you added/updated the PRD
+- `"README"` when you updated the main README
+- `"RELEASE_NOTES"` when you updated the release notes