@programinglive/dev-workflow-mcp-server 1.1.0 → 1.1.3

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 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.1.3](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.1.2...v1.1.3) (2025-10-25)
+
+
+### ✨ Features
+
+* make dev-workflow MCP installable with per-project workflow state isolation ([50e9ead](https://github.com/programinglive/dev-workflow-mcp-server/commit/50e9ead788f2bba1b0ff1a62515f3bcc78d0c8e6))
+
+### [1.1.2](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.1.1...v1.1.2) (2025-10-25)
+
+### [1.1.1](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.1.0...v1.1.1) (2025-10-25)
+
+
+### ✨ Features
+
+* add force_complete_task tool ([f731a7d](https://github.com/programinglive/dev-workflow-mcp-server/commit/f731a7d2e48295963b8573d4a2abd3ebd42ba5ab))
+
 ## [1.1.0](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.0.11...v1.1.0) (2025-10-25)
 
 

package/README.md

@@ -16,13 +16,25 @@ This MCP server guides you through a disciplined development workflow:
 
 ## 🚀 Installation
 
-### 1. Install Dependencies
+### Option 1: Install as Dependency in Your Project (Recommended)
+
+Each project gets its own isolated workflow state file.
+
+```bash
+npm install @programinglive/dev-workflow-mcp-server
+```
+
+This will automatically create a `.workflow-state.json` file in your project root, keeping workflow history separate per project.
+
+### Option 2: Install from Source
 
 ```bash
+git clone https://github.com/programinglive/dev-workflow-mcp-server.git
+cd dev-workflow-mcp-server
 npm install
 ```
 
-### 2. Configure in Windsurf/Claude Desktop
+### 3. Configure in Windsurf/Claude Desktop
 
 Point your MCP client to the server entry point. Replace `<PROJECT_ROOT>` with the absolute path to this repository on your machine.
 
@@ -112,10 +124,31 @@ Point your MCP client to the server entry point. Replace `<PROJECT_ROOT>` with t
 
 > **Note:** On Windows paths in JSON require escaped backslashes (e.g., `"C:\\path\\to\\project"`).
 
-### 3. Restart Windsurf/Claude Desktop
+### 4. Restart Windsurf/Claude Desktop
 
 After adding the configuration, restart the application to load the MCP server.
 
+## 📁 Project-Specific Workflow State
+
+When you install this package in a project, a `.workflow-state.json` file is automatically created in your project root. This file:
+
+- **Stores workflow history** specific to that project
+- **Tracks task progress** independently per project
+- **Should be gitignored** (already in `.gitignore` by default)
+- **Persists across sessions** so your workflow state is preserved
+
+Each project maintains its own isolated workflow history, so you can work on multiple projects without mixing their histories.
+
+### Adding to .gitignore
+
+If you're using this package, add this to your project's `.gitignore`:
+
+```
+.workflow-state.json
+```
+
+This keeps workflow state local to each developer's machine.
+
 ## 🛠️ Available Tools
 
 ### Tool Argument Requirements

package/install.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+/**
+ * Installation script for dev-workflow MCP server
+ * Sets up per-project workflow state file in the target project directory
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function install() {
+  try {
+    // Get the project root (where npm install was run)
+    const projectRoot = process.cwd();
+    const stateFile = path.join(projectRoot, '.workflow-state.json');
+
+    // Check if state file already exists
+    try {
+      await fs.access(stateFile);
+      console.log(`✓ Workflow state file already exists at ${stateFile}`);
+      return;
+    } catch {
+      // File doesn't exist, create it
+    }
+
+    // Create initial workflow state
+    const initialState = {
+      currentPhase: 'idle',
+      taskDescription: '',
+      bugFixed: false,
+      testsCreated: false,
+      testsPassed: false,
+      testsSkipped: false,
+      testsSkippedReason: '',
+      documentationCreated: false,
+      readyToCommit: false,
+      readyCheckCompleted: false,
+      released: false,
+      releaseCommand: '',
+      releaseNotes: '',
+      commitAndPushCompleted: false,
+      lastCommitMessage: '',
+      lastPushBranch: '',
+      history: [],
+    };
+
+    await fs.writeFile(stateFile, JSON.stringify(initialState, null, 2));
+    console.log(`✓ Created workflow state file at ${stateFile}`);
+    console.log(`✓ Each project now has its own isolated workflow history`);
+  } catch (error) {
+    console.error('✗ Installation failed:', error.message);
+    process.exit(1);
+  }
+}
+
+install();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@programinglive/dev-workflow-mcp-server",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "MCP server to enforce development workflow discipline",
   "type": "module",
   "main": "index.js",
@@ -13,6 +13,7 @@
     "start": "node index.js",
     "dev": "node --watch index.js",
     "prepare": "husky",
+    "postinstall": "node install.js",
     "release": "standard-version",
     "release:major": "npm run release -- --release-as major",
     "release:minor": "npm run release -- --release-as minor",

package/tests/handlers.test.js

@@ -96,6 +96,35 @@ test("commit_and_push commits changes and pushes", async () => {
   });
 });
 
+test("force_complete_task records entry and resets state", async () => {
+  await withWorkflowState(async (workflowState) => {
+    workflowState.state.taskDescription = "Improve caching";
+    workflowState.state.taskType = "feature";
+    workflowState.state.lastCommitMessage = "chore: wip";
+    workflowState.state.currentPhase = "release";
+    await workflowState.save();
+
+    const response = await handleToolCall({
+      request: createRequest("force_complete_task", {
+        commitMessage: "chore: force finish",
+        reason: "Deadline hit",
+      }),
+      normalizeRequestArgs,
+      workflowState,
+      exec: async () => ({ stdout: "" }),
+      git: {},
+      utils,
+    });
+
+    assert.ok(response.content[0].text.includes("Task force-completed."));
+    assert.equal(workflowState.state.currentPhase, "idle");
+    assert.equal(workflowState.state.history.length, 1);
+    assert.equal(workflowState.state.history[0].commitMessage, "chore: force finish");
+    assert.equal(workflowState.state.history[0].forced, true);
+    assert.equal(workflowState.state.history[0].forceReason, "Deadline hit");
+  });
+});
+
 test("perform_release blocks when new changes detected", async () => {
   await withWorkflowState(async (workflowState) => {
     workflowState.state.currentPhase = "release";

package/tools/definitions.js

@@ -163,6 +163,24 @@ export function getToolList() {
         required: ["commitMessage"],
       },
     },
+    {
+      name: "force_complete_task",
+      description:
+        "Force completion of the current task even if workflow steps are incomplete. Records history entry and resets the workflow.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          commitMessage: {
+            type: "string",
+            description: "Commit message or summary to record (optional)",
+          },
+          reason: {
+            type: "string",
+            description: "Why the task was force completed",
+          },
+        },
+      },
+    },
     {
       name: "drop_task",
       description:

package/tools/handlers.js

@@ -638,6 +638,32 @@ async function handleCompleteTask(args, workflowState) {
   );
 }
 
+async function handleForceCompleteTask(args, workflowState) {
+  const commitMessageArg =
+    typeof args.commitMessage === "string" ? args.commitMessage.trim() : "";
+  const reason = typeof args.reason === "string" ? args.reason.trim() : "";
+
+  const commitMessage =
+    commitMessageArg || workflowState.state.lastCommitMessage || "(no commit recorded)";
+
+  workflowState.addToHistory({
+    taskDescription: workflowState.state.taskDescription,
+    taskType: workflowState.state.taskType,
+    commitMessage,
+    forced: true,
+    forceReason: reason,
+  });
+
+  workflowState.reset();
+  await workflowState.save();
+
+  const reasonText = reason ? reason : "(none provided)";
+
+  return textResponse(
+    `⚠️ Task force-completed.\n\nRecorded commit message: ${commitMessage}\nReason: ${reasonText}\nWorkflow state reset. Start a new task when ready.`
+  );
+}
+
 async function handleDropTask(args, workflowState) {
   workflowState.addToHistory({
     taskDescription: workflowState.state.taskDescription,
@@ -719,6 +745,8 @@ export async function handleToolCall({
         return handlePerformRelease(args, { workflowState, exec, git, utils });
       case "complete_task":
         return handleCompleteTask(args, workflowState);
+      case "force_complete_task":
+        return handleForceCompleteTask(args, workflowState);
       case "drop_task":
         return handleDropTask(args, workflowState);
       case "get_workflow_status":