mcp-git-issue-priority 1.0.0

package/dist/tools/sync-backlog-labels.js

@@ -0,0 +1,164 @@
+import { z } from 'zod';
+import { getGitHubService } from '../services/github.js';
+import { getLogger } from '../services/logging.js';
+function parseRepository(repository) {
+    if (!repository)
+        return null;
+    const [owner, repo] = repository.split('/');
+    if (!owner || !repo)
+        return null;
+    return { owner, repo };
+}
+export function registerSyncBacklogLabelsTool(server) {
+    server.tool('sync_backlog_labels', 'Detect and optionally fix issues missing required priority/type labels', {
+        repository: z
+            .string()
+            .regex(/^[^/]+\/[^/]+$/)
+            .describe("Repository in 'owner/repo' format"),
+        mode: z
+            .enum(['report', 'update'])
+            .default('report')
+            .describe("'report' to list issues, 'update' to apply default labels"),
+        defaultPriority: z
+            .enum(['P0', 'P1', 'P2', 'P3'])
+            .optional()
+            .describe('Default priority to apply when updating (defaults to P2)'),
+        defaultType: z
+            .enum(['bug', 'feature', 'chore', 'docs'])
+            .optional()
+            .describe('Default type to apply when updating (defaults to feature)'),
+    }, async (args) => {
+        const startTime = Date.now();
+        const logger = getLogger();
+        const github = getGitHubService();
+        const parsed = parseRepository(args.repository);
+        if (!parsed) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: 'Invalid repository format', code: 'INVALID_REPO' }) }],
+                isError: true,
+            };
+        }
+        const { owner, repo } = parsed;
+        const repoFullName = `${owner}/${repo}`;
+        try {
+            // Ensure all required labels exist in the repo
+            await github.ensureLabelsExist(owner, repo);
+            // Get all open issues
+            const issues = await github.listOpenIssues(owner, repo);
+            // Analyze each issue for missing labels
+            const issuesWithProblems = [];
+            for (const issue of issues) {
+                const labelNames = issue.labels.map((l) => l.name.toLowerCase());
+                const hasPriority = labelNames.some((l) => ['priority:p0', 'priority:p1', 'priority:p2', 'priority:p3'].includes(l));
+                const hasType = labelNames.some((l) => ['type:bug', 'type:feature', 'type:chore', 'type:docs'].includes(l));
+                const hasStatus = labelNames.some((l) => ['status:backlog', 'status:in-progress', 'status:in-review'].includes(l));
+                if (!hasPriority || !hasType || !hasStatus) {
+                    issuesWithProblems.push({
+                        number: issue.number,
+                        title: issue.title,
+                        url: issue.html_url,
+                        missingPriority: !hasPriority,
+                        missingType: !hasType,
+                        missingStatus: !hasStatus,
+                        currentLabels: issue.labels.map((l) => l.name),
+                    });
+                }
+            }
+            // If update mode, apply default labels
+            const updates = [];
+            if (args.mode === 'update' && issuesWithProblems.length > 0) {
+                const defaultPriority = args.defaultPriority ?? 'P2';
+                const defaultType = args.defaultType ?? 'feature';
+                for (const issue of issuesWithProblems) {
+                    const labelsToAdd = [];
+                    if (issue.missingPriority) {
+                        labelsToAdd.push(`priority:${defaultPriority}`);
+                    }
+                    if (issue.missingType) {
+                        labelsToAdd.push(`type:${defaultType}`);
+                    }
+                    if (issue.missingStatus) {
+                        labelsToAdd.push('status:backlog');
+                    }
+                    if (labelsToAdd.length > 0) {
+                        await github.updateIssueLabel(owner, repo, issue.number, labelsToAdd, []);
+                        updates.push({
+                            issueNumber: issue.number,
+                            labelsAdded: labelsToAdd,
+                        });
+                    }
+                }
+            }
+            const duration = Date.now() - startTime;
+            await logger.info('sync_backlog_labels', {
+                repoFullName,
+                duration,
+                metadata: {
+                    mode: args.mode,
+                    totalIssues: issues.length,
+                    issuesWithProblems: issuesWithProblems.length,
+                    issuesUpdated: updates.length,
+                },
+            });
+            const summary = {
+                totalIssues: issues.length,
+                issuesWithMissingLabels: issuesWithProblems.length,
+                breakdown: {
+                    missingPriority: issuesWithProblems.filter((i) => i.missingPriority).length,
+                    missingType: issuesWithProblems.filter((i) => i.missingType).length,
+                    missingStatus: issuesWithProblems.filter((i) => i.missingStatus).length,
+                },
+            };
+            if (args.mode === 'report') {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                mode: 'report',
+                                summary,
+                                issues: issuesWithProblems.map((i) => ({
+                                    number: i.number,
+                                    title: i.title,
+                                    url: i.url,
+                                    missing: {
+                                        priority: i.missingPriority,
+                                        type: i.missingType,
+                                        status: i.missingStatus,
+                                    },
+                                    currentLabels: i.currentLabels,
+                                })),
+                            }),
+                        }],
+                };
+            }
+            else {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                mode: 'update',
+                                summary,
+                                updates,
+                                defaults: {
+                                    priority: args.defaultPriority ?? 'P2',
+                                    type: args.defaultType ?? 'feature',
+                                    status: 'backlog',
+                                },
+                            }),
+                        }],
+                };
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            await logger.error('sync_backlog_labels', errorMessage, { repoFullName });
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: `Error: ${errorMessage}`, code: 'INTERNAL_ERROR' }) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=sync-backlog-labels.js.map

package/dist/tools/sync-backlog-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-backlog-labels.js","sourceRoot":"","sources":["../../src/tools/sync-backlog-labels.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "mcp-git-issue-priority",
+  "version": "1.0.0",
+  "description": "MCP server for GitHub issue prioritization and workflow management",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-git-issue-priority": "dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/steiner385/mcp-git-issue-priority.git"
+  },
+  "homepage": "https://github.com/steiner385/mcp-git-issue-priority#readme",
+  "bugs": {
+    "url": "https://github.com/steiner385/mcp-git-issue-priority/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src tests",
+    "format": "prettier --write src tests",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "github",
+    "issue-tracking",
+    "prioritization",
+    "workflow"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.0",
+    "@octokit/plugin-retry": "^7.0.0",
+    "@octokit/plugin-throttling": "^9.0.0",
+    "@octokit/rest": "^21.0.0",
+    "hono": "^4.11.7",
+    "proper-lockfile": "^4.1.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  }
+}