mcp-adr-analysis-server 2.1.22 → 2.1.28

package/dist/src/utils/git-remote-detector.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Git Remote Detection Utility
+ * Auto-detects repository name from git remote origin for ADR Aggregator integration
+ */
+/**
+ * Git hosting provider
+ */
+export type GitProvider = 'github' | 'gitlab' | 'bitbucket' | 'azure' | 'unknown';
+/**
+ * Git remote information
+ */
+export interface GitRemoteInfo {
+    /** Full remote URL */
+    remoteUrl: string;
+    /** Extracted owner/repo format (e.g., "tosin2013/mcp-adr-analysis-server") */
+    repositoryName: string;
+    /** Git hosting provider */
+    provider: GitProvider;
+    /** Current branch name */
+    currentBranch: string;
+}
+/**
+ * Detect git remote origin and extract repository information
+ *
+ * @param projectPath - Path to the project directory (defaults to cwd)
+ * @returns Git remote information including repository name
+ * @throws McpAdrError if not a git repository or remote detection fails
+ *
+ * @example
+ * ```typescript
+ * const gitInfo = detectGitRemote('/path/to/project');
+ * console.log(gitInfo.repositoryName); // "owner/repo"
+ * console.log(gitInfo.provider); // "github"
+ * ```
+ */
+export declare function detectGitRemote(projectPath?: string): GitRemoteInfo;
+/**
+ * Check if current directory is a git repository
+ *
+ * @param projectPath - Path to check (defaults to cwd)
+ * @returns true if directory is inside a git repository
+ */
+export declare function isGitRepository(projectPath?: string): boolean;
+/**
+ * Get the git root directory
+ *
+ * @param projectPath - Starting path (defaults to cwd)
+ * @returns Absolute path to git root directory
+ * @throws McpAdrError if not in a git repository
+ */
+export declare function getGitRoot(projectPath?: string): string;
+/**
+ * Get the current commit hash
+ *
+ * @param projectPath - Path to the project (defaults to cwd)
+ * @param short - Return short hash (7 chars) instead of full hash
+ * @returns Current commit hash
+ */
+export declare function getCurrentCommit(projectPath?: string, short?: boolean): string;
+/**
+ * Check if there are uncommitted changes
+ *
+ * @param projectPath - Path to the project (defaults to cwd)
+ * @returns true if there are uncommitted changes
+ */
+export declare function hasUncommittedChanges(projectPath?: string): boolean;
+//# sourceMappingURL=git-remote-detector.d.ts.map

package/dist/src/utils/git-remote-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-remote-detector.d.ts","sourceRoot":"","sources":["../../../src/utils/git-remote-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,WAAW,GAAE,MAAsB,GAAG,aAAa,CA+BlF;AA4ED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAW5E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,WAAW,GAAE,MAAsB,GAAG,MAAM,CAatE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,GAAE,MAAsB,EACnC,KAAK,GAAE,OAAe,GACrB,MAAM,CAcR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAWlF"}

package/dist/src/utils/git-remote-detector.js

@@ -0,0 +1,194 @@
+/**
+ * Git Remote Detection Utility
+ * Auto-detects repository name from git remote origin for ADR Aggregator integration
+ */
+import { execSync } from 'node:child_process';
+import { McpAdrError } from '../types/index.js';
+/**
+ * Detect git remote origin and extract repository information
+ *
+ * @param projectPath - Path to the project directory (defaults to cwd)
+ * @returns Git remote information including repository name
+ * @throws McpAdrError if not a git repository or remote detection fails
+ *
+ * @example
+ * ```typescript
+ * const gitInfo = detectGitRemote('/path/to/project');
+ * console.log(gitInfo.repositoryName); // "owner/repo"
+ * console.log(gitInfo.provider); // "github"
+ * ```
+ */
+export function detectGitRemote(projectPath = process.cwd()) {
+    try {
+        // Get remote origin URL
+        const remoteUrl = execSync('git config --get remote.origin.url', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // Get current branch
+        const currentBranch = execSync('git rev-parse --abbrev-ref HEAD', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // Extract repository name from URL
+        const { repositoryName, provider } = parseRemoteUrl(remoteUrl);
+        return {
+            remoteUrl,
+            repositoryName,
+            provider,
+            currentBranch,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to detect git remote: ${error instanceof Error ? error.message : String(error)}`, 'GIT_REMOTE_DETECTION_ERROR');
+    }
+}
+/**
+ * Parse remote URL to extract repository name and provider
+ *
+ * Supports:
+ * - SSH format: git@github.com:owner/repo.git
+ * - HTTPS format: https://github.com/owner/repo.git
+ * - Azure DevOps: https://dev.azure.com/org/project/_git/repo
+ */
+function parseRemoteUrl(url) {
+    let repositoryName = '';
+    let provider = 'unknown';
+    // Handle SSH format: git@github.com:owner/repo.git
+    const sshMatch = url.match(/git@([^:]+):([^/]+)\/(.+?)(\.git)?$/);
+    if (sshMatch && sshMatch[1] && sshMatch[2] && sshMatch[3]) {
+        const host = sshMatch[1];
+        const owner = sshMatch[2];
+        const repo = sshMatch[3];
+        repositoryName = `${owner}/${repo}`;
+        provider = detectProvider(host);
+        return { repositoryName, provider };
+    }
+    // Handle Azure DevOps: https://dev.azure.com/org/project/_git/repo
+    const azureMatch = url.match(/https?:\/\/dev\.azure\.com\/([^/]+)\/([^/]+)\/_git\/(.+?)(\.git)?$/);
+    if (azureMatch && azureMatch[1] && azureMatch[2] && azureMatch[3]) {
+        const org = azureMatch[1];
+        const project = azureMatch[2];
+        const repo = azureMatch[3];
+        repositoryName = `${org}/${project}/${repo}`;
+        provider = 'azure';
+        return { repositoryName, provider };
+    }
+    // Handle Azure DevOps (visualstudio.com format)
+    const vsMatch = url.match(/https?:\/\/([^.]+)\.visualstudio\.com\/([^/]+)\/_git\/(.+?)(\.git)?$/);
+    if (vsMatch && vsMatch[1] && vsMatch[2] && vsMatch[3]) {
+        const org = vsMatch[1];
+        const project = vsMatch[2];
+        const repo = vsMatch[3];
+        repositoryName = `${org}/${project}/${repo}`;
+        provider = 'azure';
+        return { repositoryName, provider };
+    }
+    // Handle HTTPS format: https://github.com/owner/repo.git
+    const httpsMatch = url.match(/https?:\/\/([^/]+)\/([^/]+)\/(.+?)(\.git)?$/);
+    if (httpsMatch && httpsMatch[1] && httpsMatch[2] && httpsMatch[3]) {
+        const host = httpsMatch[1];
+        const owner = httpsMatch[2];
+        const repo = httpsMatch[3];
+        repositoryName = `${owner}/${repo}`;
+        provider = detectProvider(host);
+        return { repositoryName, provider };
+    }
+    // Fallback: return URL as-is
+    return { repositoryName: url, provider: 'unknown' };
+}
+/**
+ * Detect git provider from hostname
+ */
+function detectProvider(host) {
+    const hostLower = host.toLowerCase();
+    if (hostLower.includes('github'))
+        return 'github';
+    if (hostLower.includes('gitlab'))
+        return 'gitlab';
+    if (hostLower.includes('bitbucket'))
+        return 'bitbucket';
+    if (hostLower.includes('azure') || hostLower.includes('visualstudio'))
+        return 'azure';
+    return 'unknown';
+}
+/**
+ * Check if current directory is a git repository
+ *
+ * @param projectPath - Path to check (defaults to cwd)
+ * @returns true if directory is inside a git repository
+ */
+export function isGitRepository(projectPath = process.cwd()) {
+    try {
+        execSync('git rev-parse --is-inside-work-tree', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the git root directory
+ *
+ * @param projectPath - Starting path (defaults to cwd)
+ * @returns Absolute path to git root directory
+ * @throws McpAdrError if not in a git repository
+ */
+export function getGitRoot(projectPath = process.cwd()) {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (error) {
+        throw new McpAdrError(`Not in a git repository: ${error instanceof Error ? error.message : String(error)}`, 'NOT_GIT_REPO');
+    }
+}
+/**
+ * Get the current commit hash
+ *
+ * @param projectPath - Path to the project (defaults to cwd)
+ * @param short - Return short hash (7 chars) instead of full hash
+ * @returns Current commit hash
+ */
+export function getCurrentCommit(projectPath = process.cwd(), short = false) {
+    try {
+        const format = short ? '--short' : '';
+        return execSync(`git rev-parse ${format} HEAD`, {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to get current commit: ${error instanceof Error ? error.message : String(error)}`, 'GIT_COMMIT_ERROR');
+    }
+}
+/**
+ * Check if there are uncommitted changes
+ *
+ * @param projectPath - Path to the project (defaults to cwd)
+ * @returns true if there are uncommitted changes
+ */
+export function hasUncommittedChanges(projectPath = process.cwd()) {
+    try {
+        const status = execSync('git status --porcelain', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return status.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=git-remote-detector.js.map

package/dist/src/utils/git-remote-detector.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-adr-analysis-server",
-  "version": "2.1.22",
+  "version": "2.1.28",
   "description": "MCP server for analyzing Architectural Decision Records and project architecture",
   "main": "dist/src/index.js",
   "type": "module",
@@ -75,7 +75,7 @@
     "@types/node": "^25.0.2",
     "@typescript-eslint/eslint-plugin": "^8.45.0",
     "@typescript-eslint/parser": "^8.45.0",
-    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/coverage-v8": "^4.0.17",
     "ajv": "^8.17.1",
     "eslint": "^9.36.0",
     "eslint-config-prettier": "^10.1.8",
@@ -90,7 +90,7 @@
     "tsx": "^4.6.0",
     "typedoc": "^0.28.13",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.16"
+    "vitest": "^4.0.17"
   },
   "keywords": [
     "mcp",