@programinglive/dev-workflow-mcp-server 1.0.0 → 1.0.2

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+labels: bug
+---
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Run command '...'
+3. See error
+
+## Expected behavior
+
+A clear and concise description of what you expected to happen.
+
+## Screenshots / Logs
+
+If applicable, add screenshots or paste logs to help explain your problem.
+
+## Environment (please complete the following information):
+
+- OS: [e.g. macOS 14.5]
+- Node version: [e.g. 20.14.0]
+- npm version: [e.g. 10.8.2]
+
+## Additional context
+
+Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+labels: enhancement
+---
+
+## Summary
+
+Describe the feature you'd like to see added.
+
+## Problem Statement
+
+What problem does this feature solve? Why is it important?
+
+## Proposed Solution
+
+Describe how you think this should work.
+
+## Alternatives Considered
+
+List any alternative solutions or features you've considered.
+
+## Additional context
+
+Add any other context, screenshots, or references about the feature request here.

package/.github/pull_request_template.md

@@ -0,0 +1,22 @@
+# Summary
+
+- Describe the changes introduced by this PR.
+- Reference any related issues (e.g., `Closes #123`).
+
+# Testing
+
+- [ ] `npm test`
+- [ ] Other (specify):
+
+# Documentation
+
+- [ ] README updated
+- [ ] Other docs updated (specify):
+
+# Checklist
+
+- [ ] Followed the development workflow enforced by the MCP server
+- [ ] Added/updated tests as needed
+- [ ] Verified single data/event/command/effect/validation/permission/authorization/error/success/warning/info flows remain intact
+- [ ] Removed unused imports and console statements
+- [ ] Ready for review

package/.husky/commit-msg

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+
+npx --no -- commitlint --edit "$1"

package/.husky/pre-commit

@@ -0,0 +1 @@
+npm test

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+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.0.2](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.0.1...v1.0.2) (2025-10-19)
+
+
+### 🐛 Bug Fixes
+
+* guard run_tests arguments ([2004c59](https://github.com/programinglive/dev-workflow-mcp-server/commit/2004c590fabe359d068122cf240a731382f81ca0))
+* normalize tool call arguments ([44d5a3d](https://github.com/programinglive/dev-workflow-mcp-server/commit/44d5a3d35f191012445fa02cee6254afbc993c98))
+
+
+### 📝 Documentation
+
+* clarify tool argument requirements ([4528614](https://github.com/programinglive/dev-workflow-mcp-server/commit/45286146661ad850eccb04849c11819e91ddd580))
+
+### [1.0.1](https://github.com/programinglive/dev-workflow-mcp-server/compare/v1.0.0...v1.0.1) (2025-10-18)
+
+
+### 🧹 Chores
+
+* configure release tooling ([772fc64](https://github.com/programinglive/dev-workflow-mcp-server/commit/772fc6400fb7d2d481992f6f03f25c094cb3924c))
+
+## 1.0.0 (2025-10-18)
+
+
+### ✨ Features
+
+* initial release ([9bd5835](https://github.com/programinglive/dev-workflow-mcp-server/commit/9bd5835af92776d9247efa50238ac5d71b00b492))
+
+
+### 📝 Documentation
+
+* add governance and contribution guidelines ([cfa78ea](https://github.com/programinglive/dev-workflow-mcp-server/commit/cfa78ea592788257f703d84974d78145a5312ca4))
+
+
+### 🧹 Chores
+
+* ensure clean staging before completing tasks ([7186629](https://github.com/programinglive/dev-workflow-mcp-server/commit/7186629fc2415b2d279a8a8d3451f52839dd2d28))
+* revert @modelcontextprotocol/sdk to ^1.0.0 ([305d71f](https://github.com/programinglive/dev-workflow-mcp-server/commit/305d71f330027d8466828af53c939b4491cccee9))
+* scope package under programinglive ([7388773](https://github.com/programinglive/dev-workflow-mcp-server/commit/7388773a50f0e06450558115edb367749245c31b))
+
+## 1.0.0 (2025-10-18)
+
+
+### ✨ Features
+
+* initial release ([9bd5835](https://github.com/programinglive/dev-workflow-mcp-server/commit/9bd5835af92776d9247efa50238ac5d71b00b492))
+
+
+### 📝 Documentation
+
+* add governance and contribution guidelines ([cfa78ea](https://github.com/programinglive/dev-workflow-mcp-server/commit/cfa78ea592788257f703d84974d78145a5312ca4))
+
+
+### 🧹 Chores
+
+* ensure clean staging before completing tasks ([7186629](https://github.com/programinglive/dev-workflow-mcp-server/commit/7186629fc2415b2d279a8a8d3451f52839dd2d28))
+* revert @modelcontextprotocol/sdk to ^1.0.0 ([305d71f](https://github.com/programinglive/dev-workflow-mcp-server/commit/305d71f330027d8466828af53c939b4491cccee9))
+* scope package under programinglive ([7388773](https://github.com/programinglive/dev-workflow-mcp-server/commit/7388773a50f0e06450558115edb367749245c31b))

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,79 @@
+# Code of Conduct
+
+## Our Pledge
+
+We, as members, contributors, and leaders, pledge to make participation in the dev-workflow-mcp-server project and our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address, without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all project spaces, and it also applies when an individual is officially representing the project or community in public spaces. Examples of representing our community include using an official project email address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project maintainers at `opensource@programinglive.com`. All complaints will be reviewed and investigated promptly and fairly.
+
+All project maintainers are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Project maintainers will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from project maintainers, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the project community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1, available at <https://www.contributor-covenant.org/version/2/1/code_of_conduct.html>.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+
+For answers to common questions about this code of conduct, see the [Contributor Covenant FAQ](https://www.contributor-covenant.org/faq). Translations are available at the [Contributor Covenant Translations](https://www.contributor-covenant.org/translations) page.
+
+[homepage]: https://www.contributor-covenant.org

package/CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing to dev-workflow-mcp-server
+
+Thanks for your interest in contributing! Follow the guidelines below to keep the development process smooth and aligned with the workflow enforced by this project.
+
+## Development Workflow
+
+1. **Start a task** using the MCP server's `start_task` tool with a clear description and task type.
+2. **Implement the change** following the single flow rules documented in the README.
+3. **Write or update tests**. All code changes must include tests when applicable.
+4. **Run tests** with `npm test` and ensure they pass.
+5. **Document changes**. Update `README.md` or other docs as needed.
+6. **Commit** following conventional commits (e.g., `feat: add new tool`).
+7. **Push** your branch and open a pull request using the provided template.
+
+## Getting Started
+
+- Fork the repository and clone it locally.
+- Install dependencies:
+
+```bash
+npm install
+```
+
+- Run the test suite to verify your setup:
+
+```bash
+npm test
+```
+
+## Pull Requests
+
+- Use a descriptive branch name (e.g., `feat/new-tool` or `fix/workflow-reset`).
+- Fill out the pull request template completely, including tests and documentation details.
+- Link related issues in the PR description.
+- Ensure CI checks pass before requesting review.
+
+## Coding Standards
+
+- Use TypeScript-friendly patterns even in JavaScript (avoid dynamic typing pitfalls).
+- Remove unused imports and variables before committing.
+- Follow existing code style and formatting.
+
+## Commit Messages
+
+- Follow [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/).
+- Example: `feat: enforce documentation reminder before commit`.
+
+## Reporting Issues
+
+- Search open issues to avoid duplicates.
+- When filing a bug, include reproduction steps, expected behavior, and environment details.
+- Feature requests should explain the problem being solved and potential benefits.
+
+## Code of Conduct
+
+By participating, you agree to abide by the [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+## Contact
+
+Questions? Reach out at `opensource@programinglive.com`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 programinglive
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -57,6 +57,21 @@ After adding the configuration, restart the application to load the MCP server.
 
 ## 🛠️ Available Tools
 
+### Tool Argument Requirements
+
+All tool invocations validate their `arguments` payload before running:
+- Strings are parsed as JSON and must resolve to an object (key/value pairs).
+- Passing non-object data (numbers, arrays, plain text) triggers a guidance error.
+- Missing or malformed arguments safely default to empty input so the tool can respond with actionable reminders.
+
+Example (stringified JSON object):
+```
+{
+  "name": "start_task",
+  "arguments": "{\"description\":\"Add reporting endpoint\",\"type\":\"feature\"}"
+}
+```
+
 ### `start_task`
 Start a new coding task. This is your first step - be conscious about what you're coding.
 
@@ -235,3 +250,10 @@ MIT
 ## 🙏 Contributing
 
 Feel free to customize this server to match your specific workflow needs!
+
+## 📜 Project Governance
+
+- [Code of Conduct](./CODE_OF_CONDUCT.md)
+- [Contributing Guide](./CONTRIBUTING.md)
+- [Security Policy](./SECURITY.md)
+- [License](./LICENSE)

package/SECURITY.md

@@ -0,0 +1,20 @@
+# Security Policy
+
+## Supported Versions
+
+We release patches for security vulnerabilities under new minor or patch versions. Always use the latest release.
+
+## Reporting a Vulnerability
+
+If you discover a vulnerability, please email `security@programinglive.com` with:
+
+- Description of the issue
+- Steps to reproduce
+- Potential impact
+- Suggested remediation (if known)
+
+We aim to acknowledge reports within 72 hours and will keep you informed as we work on a fix. Please do not disclose the vulnerability publicly until we have released an update.
+
+## Disclosure Policy
+
+Once a fix is available, we will publish a security advisory in the repository releases and notify contributors via the README.

package/commitlint.config.js

@@ -0,0 +1,3 @@
+export default {
+  extends: ["@commitlint/config-conventional"],
+};

package/index.js

@@ -8,9 +8,11 @@ import {
   ListPromptsRequestSchema,
   GetPromptRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
+import { exec as execCallback } from "child_process";
 import fs from "fs/promises";
 import path from "path";
 import { fileURLToPath } from "url";
+import { promisify } from "util";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -66,6 +68,59 @@ export class WorkflowState {
 export const workflowState = new WorkflowState();
 await workflowState.load();
 
+const exec = promisify(execCallback);
+
+function normalizeRequestArgs(rawArgs) {
+  if (rawArgs === undefined || rawArgs === null) {
+    return { args: {}, error: null };
+  }
+
+  if (typeof rawArgs === "string") {
+    try {
+      const parsed = JSON.parse(rawArgs);
+      if (parsed && typeof parsed === "object") {
+        return { args: parsed, error: null };
+      }
+
+      return {
+        args: {},
+        error:
+          "⚠️ Tool arguments must be a JSON object. Please provide key/value pairs.",
+      };
+    } catch (parseError) {
+      return {
+        args: {},
+        error:
+          "⚠️ Unable to parse tool arguments. Please provide valid JSON-formatted data.",
+      };
+    }
+  }
+
+  if (typeof rawArgs === "object") {
+    return { args: rawArgs, error: null };
+  }
+
+  return {
+    args: {},
+    error: "⚠️ Unsupported tool arguments format. Expected a JSON object.",
+  };
+}
+
+async function hasStagedChanges() {
+  try {
+    const { stdout } = await exec("git status --porcelain");
+    return stdout
+      .split("\n")
+      .filter(Boolean)
+      .some((line) => {
+        const indexStatus = line[0];
+        return indexStatus && indexStatus !== " " && indexStatus !== "?";
+      });
+  } catch (error) {
+    return false;
+  }
+}
+
 // Create MCP server
 export const server = new Server(
   {
@@ -213,96 +268,127 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 
 // Handle tool calls
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  switch (name) {
-    case "start_task": {
-      workflowState.reset();
-      workflowState.state.currentPhase = "coding";
-      workflowState.state.taskDescription = args.description;
-      workflowState.state.taskType = args.type;
-      await workflowState.save();
+  try {
+    const { name } = request.params;
+    const { args, error: argumentsError } = normalizeRequestArgs(
+      request.params.arguments
+    );
 
+    if (argumentsError) {
       return {
         content: [
           {
             type: "text",
-            text: `✅ Task Started: ${args.description}\n\n🎯 Be conscious about what you're coding!\n\nWorkflow Steps:\n1. ✓ Start task (current)\n2. ⏳ Fix/implement the feature\n3. ⏳ Create tests\n4. ⏳ Run tests (must pass!)\n5. ⏳ Create documentation\n6. ⏳ Commit & push\n\nReminder: Focus on writing clean, maintainable code!`,
+            text: argumentsError,
           },
         ],
       };
     }
 
-    case "mark_bug_fixed": {
-      if (workflowState.state.currentPhase === "idle") {
+    switch (name) {
+      case "start_task": {
+        workflowState.reset();
+        workflowState.state.currentPhase = "coding";
+        workflowState.state.taskDescription = args.description;
+        workflowState.state.taskType = args.type;
+        await workflowState.save();
+
         return {
           content: [
             {
               type: "text",
-              text: "⚠️ Please start a task first using 'start_task'!",
+              text: `✅ Task Started: ${args.description}\n\n🎯 Be conscious about what you're coding!\n\nWorkflow Steps:\n1. ✓ Start task (current)\n2. ⏳ Fix/implement the feature\n3. ⏳ Create tests\n4. ⏳ Run tests (must pass!)\n5. ⏳ Create documentation\n6. ⏳ Commit & push\n\nReminder: Focus on writing clean, maintainable code!`,
             },
           ],
         };
       }
 
-      workflowState.state.bugFixed = true;
-      workflowState.state.currentPhase = "testing";
-      workflowState.state.fixSummary = args.summary;
-      await workflowState.save();
-
-      return {
-        content: [
-          {
-            type: "text",
-            text: `✅ Feature/Bug marked as fixed!\n\n⚠️ CRITICAL REMINDER: You MUST create tests now!\n\nNext Steps:\n1. ✓ Fix/implement feature\n2. ⏳ Create tests for: ${args.summary}\n3. ⏳ Run tests (must be green!)\n4. ⏳ Create documentation\n5. ⏳ Commit & push\n\n🚫 DO NOT SKIP TESTING!`,
-          },
-        ],
-      };
-    }
+      case "mark_bug_fixed": {
+        if (workflowState.state.currentPhase === "idle") {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "⚠️ Please start a task first using 'start_task'!",
+              },
+            ],
+          };
+        }
+
+        workflowState.state.bugFixed = true;
+        workflowState.state.currentPhase = "testing";
+        workflowState.state.fixSummary = args.summary;
+        await workflowState.save();
 
-    case "run_tests": {
-      if (!workflowState.state.bugFixed) {
         return {
           content: [
             {
               type: "text",
-              text: "⚠️ Please mark your feature/bug as fixed first using 'mark_bug_fixed'!",
+              text: `✅ Feature/Bug marked as fixed!\n\n⚠️ CRITICAL REMINDER: You MUST create tests now!\n\nNext Steps:\n1. ✓ Fix/implement feature\n2. ⏳ Create tests for: ${args.summary}\n3. ⏳ Run tests (must be green!)\n4. ⏳ Create documentation\n5. ⏳ Commit & push\n\n🚫 DO NOT SKIP TESTING!`,
             },
           ],
         };
       }
 
-      workflowState.state.testsPassed = args.passed;
-      workflowState.state.testCommand = args.testCommand;
-      workflowState.state.testDetails = args.details || "";
-
-      if (!args.passed) {
-        workflowState.state.currentPhase = "testing";
+      case "run_tests": {
+        if (!workflowState.state.bugFixed) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "⚠️ Please mark your feature/bug as fixed first using 'mark_bug_fixed'!",
+              },
+            ],
+          };
+        }
+
+        if (
+          typeof args.passed !== "boolean" ||
+          typeof args.testCommand !== "string" ||
+          args.testCommand.trim() === ""
+        ) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "⚠️ Please provide both 'passed' (boolean) and 'testCommand' (non-empty string) when recording test results.",
+              },
+            ],
+          };
+        }
+
+        workflowState.state.testsPassed = args.passed;
+        workflowState.state.testCommand = args.testCommand;
+        workflowState.state.testDetails =
+          typeof args.details === "string" ? args.details : "";
+
+        if (!args.passed) {
+          workflowState.state.currentPhase = "testing";
+          await workflowState.save();
+
+          return {
+            content: [
+              {
+                type: "text",
+                text: `❌ TESTS FAILED!\n\n🚫 STOP! DO NOT COMMIT OR PUSH!\n\nYou must:\n1. Fix the failing tests\n2. Run tests again until they pass\n\nTest command: ${args.testCommand}\n\nNever skip or ignore failing tests!`,
+              },
+            ],
+          };
+        }
+
+        workflowState.state.currentPhase = "documentation";
         await workflowState.save();
 
         return {
           content: [
             {
               type: "text",
-              text: `❌ TESTS FAILED!\n\n🚫 STOP! DO NOT COMMIT OR PUSH!\n\nYou must:\n1. Fix the failing tests\n2. Run tests again until they pass\n\nTest command: ${args.testCommand}\n\nNever skip or ignore failing tests!`,
+              text: `✅ All tests passed! 🎉\n\nTest command: ${args.testCommand}\n\nNext Steps:\n1. ✓ Fix/implement feature\n2. ✓ Create tests\n3. ✓ Run tests (GREEN!)\n4. ⏳ Create/update documentation\n5. ⏳ Commit & push\n\nReminder: Document what you did before committing!`,
             },
           ],
         };
       }
 
-      workflowState.state.currentPhase = "documentation";
-      await workflowState.save();
-
-      return {
-        content: [
-          {
-            type: "text",
-            text: `✅ All tests passed! 🎉\n\nTest command: ${args.testCommand}\n\nNext Steps:\n1. ✓ Fix/implement feature\n2. ✓ Create tests\n3. ✓ Run tests (GREEN!)\n4. ⏳ Create/update documentation\n5. ⏳ Commit & push\n\nReminder: Document what you did before committing!`,
-          },
-        ],
-      };
-    }
-
     case "create_documentation": {
       if (!workflowState.state.testsPassed) {
         return {
@@ -379,6 +465,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      if (await hasStagedChanges()) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "⚠️ Staged files detected! Please commit or unstage all files before pushing. Run 'git status' to confirm a clean working tree, then try again.",
+            },
+          ],
+        };
+      }
+
       workflowState.addToHistory({
         taskDescription: workflowState.state.taskDescription,
         taskType: workflowState.state.taskType,
@@ -466,8 +563,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       };
     }
 
-    default:
-      throw new Error(`Unknown tool: ${name}`);
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    console.error("Tool handler error:", error);
+    return {
+      content: [
+        {
+          type: "text",
+          text: "⚠️ Internal server error while processing the tool request. Please try again.",
+        },
+      ],
+    };
   }
 });
 

package/package.json

@@ -1,17 +1,22 @@
 {
   "name": "@programinglive/dev-workflow-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server to enforce development workflow discipline",
   "type": "module",
   "main": "index.js",
   "bin": {
-    "dev-workflow-mcp": "./index.js"
+    "dev-workflow-mcp": "index.js"
   },
   "scripts": {
     "test": "node --test",
     "check": "node --check index.js",
     "start": "node index.js",
-    "dev": "node --watch index.js"
+    "dev": "node --watch index.js",
+    "prepare": "husky",
+    "release": "standard-version",
+    "release:major": "npm run release -- --release-as major",
+    "release:minor": "npm run release -- --release-as minor",
+    "release:patch": "npm run release -- --release-as patch"
   },
   "keywords": [
     "mcp",
@@ -22,9 +27,65 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4"
+    "@modelcontextprotocol/sdk": "^1.0.0"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@programinglive/commiter": "^1.0.0",
+    "husky": "^9.1.7",
+    "standard-version": "^9.5.0"
+  },
+  "standard-version": {
+    "releaseCommitMessageFormat": "chore(release): {{currentTag}} 🚀",
+    "types": [
+      {
+        "type": "feat",
+        "section": "✨ Features"
+      },
+      {
+        "type": "fix",
+        "section": "🐛 Bug Fixes"
+      },
+      {
+        "type": "perf",
+        "section": "⚡ Performance"
+      },
+      {
+        "type": "refactor",
+        "section": "♻️ Refactors"
+      },
+      {
+        "type": "docs",
+        "section": "📝 Documentation"
+      },
+      {
+        "type": "style",
+        "section": "💄 Styles"
+      },
+      {
+        "type": "test",
+        "section": "✅ Tests"
+      },
+      {
+        "type": "build",
+        "section": "🏗️ Build System"
+      },
+      {
+        "type": "ci",
+        "section": "👷 Continuous Integration"
+      },
+      {
+        "type": "chore",
+        "section": "🧹 Chores"
+      },
+      {
+        "type": "revert",
+        "section": "⏪ Reverts"
+      }
+    ]
   }
 }