@programinglive/dev-workflow-mcp-server 1.1.2 → 1.1.4

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.1.4](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.1.3...v1.1.4) (2025-10-25)
+
+
+### 🐛 Bug Fixes
+
+* ensure install script uses project root for workflow state ([8b8b32f](https://github.com/programinglive/dev-workflow-mcp-server/commit/8b8b32f5c436b256ec1edb05a406405a5c2455c1))
+
+### [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)

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 the **project where you ran `npm install`** (using npm's `INIT_CWD`), keeping workflow history separate per project. If you're installing the package itself (inside `node_modules`), the script skips creation so it never pollutes the shared package directory.
+
+### 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,69 @@
+#!/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 {
+    // npm sets INIT_CWD to the directory where `npm install` was originally invoked.
+    // Fallback to process.cwd() if it's not present (e.g., older npm versions).
+    const projectRoot = process.env.INIT_CWD || process.cwd();
+
+    // If INIT_CWD points inside node_modules, this script is being executed
+    // while installing the package itself. In that case, skip creating a state file.
+    if (projectRoot.includes(`node_modules${path.sep}`)) {
+      console.log('ℹ️ Skipping workflow state creation inside node_modules.');
+      return;
+    }
+
+    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.2",
+  "version": "1.1.4",
   "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",