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

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.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)
 
 

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:

package/docs/product/PRD.md

@@ -35,6 +35,7 @@ Developers need structured guidance to maintain disciplined workflows across pro
 - Offer aggregated project summaries (JSON artifacts, SQLite sync, optional web dashboard).
 - Guard release commands to ensure prerequisites are satisfied.
 - Support `run_full_workflow` for scripted execution of all steps with validation.
+- Web dashboard displays version dynamically from `package.json` via `/api/version` endpoint to stay in sync after releases.
 
 ## 8. Technical Considerations
 - Node.js (ESM) codebase leveraging `@modelcontextprotocol/sdk`.

package/docs/release-notes/RELEASE_NOTES.md

@@ -4,6 +4,28 @@ Authoritative history of user-visible changes for the Development Workflow MCP S
 
 ## Unreleased
 
+## 1.4.5 — 2025-11-27 — 🐛 Bug Fixes
+- display dynamic version in web dashboard from /api/version (69f561d)
+
+## 1.4.4 — 2025-11-27 — ♻️ Refactors
+- consolidate workflow state to root .state folder only (3d69a14)
+- ensure release guard uses freshest workflow state (e07eb42)
+- remove invalid turbopack experimental config from next.config.ts (af0a7ea)
+- **web:** configure next.js root to silence warnings (22ed002)
+- **web:** improve mobile layout for hero section (53b26bf)
+- add Plesk deployment guide (de35675)
+- add 1.4.3 release notes (8b165f7)
+- fix release state detection (ed5dfd1)
+- prepare for release (a6ea2d0)
+- **release:** 1.4.2 (fac8999)
+- **release:** 1.4.2 🚀 (01b0b3c)
+- **release:** 1.4.3 🚀 (04d8c3b)
+- update task list (35663dd)
+- **web:** fix next.js lockfile warning (05ffce0)
+- add core doc types (PRD/README/RELEASE_NOTES) and fix CI build (8ed0567)
+- update hero text and meta description to emphasize Indonesian programmer community (681547b)
+- update program tracks and fix fast refresh warning (aa5bc9c)
+
 ## 1.4.3 — 2025-11-27 — 🧹 Chores
 - **release:** 1.4.2 (fac8999)
 - remove invalid turbopack experimental config from next.config.ts (af0a7ea)

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@programinglive/dev-workflow-mcp-server",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "description": "MCP server to enforce development workflow discipline",
   "homepage": "https://devworkflow.programinglive.com/",
+  "mcpName": "io.github.programinglive/dev-workflow-mcp-server",
   "type": "module",
   "main": "index.js",
   "bin": {

package/server.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
+  "name": "io.github.programinglive/dev-workflow-mcp-server",
+  "description": "MCP server to enforce development workflow discipline",
+  "version": "1.4.6",
+  "packages": [
+    {
+      "registry_type": "npm",
+      "identifier": "@programinglive/dev-workflow-mcp-server",
+      "version": "1.4.6"
+    }
+  ]
+}

package/tests/build.test.js

@@ -46,3 +46,16 @@ test('build script exists in package.json', async () => {
   assert.strictEqual(typeof pkg.scripts['build:server'], 'string');
   assert(pkg.scripts['build:server'].includes('vite build'));
 });
+
+test('Hero component fetches version dynamically', async () => {
+  const heroPath = path.join(process.cwd(), 'web', 'components', 'Hero.tsx');
+  const heroContent = await readFile(heroPath, 'utf-8');
+
+  // Verify no hardcoded version strings
+  assert(!heroContent.includes('v1.3.12'), 'Hero should not have hardcoded v1.3.12');
+  assert(!heroContent.includes('"1.3.12"'), 'Hero should not have hardcoded "1.3.12"');
+
+  // Verify it fetches from /api/version
+  assert(heroContent.includes('fetch("/api/version")'), 'Hero should fetch version from API');
+  assert(heroContent.includes('useState<string | null>(null)'), 'Hero should have version state');
+});

package/tests/mcpRegistry.test.js

@@ -0,0 +1,55 @@
+import { test } from "node:test";
+import assert from "node:assert";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+
+const projectRoot = process.cwd();
+
+async function readJson(relativePath) {
+  const fullPath = path.join(projectRoot, relativePath);
+  const content = await readFile(fullPath, "utf-8");
+  return JSON.parse(content);
+}
+
+test("package.json includes mcpName for MCP registry", async () => {
+  const pkg = await readJson("package.json");
+
+  assert.strictEqual(
+    pkg.mcpName,
+    "io.github.programinglive/dev-workflow-mcp-server",
+    "package.json should declare mcpName matching the MCP server namespace",
+  );
+});
+
+test("server.json is configured for npm package deployment", async () => {
+  const server = await readJson("server.json");
+
+  assert.strictEqual(
+    server.name,
+    "io.github.programinglive/dev-workflow-mcp-server",
+    "server.json name should match the MCP server namespace",
+  );
+
+  assert.ok(Array.isArray(server.packages) && server.packages.length > 0,
+    "server.json should declare at least one package entry",
+  );
+
+  const npmPkg = server.packages[0];
+
+  assert.strictEqual(
+    npmPkg.registry_type,
+    "npm",
+    "First server.json package entry should use npm registry_type",
+  );
+
+  assert.strictEqual(
+    npmPkg.identifier,
+    "@programinglive/dev-workflow-mcp-server",
+    "server.json npm identifier should match the published npm package name",
+  );
+
+  assert.ok(
+    typeof npmPkg.version === "string" && npmPkg.version.length > 0,
+    "server.json npm package version should be a non-empty string",
+  );
+});

package/web/components/Hero.tsx

@@ -7,12 +7,18 @@ import { useEffect, useState } from "react";
 
 export default function Hero() {
     const [downloads, setDownloads] = useState<number | null>(null);
+    const [version, setVersion] = useState<string | null>(null);
 
     useEffect(() => {
         fetch("/api/npm-downloads")
             .then(res => res.json())
             .then(data => setDownloads(data.downloads))
             .catch(() => setDownloads(null));
+
+        fetch("/api/version")
+            .then(res => res.json())
+            .then(data => setVersion(data.version))
+            .catch(() => setVersion(null));
     }, []);
 
     const formatDownloads = (num: number) => {
@@ -30,7 +36,7 @@ export default function Hero() {
                     <div className="animate-fade-in-up" style={{ animationDelay: "0.1s" }}>
                         <div className="inline-flex items-center gap-2 px-3 py-1.5 rounded-full bg-emerald-500/10 border border-emerald-500/20 text-emerald-400 text-sm mb-8">
                             <span className="w-1.5 h-1.5 rounded-full bg-emerald-500 animate-pulse"></span>
-                            <span>v1.3.12 - Active</span>
+                            <span>v{version ?? "..."} - Active</span>
                         </div>
                     </div>
 
@@ -51,7 +57,7 @@ export default function Hero() {
                     </div>
                     <div className="flex flex-wrap gap-6 sm:gap-8 text-sm animate-fade-in-up" style={{ animationDelay: "0.5s" }}>
                         <div>
-                            <div className="text-2xl font-bold">1.3.12</div>
+                            <div className="text-2xl font-bold">{version ?? "..."}</div>
                             <div className="text-gray-500">Latest Version</div>
                         </div>
                         <div>