@vm3jack/mcp-server-azure-devops 1.0.0

package/dist/shared/test/test-helpers.d.ts

@@ -0,0 +1,20 @@
+import { WebApi } from 'azure-devops-node-api';
+import { AzureDevOpsConfig } from '../types';
+/**
+ * Creates a WebApi connection for tests with real credentials
+ *
+ * @returns WebApi connection
+ */
+export declare function getTestConnection(): Promise<WebApi | null>;
+/**
+ * Creates test configuration for Azure DevOps tests
+ *
+ * @returns Azure DevOps config
+ */
+export declare function getTestConfig(): AzureDevOpsConfig | null;
+/**
+ * Determines if integration tests should be skipped
+ *
+ * @returns true if integration tests should be skipped
+ */
+export declare function shouldSkipIntegrationTest(): boolean;

package/dist/shared/test/test-helpers.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTestConnection = getTestConnection;
+exports.getTestConfig = getTestConfig;
+exports.shouldSkipIntegrationTest = shouldSkipIntegrationTest;
+const azure_devops_node_api_1 = require("azure-devops-node-api");
+const azure_devops_node_api_2 = require("azure-devops-node-api");
+const auth_1 = require("../auth");
+/**
+ * Creates a WebApi connection for tests with real credentials
+ *
+ * @returns WebApi connection
+ */
+async function getTestConnection() {
+    // If we have real credentials, use them
+    const orgUrl = process.env.AZURE_DEVOPS_ORG_URL;
+    const token = process.env.AZURE_DEVOPS_PAT;
+    if (orgUrl && token) {
+        const authHandler = (0, azure_devops_node_api_2.getPersonalAccessTokenHandler)(token);
+        return new azure_devops_node_api_1.WebApi(orgUrl, authHandler);
+    }
+    // If we don't have credentials, return null
+    return null;
+}
+/**
+ * Creates test configuration for Azure DevOps tests
+ *
+ * @returns Azure DevOps config
+ */
+function getTestConfig() {
+    // If we have real credentials, use them
+    const orgUrl = process.env.AZURE_DEVOPS_ORG_URL;
+    const pat = process.env.AZURE_DEVOPS_PAT;
+    if (orgUrl && pat) {
+        return {
+            organizationUrl: orgUrl,
+            authMethod: auth_1.AuthenticationMethod.PersonalAccessToken,
+            personalAccessToken: pat,
+            defaultProject: process.env.AZURE_DEVOPS_DEFAULT_PROJECT,
+        };
+    }
+    // If we don't have credentials, return null
+    return null;
+}
+/**
+ * Determines if integration tests should be skipped
+ *
+ * @returns true if integration tests should be skipped
+ */
+function shouldSkipIntegrationTest() {
+    if (!process.env.AZURE_DEVOPS_ORG_URL || !process.env.AZURE_DEVOPS_PAT) {
+        console.log('Skipping integration test: No real Azure DevOps connection available');
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/shared/test/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../src/shared/test/test-helpers.ts"],"names":[],"mappings":";;AAUA,8CAYC;AAOD,sCAgBC;AAOD,8DAQC;AA5DD,iEAA+C;AAC/C,iEAAsE;AAEtE,kCAA+C;AAE/C;;;;GAIG;AACI,KAAK,UAAU,iBAAiB;IACrC,wCAAwC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE3C,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,IAAA,qDAA6B,EAAC,KAAK,CAAC,CAAC;QACzD,OAAO,IAAI,8BAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,4CAA4C;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa;IAC3B,wCAAwC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAEzC,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO;YACL,eAAe,EAAE,MAAM;YACvB,UAAU,EAAE,2BAAoB,CAAC,mBAAmB;YACpD,mBAAmB,EAAE,GAAG;YACxB,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B;SACzD,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB;IACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACvE,OAAO,CAAC,GAAG,CACT,sEAAsE,CACvE,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/shared/types/config.d.ts

@@ -0,0 +1,27 @@
+import { AuthenticationMethod } from '../auth/auth-factory';
+/**
+ * Azure DevOps configuration type definition
+ */
+export interface AzureDevOpsConfig {
+    /**
+     * The Azure DevOps organization URL (e.g., https://dev.azure.com/organization)
+     */
+    organizationUrl: string;
+    /**
+     * Authentication method to use (pat, azure-identity, azure-cli)
+     * @default 'azure-identity'
+     */
+    authMethod?: AuthenticationMethod;
+    /**
+     * Personal Access Token for authentication (required for PAT authentication)
+     */
+    personalAccessToken?: string;
+    /**
+     * Optional default project to use when not specified
+     */
+    defaultProject?: string;
+    /**
+     * Optional API version to use (defaults to latest)
+     */
+    apiVersion?: string;
+}

package/dist/shared/types/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/shared/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/shared/types/config.ts"],"names":[],"mappings":""}

package/dist/shared/types/index.d.ts

@@ -0,0 +1 @@
+export * from './config';

package/dist/shared/types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+//# sourceMappingURL=index.js.map

package/dist/shared/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/dist/shared/types/request-handler.d.ts

@@ -0,0 +1,21 @@
+import { CallToolRequest, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { WebApi } from 'azure-devops-node-api';
+/**
+ * Function type for identifying if a request belongs to a specific feature.
+ */
+export interface RequestIdentifier {
+    (request: CallToolRequest): boolean;
+}
+/**
+ * Function type for handling feature-specific requests.
+ * Returns either the standard MCP CallToolResult or a simplified response structure
+ * for backward compatibility.
+ */
+export interface RequestHandler {
+    (connection: WebApi, request: CallToolRequest): Promise<CallToolResult | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+}

package/dist/shared/types/request-handler.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=request-handler.js.map

package/dist/shared/types/request-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-handler.js","sourceRoot":"","sources":["../../../src/shared/types/request-handler.ts"],"names":[],"mappings":""}

package/dist/shared/types/tool-definition.d.ts

@@ -0,0 +1,10 @@
+import { JsonSchema7Type } from 'zod-to-json-schema';
+/**
+ * Represents a tool that can be listed in the ListTools response
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema7Type;
+    mcp_enabled?: boolean;
+}

package/dist/shared/types/tool-definition.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tool-definition.js.map

package/dist/shared/types/tool-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-definition.js","sourceRoot":"","sources":["../../../src/shared/types/tool-definition.ts"],"names":[],"mappings":""}

package/dist/shared/utils/serialize.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Removes null and undefined values from an object recursively,
+ * then serializes to compact JSON to minimize token usage.
+ */
+export declare function serialize(data: unknown): string;

package/dist/shared/utils/serialize.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serialize = serialize;
+/**
+ * Removes null and undefined values from an object recursively,
+ * then serializes to compact JSON to minimize token usage.
+ */
+function serialize(data) {
+    return JSON.stringify(data, (_, value) => {
+        if (value === null || value === undefined)
+            return undefined;
+        return value;
+    });
+}
+//# sourceMappingURL=serialize.js.map

package/dist/shared/utils/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../../src/shared/utils/serialize.ts"],"names":[],"mappings":";;AAIA,8BAKC;AATD;;;GAGG;AACH,SAAgB,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QACvC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/environment.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utility functions and constants related to environment variables.
+ */
+/**
+ * Extract organization name from Azure DevOps organization URL
+ */
+export declare function getOrgNameFromUrl(url?: string): string;
+/**
+ * Default project name from environment variables
+ */
+export declare const defaultProject: string;
+/**
+ * Default organization name derived from the organization URL
+ */
+export declare const defaultOrg: string;

package/dist/utils/environment.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultOrg = exports.defaultProject = void 0;
+exports.getOrgNameFromUrl = getOrgNameFromUrl;
+// Load environment variables
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+/**
+ * Utility functions and constants related to environment variables.
+ */
+/**
+ * Extract organization name from Azure DevOps organization URL
+ */
+function getOrgNameFromUrl(url) {
+    if (!url)
+        return 'unknown-organization';
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(url);
+    }
+    catch {
+        return 'unknown-organization';
+    }
+    const hostname = parsedUrl.hostname.toLowerCase();
+    if (hostname === 'dev.azure.com') {
+        const segments = parsedUrl.pathname.split('/').filter(Boolean);
+        return segments[0] ?? 'unknown-organization';
+    }
+    if (hostname.endsWith('.visualstudio.com')) {
+        return hostname.split('.')[0] || 'unknown-organization';
+    }
+    const segments = parsedUrl.pathname.split('/').filter(Boolean);
+    if (segments.length === 0) {
+        return 'unknown-organization';
+    }
+    if (segments[0].toLowerCase() === 'tfs') {
+        return segments[1] ?? 'unknown-organization';
+    }
+    return segments[0] ?? 'unknown-organization';
+}
+/**
+ * Default project name from environment variables
+ */
+exports.defaultProject = process.env.AZURE_DEVOPS_DEFAULT_PROJECT || 'no default project';
+/**
+ * Default organization name derived from the organization URL
+ */
+exports.defaultOrg = getOrgNameFromUrl(process.env.AZURE_DEVOPS_ORG_URL);
+//# sourceMappingURL=environment.js.map

package/dist/utils/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/utils/environment.ts"],"names":[],"mappings":";;;;;;AAWA,8CA8BC;AAzCD,6BAA6B;AAC7B,oDAA4B;AAC5B,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEhB;;GAEG;AAEH;;GAEG;AACH,SAAgB,iBAAiB,CAAC,GAAY;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO,sBAAsB,CAAC;IAExC,IAAI,SAAc,CAAC;IACnB,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAClD,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC;IAC/C,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC;IAC/C,CAAC;IAED,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC;AAC/C,CAAC;AAED;;GAEG;AACU,QAAA,cAAc,GACzB,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,oBAAoB,CAAC;AAEnE;;GAEG;AACU,QAAA,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/utils/environment.spec.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/environment.spec.unit.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Mock the environment module before importing
+jest.mock('./environment', () => {
+    const original = jest.requireActual('./environment');
+    return {
+        ...original,
+        // We'll keep getOrgNameFromUrl as is for its own tests
+        getOrgNameFromUrl: original.getOrgNameFromUrl,
+    };
+});
+const environment_1 = require("./environment");
+describe('environment utilities', () => {
+    // Store original environment variables
+    const originalEnv = { ...process.env };
+    // Reset environment variables after each test
+    afterEach(() => {
+        process.env = { ...originalEnv };
+        jest.resetModules();
+    });
+    describe('getOrgNameFromUrl', () => {
+        it('should extract organization name from Azure DevOps URL', () => {
+            const url = 'https://dev.azure.com/test-organization';
+            expect((0, environment_1.getOrgNameFromUrl)(url)).toBe('test-organization');
+        });
+        it('should handle URLs with paths after the organization name', () => {
+            const url = 'https://dev.azure.com/test-organization/project';
+            expect((0, environment_1.getOrgNameFromUrl)(url)).toBe('test-organization');
+        });
+        it('should extract organization name from legacy visualstudio.com URL', () => {
+            const url = 'https://legacy-org.visualstudio.com/DefaultCollection';
+            expect((0, environment_1.getOrgNameFromUrl)(url)).toBe('legacy-org');
+        });
+        it('should extract collection name from server URL with tfs virtual dir', () => {
+            const url = 'https://ado.local/tfs/DefaultCollection';
+            expect((0, environment_1.getOrgNameFromUrl)(url)).toBe('DefaultCollection');
+        });
+        it('should extract collection name from server URL without tfs virtual dir', () => {
+            const url = 'https://ado.local/DefaultCollection/ProjectX';
+            expect((0, environment_1.getOrgNameFromUrl)(url)).toBe('DefaultCollection');
+        });
+        it('should return "unknown-organization" when URL is undefined', () => {
+            expect((0, environment_1.getOrgNameFromUrl)(undefined)).toBe('unknown-organization');
+        });
+        it('should return "unknown-organization" when URL is empty', () => {
+            expect((0, environment_1.getOrgNameFromUrl)('')).toBe('unknown-organization');
+        });
+        it('should return "unknown-organization" when URL does not match pattern', () => {
+            const url = 'https://example.com';
+            expect((0, environment_1.getOrgNameFromUrl)(url)).toBe('unknown-organization');
+        });
+    });
+    describe('defaultProject and defaultOrg', () => {
+        // Since we can't easily test the environment variable initialization directly,
+        // we'll test the getOrgNameFromUrl function which is used to derive defaultOrg
+        it('should handle the real default case', () => {
+            // This test is more of a documentation than a real test
+            const orgNameFromUrl = (0, environment_1.getOrgNameFromUrl)(process.env.AZURE_DEVOPS_ORG_URL);
+            // We can't assert an exact value since it depends on the environment
+            expect(typeof orgNameFromUrl).toBe('string');
+        });
+    });
+});
+//# sourceMappingURL=environment.spec.unit.js.map

package/dist/utils/environment.spec.unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.spec.unit.js","sourceRoot":"","sources":["../../src/utils/environment.spec.unit.ts"],"names":[],"mappings":"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"}

package/docs/SOLUTION_SUMMARY.md

@@ -0,0 +1,145 @@
+# Solution Summary: Re-triggering Failed Release 0.1.44
+
+## Problem Statement
+Release 0.1.44 was created on GitHub but the npm publish step failed. Attempting to re-run the workflow results in all publish steps being skipped because release-please thinks the release is already complete.
+
+## Root Cause Analysis
+1. ✅ Release `mcp-server-azure-devops-v0.1.44` was created on GitHub (2026-02-05T15:38:57Z)
+2. ❌ npm package was NOT published (latest on npm is still 0.1.43)
+3. 🔄 Subsequent workflow runs skip publish steps because:
+   - `release-please-manifest.json` shows version 0.1.44
+   - `package.json` shows version 0.1.44
+   - When these match, release-please sets `release_created=false`
+   - All publish steps have condition `if: steps.release.outputs.release_created`
+
+## Solution Implemented
+
+### 1. Enhanced Workflow with Manual Dispatch
+Added `workflow_dispatch` trigger to `.github/workflows/release-please.yml` that allows:
+- **Normal operation**: Push to main → automatic release-please flow (unchanged)
+- **Manual re-publish**: Specify a tag → checkout and publish that specific tag to npm
+
+### 2. New Manual Publish Job
+Created a separate `manual-publish` job that:
+- Only runs when a tag is manually specified via workflow_dispatch
+- Checks out the exact code from the specified tag
+- Installs dependencies, builds, and publishes to npm
+- Does NOT create a new release or modify any version files
+
+### 3. Comprehensive Documentation
+Created `docs/release-troubleshooting.md` with:
+- Explanation of the release process
+- Common issues and their causes
+- Step-by-step solutions for each scenario
+- Verification commands
+
+### 4. Updated CONTRIBUTING.md
+Added reference to the troubleshooting guide in the Release Process section.
+
+## How to Use (Immediate Action for 0.1.44)
+
+To re-publish release 0.1.44 to npm:
+
+1. Go to: https://github.com/Tiberriver256/mcp-server-azure-devops/actions/workflows/release-please.yml
+2. Click "Run workflow" button (dropdown on the right side)
+3. Enter tag: `mcp-server-azure-devops-v0.1.44`
+4. Click "Run workflow"
+
+The workflow will:
+- ✅ Checkout tag `mcp-server-azure-devops-v0.1.44`
+- ✅ Install dependencies with `npm ci`
+- ✅ Build the package with `npm run build`
+- ✅ Publish to npm with `npm publish --access public`
+
+## Verification After Publishing
+
+```bash
+# Check if version 0.1.44 is now on npm
+npm view @tiberriver256/mcp-server-azure-devops@0.1.44
+
+# Check if latest version is now 0.1.44
+npm view @tiberriver256/mcp-server-azure-devops version
+
+# Try installing
+npm install @tiberriver256/mcp-server-azure-devops@0.1.44
+```
+
+## Files Changed
+
+1. `.github/workflows/release-please.yml`
+   - Added `workflow_dispatch` trigger with `tag` input
+   - Added conditional logic to `release-please` job
+   - Added new `manual-publish` job
+
+2. `docs/release-troubleshooting.md` (NEW)
+   - Complete troubleshooting guide
+   - Step-by-step instructions
+   - Verification commands
+
+3. `CONTRIBUTING.md`
+   - Added link to troubleshooting guide
+
+## Benefits
+
+1. **Immediate**: Can re-publish 0.1.44 right now without code changes
+2. **No Side Effects**: Does not modify versions, CHANGELOG, or create new releases
+3. **Reusable**: Can be used for any future failed publish scenarios
+4. **Safe**: Only publishes the exact code from the specified tag
+5. **Documented**: Clear instructions for maintainers
+
+## Future Prevention
+
+The enhanced workflow prevents this issue from recurring by providing a clear path to:
+- Re-publish any failed release
+- Manually publish hotfixes
+- Recover from npm downtime or authentication issues
+
+## Next Steps
+
+1. ✅ Merge this PR to enable the manual workflow dispatch feature
+2. ⏳ Run manual workflow with tag `mcp-server-azure-devops-v0.1.44`
+3. ⏳ Verify package appears on npm
+4. ⏳ Document success in this issue/PR
+
+## Technical Details
+
+### Workflow Logic
+
+```yaml
+on:
+  push:
+    branches: [main]          # Normal automatic flow
+  workflow_dispatch:           # Manual trigger
+    inputs:
+      tag:
+        description: 'Git tag to publish...'
+        required: false
+
+jobs:
+  release-please:
+    # Only runs if NO tag specified (automatic flow)
+    if: ${{ github.event.inputs.tag == '' || github.event.inputs.tag == null }}
+    
+  manual-publish:
+    # Only runs if tag IS specified (manual flow)
+    if: ${{ github.event.inputs.tag != '' && github.event.inputs.tag != null }}
+    steps:
+      - checkout tag
+      - npm ci
+      - npm run build
+      - npm publish
+```
+
+### Why This Works
+
+1. **Separate Job**: Manual publish is independent of release-please's state tracking
+2. **Direct Checkout**: Uses git tag directly, bypassing manifest comparison
+3. **No State Modification**: Doesn't touch version files or manifest
+4. **Same Build Steps**: Uses identical build/publish steps as automatic flow
+
+## Risk Assessment
+
+- **Low Risk**: Changes only affect workflow triggering mechanism
+- **No Code Changes**: TypeScript/JavaScript code remains unchanged
+- **Backward Compatible**: Normal push-to-main flow unchanged
+- **Well-Tested Pattern**: workflow_dispatch is a standard GitHub Actions feature