feat: add conventional commits analysis tool

- Analyze commit types (feat, fix, docs, etc.) and their frequency
- Track scopes usage across commits
- Count breaking changes
- List recent releases with dates
- Calculate release frequency
- Show conventional commit adoption percentage

Author: jonmatum

README.md

@@ -18,6 +18,7 @@ This server provides tools to extract meaningful metrics from git repositories,
 - **Collaboration Metrics**: Team interaction patterns
 - **Quality Metrics**: Commit size, reverts, and fix rates
 - **Technical Debt**: Stale files and complexity hotspots
+- **Conventional Commits**: Analyze commit types, scopes, and release frequency
 
 ### Production Features
 
@@ -379,6 +380,35 @@ Identify technical debt.
 }
 ```
 
+### get_conventional_commits
+
+Analyze conventional commit usage and release patterns.
+
+**Parameters:**
+- `repo_path` (required): Path to git repository
+- `since` (required): Start date (YYYY-MM-DD)
+
+**Returns:**
+```json
+{
+  "totalCommits": 25,
+  "conventionalCommits": 25,
+  "conventionalPercentage": "100.0%",
+  "commitTypes": [
+    { "type": "feat", "count": 5 },
+    { "type": "fix", "count": 5 }
+  ],
+  "topScopes": [
+    { "scope": "main", "count": 8 }
+  ],
+  "breakingChanges": 0,
+  "recentReleases": [
+    { "tag": "v2.0.1", "date": "2025-11-24" }
+  ],
+  "releaseFrequency": "8 releases since 2025-11-01"
+}
+```
+
 ## Use Cases
 
 ### Sprint Retrospectives

src/git-metrics.ts

@@ -211,6 +211,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["repo_path"],
       },
     },
+    {
+      name: "get_conventional_commits",
+      description: "Analyze conventional commit usage and release patterns",
+      inputSchema: {
+        type: "object",
+        properties: {
+          repo_path: { type: "string", description: "Path to git repository" },
+          since: { type: "string", description: "Start date (YYYY-MM-DD)" },
+        },
+        required: ["repo_path", "since"],
+      },
+    },
   ],
 }));
 
@@ -244,6 +256,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       result = handlers.handleGetQualityMetrics(args);
     } else if (request.params.name === "get_technical_debt") {
       result = handlers.handleGetTechnicalDebt(args);
+    } else if (request.params.name === "get_conventional_commits") {
+      result = handlers.handleGetConventionalCommits(args);
     } else {
       log('ERROR', 'Unknown tool', { tool: toolName });
       throw new Error(`Unknown tool: ${request.params.name}`);

src/handlers.ts

@@ -349,3 +349,54 @@ export function handleGetTechnicalDebt(args: any) {
     complexityHotspots: largeFiles.sort((a, b) => b.churn - a.churn).slice(0, 10),
   };
 }
+
+export function handleGetConventionalCommits(args: any) {
+  const { repo_path, since } = args;
+  
+  validateRepoPath(repo_path);
+  validateDate(since, "since");
+  
+  const cmd = `git log --since="${since}" --pretty=format:"%H|%s|%ad" --date=short`;
+  const output = runGitCommand(repo_path, cmd);
+  const lines = output.trim().split("\n").filter(l => l);
+  
+  const types: Record<string, number> = {};
+  const scopes: Record<string, number> = {};
+  let breaking = 0;
+  let conventional = 0;
+  
+  const conventionalRegex = /^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(([^)]+)\))?(!)?:/;
+  
+  for (const line of lines) {
+    const [hash, message, date] = line.split("|");
+    const match = message.match(conventionalRegex);
+    
+    if (match) {
+      conventional++;
+      const [, type, , scope, isBreaking] = match;
+      types[type] = (types[type] || 0) + 1;
+      if (scope) scopes[scope] = (scopes[scope] || 0) + 1;
+      if (isBreaking || message.includes("BREAKING CHANGE")) breaking++;
+    }
+  }
+  
+  const tagsCmd = `git tag --sort=-creatordate --format="%(refname:short)|%(creatordate:short)"`;
+  const tagsOutput = runGitCommand(repo_path, tagsCmd);
+  const tags = tagsOutput.trim().split("\n").filter(t => t).slice(0, 20);
+  
+  const releases = tags.map(t => {
+    const [tag, date] = t.split("|");
+    return { tag, date };
+  });
+  
+  return {
+    totalCommits: lines.length,
+    conventionalCommits: conventional,
+    conventionalPercentage: `${((conventional / lines.length) * 100).toFixed(1)}%`,
+    commitTypes: Object.entries(types).sort(([,a], [,b]) => b - a).map(([type, count]) => ({ type, count })),
+    topScopes: Object.entries(scopes).sort(([,a], [,b]) => b - a).slice(0, 10).map(([scope, count]) => ({ scope, count })),
+    breakingChanges: breaking,
+    recentReleases: releases,
+    releaseFrequency: releases.length > 1 ? `${releases.length} releases since ${since}` : "No releases found"
+  };
+}