mcp-git-issue-priority 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 steiner385
+
+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

@@ -0,0 +1,412 @@
+# MCP GitHub Issue Priority Server
+
+A Model Context Protocol (MCP) server that enables AI assistants to manage GitHub issues with deterministic priority scoring and concurrency-safe selection.
+
+## Quick Start
+
+```bash
+# 1. Install from npm (recommended)
+npm install -g mcp-git-issue-priority
+
+# 2. Authenticate (if not already using GitHub CLI)
+gh auth login
+
+# 3. Add to Claude Code (~/.claude.json)
+```
+
+```json
+{
+  "mcpServers": {
+    "github-issue-priority": {
+      "command": "mcp-git-issue-priority"
+    }
+  }
+}
+```
+
+```bash
+# 4. Restart Claude Code and verify
+# The MCP tools should appear when you run /mcp
+```
+
+## Features
+
+- **Priority-Based Issue Selection**: Deterministic scoring algorithm ensures consistent issue prioritization across sessions
+- **Concurrency-Safe Locking**: File-based atomic locking prevents multiple AI sessions from selecting the same issue
+- **Guided Workflow**: 8-phase workflow (selection → research → branch → implementation → testing → commit → pr → review) with transition validation
+- **Automatic Labeling**: Creates and manages priority (`P0`-`P3`), type (`bug`, `feature`, `chore`, `docs`), and status labels
+- **Stale Lock Detection**: Automatically detects and cleans up locks from dead processes
+- **Audit Logging**: JSON Lines logging for all operations with 30-day retention
+
+## Installation
+
+### Prerequisites
+
+- **Node.js 20+** - [Download](https://nodejs.org/)
+- **GitHub CLI** (recommended) - [Install](https://cli.github.com/) and run `gh auth login`
+  - Or: a GitHub personal access token with `repo` scope
+
+### Install from npm (recommended)
+
+```bash
+npm install -g mcp-git-issue-priority
+```
+
+### Install specific version
+
+```bash
+npm install -g mcp-git-issue-priority@1.0.0
+```
+
+### Install from source
+
+```bash
+git clone https://github.com/steiner385/mcp-git-issue-priority.git
+cd mcp-git-issue-priority
+npm install && npm link
+```
+
+### Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| `command not found: mcp-git-issue-priority` | Ensure npm global bin is in your PATH: `npm bin -g` |
+| `GitHub authentication required` | Run `gh auth login` or set `GITHUB_TOKEN` |
+| Build errors during install | Ensure Node.js 20+ is installed: `node --version` |
+
+## Configuration
+
+### GitHub Authentication
+
+The server supports two authentication methods:
+
+#### Recommended: GitHub CLI (automatic)
+
+If you have [GitHub CLI](https://cli.github.com/) installed and authenticated, the server automatically retrieves your token:
+
+```bash
+# One-time setup
+gh auth login
+```
+
+This is the recommended approach - no manual token management required.
+
+#### Alternative: Environment Variable
+
+Set `GITHUB_TOKEN` with a [personal access token](https://github.com/settings/tokens) that has `repo` scope:
+
+```bash
+export GITHUB_TOKEN="ghp_your_personal_access_token"
+```
+
+Or configure it in your MCP settings (see below).
+
+### Claude Code Configuration
+
+Add to `~/.claude.json` (global) or `.claude/settings.json` (project):
+
+```json
+{
+  "mcpServers": {
+    "github-issue-priority": {
+      "command": "mcp-git-issue-priority"
+    }
+  }
+}
+```
+
+**Using a personal access token instead of GitHub CLI?** Add the token to the config:
+
+```json
+{
+  "mcpServers": {
+    "github-issue-priority": {
+      "command": "mcp-git-issue-priority",
+      "env": {
+        "GITHUB_TOKEN": "ghp_your_personal_access_token"
+      }
+    }
+  }
+}
+```
+
+### Verify Installation
+
+After restarting Claude Code:
+
+1. Run `/mcp` to see available MCP servers
+2. The `github-issue-priority` server should be listed with 13 tools
+3. Try `list_backlog` on any repository to confirm it's working
+
+## Available Tools
+
+### `create_issue`
+
+Create a new GitHub issue with mandatory priority and type labels.
+
+```
+Arguments:
+  - title (required): Issue title
+  - body (optional): Issue description
+  - priority (required): P0 (critical) | P1 (high) | P2 (medium) | P3 (low)
+  - type (required): bug | feature | chore | docs
+  - repository (required): "owner/repo" format
+```
+
+### `select_next_issue`
+
+Select and lock the highest-priority issue from the backlog. Uses deterministic scoring to ensure consistent selection.
+
+```
+Arguments:
+  - repository (required): "owner/repo" format
+  - type (optional): Filter by issue type
+  - maxPriority (optional): Only consider issues at or above this priority
+```
+
+### `list_backlog`
+
+List all open issues in priority order without acquiring locks (read-only).
+
+```
+Arguments:
+  - repository (required): "owner/repo" format
+  - type (optional): Filter by issue type
+  - limit (optional): Maximum issues to return (default: 20)
+```
+
+### `advance_workflow`
+
+Advance the workflow to the next phase for a locked issue.
+
+```
+Arguments:
+  - issueNumber (required): Issue number to advance
+  - targetPhase (required): research | branch | implementation | testing | commit | pr | review
+  - repository (required): "owner/repo" format
+  - testsPassed (optional): Required when advancing to 'commit' phase
+  - prTitle (optional): Required for 'pr' phase
+  - prBody (optional): Required for 'pr' phase
+  - skipJustification (optional): Required if skipping phases
+```
+
+### `get_workflow_status`
+
+Get the current workflow status for locked issues.
+
+```
+Arguments:
+  - issueNumber (optional): Specific issue number
+  - repository (optional): "owner/repo" format
+```
+
+### `release_lock`
+
+Release lock on an issue (on completion, abandonment, or merge).
+
+```
+Arguments:
+  - issueNumber (required): Issue number
+  - reason (required): completed | abandoned | merged
+  - repository (required): "owner/repo" format
+```
+
+### `force_claim`
+
+Force claim an issue locked by another session (requires confirmation).
+
+```
+Arguments:
+  - issueNumber (required): Issue number to claim
+  - confirmation (required): Must be exactly "I understand this may cause conflicts"
+  - repository (required): "owner/repo" format
+```
+
+### `sync_backlog_labels`
+
+Detect and optionally fix issues missing required priority/type/status labels.
+
+```
+Arguments:
+  - repository (required): "owner/repo" format
+  - mode (optional): "report" (default) to list issues, "update" to apply labels
+  - defaultPriority (optional): P0 | P1 | P2 | P3 (defaults to P2)
+  - defaultType (optional): bug | feature | chore | docs (defaults to feature)
+```
+
+In **report mode**, returns a list of all issues missing labels with details about what's missing.
+
+In **update mode**, applies default labels to issues:
+- Missing priority → `priority:P2` (or specified default)
+- Missing type → `type:feature` (or specified default)
+- Missing status → `status:backlog`
+
+### `get_pr_status`
+
+Check CI status, approval state, and merge state of a pull request.
+
+```
+Arguments:
+  - repository (required): "owner/repo" format
+  - prNumber (required): Pull request number to check
+```
+
+### `bulk_update_issues`
+
+Add/remove labels and close/reopen multiple issues at once.
+
+```
+Arguments:
+  - repository (required): "owner/repo" format
+  - issues (required): Array of issue numbers (1-50)
+  - addLabels (optional): Labels to add
+  - removeLabels (optional): Labels to remove
+  - state (optional): "open" | "closed"
+```
+
+### `implement_batch`
+
+Start implementing a batch of N issues in priority order. Returns the first issue to implement.
+
+```
+Arguments:
+  - repository (required): "owner/repo" format
+  - count (required): Number of issues to implement (1-10)
+  - includeTypes (optional): Only include these issue types
+  - excludeTypes (optional): Exclude these issue types
+  - maxPriority (optional): Only P0, P1, etc.
+```
+
+### `batch_continue`
+
+Continue batch implementation. Polls for PR merge, then returns next issue or completion.
+
+```
+Arguments:
+  - batchId (required): Batch ID from implement_batch
+  - prNumber (optional): PR number for current issue
+```
+
+### `get_workflow_analytics`
+
+Get time-based workflow analytics: cycle time, phase breakdown, aging reports.
+
+```
+Arguments:
+  - repository (required): "owner/repo" format
+  - period (optional): "7d" | "30d" | "90d" | "all" (default: 30d)
+```
+
+## Priority Scoring Algorithm
+
+Issues are scored using a deterministic formula:
+
+```
+score = (basePoints + ageBonus) * blockingMultiplier * blockedPenalty
+```
+
+- **Base Points**: P0=1000, P1=100, P2=10, P3=1
+- **Age Bonus**: +1 point per day since creation (max 365)
+- **Blocking Multiplier**: 1.5x for issues with "blocking" label
+- **Blocked Penalty**: 0.1x for issues blocked by open parent issues (via GitHub sub-issues)
+- **Tiebreaker**: Earlier creation date wins (FIFO)
+
+### Dependency Detection
+
+Issues with open parent issues (using GitHub's sub-issues feature) are automatically deprioritized with a 0.1x penalty. This ensures that blocked work sinks to the bottom of the backlog until its dependencies are resolved. Once a parent issue is closed, the child issue's priority returns to normal.
+
+## Workflow Phases
+
+1. **selection**: Issue selected and locked
+2. **research**: Understanding the problem
+3. **branch**: Feature branch created
+4. **implementation**: Code changes in progress
+5. **testing**: Running tests and validation
+6. **commit**: Changes committed
+7. **pr**: Pull request created
+8. **review**: Awaiting review/merge
+
+## Data Storage
+
+All data is stored locally in `~/.mcp-git-issue-priority/`:
+
+```
+~/.mcp-git-issue-priority/
+├── locks/          # Active lock files (.lockdata)
+├── workflow/       # Workflow state files (.json)
+└── logs/           # Audit logs (JSON Lines format)
+```
+
+## Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Test
+
+```bash
+npm test
+```
+
+### Lint
+
+```bash
+npm run lint
+```
+
+### Type Check
+
+```bash
+npm run typecheck
+```
+
+## Releasing (Maintainers)
+
+### One-time Setup
+
+1. Create an npm account at https://www.npmjs.com/
+2. Go to https://www.npmjs.com/settings/tokens
+3. Create an "Automation" token with "Publish" permission
+4. Add to GitHub: Settings → Secrets → Actions → New secret named `NPM_TOKEN`
+
+### Creating a Release
+
+```bash
+# Patch release (bug fixes): 1.0.0 → 1.0.1
+npm version patch -m "Release v%s"
+git push && git push --tags
+
+# Minor release (new features): 1.0.0 → 1.1.0
+npm version minor -m "Release v%s"
+git push && git push --tags
+
+# Major release (breaking changes): 1.0.0 → 2.0.0
+npm version major -m "Release v%s"
+git push && git push --tags
+```
+
+Pushing a tag triggers the release workflow which:
+- Runs lint, build, and tests
+- Creates a GitHub release with the tarball attached
+- Publishes to npm registry
+
+### Download Tracking
+
+- **GitHub**: Releases page shows download count per `.tgz` asset
+- **npm**: https://www.npmjs.com/package/mcp-git-issue-priority shows weekly downloads
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## Support
+
+- [Open an issue](https://github.com/steiner385/mcp-git-issue-priority/issues) for bug reports or feature requests
+- Check existing issues before creating new ones

package/dist/config/index.d.ts

@@ -0,0 +1,20 @@
+export interface Config {
+    baseDir: string;
+    locksDir: string;
+    workflowDir: string;
+    logsDir: string;
+    githubToken: string;
+    sessionId: string;
+}
+export declare function getBaseDir(): string;
+export declare function getLocksDir(): string;
+export declare function getWorkflowDir(): string;
+export declare function getLogsDir(): string;
+export declare function getBatchesDir(): string;
+export declare function ensureDirectories(): Promise<void>;
+export declare function generateSessionId(): string;
+export declare function createConfig(githubToken?: string): Config;
+export declare function getConfig(): Config;
+export declare function setConfig(config: Config): void;
+export declare function resetConfig(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAkBD,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBzD;AAID,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/config/index.js

@@ -0,0 +1,76 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdir } from 'fs/promises';
+import { execFileSync } from 'child_process';
+const BASE_DIR_NAME = '.mcp-git-issue-priority';
+export function getBaseDir() {
+    return join(homedir(), BASE_DIR_NAME);
+}
+export function getLocksDir() {
+    return join(getBaseDir(), 'locks');
+}
+export function getWorkflowDir() {
+    return join(getBaseDir(), 'workflow');
+}
+export function getLogsDir() {
+    return join(getBaseDir(), 'logs');
+}
+export function getBatchesDir() {
+    return join(getBaseDir(), 'batches');
+}
+export async function ensureDirectories() {
+    const dirs = [getBaseDir(), getLocksDir(), getWorkflowDir(), getLogsDir(), getBatchesDir()];
+    for (const dir of dirs) {
+        await mkdir(dir, { recursive: true });
+    }
+}
+export function generateSessionId() {
+    return crypto.randomUUID();
+}
+/**
+ * Attempts to get a GitHub token from the GitHub CLI (`gh auth token`).
+ * Returns null if gh is not installed or not authenticated.
+ */
+function getGitHubCliToken() {
+    try {
+        const token = execFileSync('gh', ['auth', 'token'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return token || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function createConfig(githubToken) {
+    // Try sources in order: explicit param, env var, GitHub CLI
+    const token = githubToken ?? process.env.GITHUB_TOKEN ?? getGitHubCliToken();
+    if (!token) {
+        throw new Error('GitHub authentication required. Either:\n' +
+            '  1. Set GITHUB_TOKEN environment variable, or\n' +
+            '  2. Install and authenticate GitHub CLI: gh auth login');
+    }
+    return {
+        baseDir: getBaseDir(),
+        locksDir: getLocksDir(),
+        workflowDir: getWorkflowDir(),
+        logsDir: getLogsDir(),
+        githubToken: token,
+        sessionId: generateSessionId(),
+    };
+}
+let globalConfig = null;
+export function getConfig() {
+    if (!globalConfig) {
+        globalConfig = createConfig();
+    }
+    return globalConfig;
+}
+export function setConfig(config) {
+    globalConfig = config;
+}
+export function resetConfig() {
+    globalConfig = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAW7C,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAEhD,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,EAAE,cAAc,EAAE,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAC5F,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;YAClD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,IAAI,IAAI,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAoB;IAC/C,4DAA4D;IAC5D,MAAM,KAAK,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,iBAAiB,EAAE,CAAC;IAC7E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,2CAA2C;YACzC,kDAAkD;YAClD,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,UAAU,EAAE;QACrB,QAAQ,EAAE,WAAW,EAAE;QACvB,WAAW,EAAE,cAAc,EAAE;QAC7B,OAAO,EAAE,UAAU,EAAE;QACrB,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,iBAAiB,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,YAAY,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createConfig, ensureDirectories, setConfig } from './config/index.js';
+import { initializeLogger } from './services/logging.js';
+import { initializeGitHubService } from './services/github.js';
+import { registerCreateIssueTool } from './tools/create-issue.js';
+import { registerSelectNextIssueTool } from './tools/select-next-issue.js';
+import { registerAdvanceWorkflowTool } from './tools/advance-workflow.js';
+import { registerReleaseLockTool } from './tools/release-lock.js';
+import { registerForceClaimTool } from './tools/force-claim.js';
+import { registerGetWorkflowStatusTool } from './tools/get-workflow-status.js';
+import { registerListBacklogTool } from './tools/list-backlog.js';
+import { registerSyncBacklogLabelsTool } from './tools/sync-backlog-labels.js';
+import { registerGetPrStatusTool } from './tools/get-pr-status.js';
+import { registerBulkUpdateIssuesTool } from './tools/bulk-update-issues.js';
+import { registerImplementBatchTool } from './tools/implement-batch.js';
+import { registerBatchContinueTool } from './tools/batch-continue.js';
+import { registerGetWorkflowAnalyticsTool } from './tools/get-workflow-analytics.js';
+async function main() {
+    try {
+        const config = createConfig();
+        setConfig(config);
+        await ensureDirectories();
+        initializeLogger(config.sessionId);
+        initializeGitHubService(config.githubToken);
+        const server = new McpServer({
+            name: 'mcp-git-issue-priority',
+            version: '1.0.0',
+        });
+        registerCreateIssueTool(server);
+        registerSelectNextIssueTool(server);
+        registerAdvanceWorkflowTool(server);
+        registerReleaseLockTool(server);
+        registerForceClaimTool(server);
+        registerGetWorkflowStatusTool(server);
+        registerListBacklogTool(server);
+        registerSyncBacklogLabelsTool(server);
+        registerGetPrStatusTool(server);
+        registerBulkUpdateIssuesTool(server);
+        registerImplementBatchTool(server);
+        registerBatchContinueTool(server);
+        registerGetWorkflowAnalyticsTool(server);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error(`MCP Issue Priority Server started (session: ${config.sessionId})`);
+    }
+    catch (error) {
+        console.error('Failed to start MCP server:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AAErF,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,SAAS,CAAC,MAAM,CAAC,CAAC;QAElB,MAAM,iBAAiB,EAAE,CAAC;QAE1B,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,uBAAuB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAEH,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,2BAA2B,CAAC,MAAM,CAAC,CAAC;QACpC,2BAA2B,CAAC,MAAM,CAAC,CAAC;QACpC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC/B,6BAA6B,CAAC,MAAM,CAAC,CAAC;QACtC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,6BAA6B,CAAC,MAAM,CAAC,CAAC;QACtC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,4BAA4B,CAAC,MAAM,CAAC,CAAC;QACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACnC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAClC,gCAAgC,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,OAAO,CAAC,KAAK,CAAC,+CAA+C,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/models/audit-log.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import type { WorkflowPhase } from './workflow-state.js';
+export declare const AuditLogLevelSchema: z.ZodEnum<["info", "warn", "error"]>;
+export type AuditLogLevel = z.infer<typeof AuditLogLevelSchema>;
+export declare const AuditLogOutcomeSchema: z.ZodEnum<["success", "failure", "skipped"]>;
+export type AuditLogOutcome = z.infer<typeof AuditLogOutcomeSchema>;
+export declare const AuditLogEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    level: z.ZodEnum<["info", "warn", "error"]>;
+    tool: z.ZodString;
+    sessionId: z.ZodString;
+    repoFullName: z.ZodOptional<z.ZodString>;
+    issueNumber: z.ZodOptional<z.ZodNumber>;
+    phase: z.ZodOptional<z.ZodEnum<["selection", "research", "branch", "implementation", "testing", "commit", "pr", "review", "merged", "abandoned"]>>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    outcome: z.ZodEnum<["success", "failure", "skipped"]>;
+    error: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    timestamp: string;
+    level: "info" | "warn" | "error";
+    tool: string;
+    outcome: "success" | "failure" | "skipped";
+    issueNumber?: number | undefined;
+    repoFullName?: string | undefined;
+    error?: string | undefined;
+    phase?: "selection" | "research" | "branch" | "implementation" | "testing" | "commit" | "pr" | "review" | "merged" | "abandoned" | undefined;
+    duration?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    sessionId: string;
+    timestamp: string;
+    level: "info" | "warn" | "error";
+    tool: string;
+    outcome: "success" | "failure" | "skipped";
+    issueNumber?: number | undefined;
+    repoFullName?: string | undefined;
+    error?: string | undefined;
+    phase?: "selection" | "research" | "branch" | "implementation" | "testing" | "commit" | "pr" | "review" | "merged" | "abandoned" | undefined;
+    duration?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type AuditLogEntry = z.infer<typeof AuditLogEntrySchema>;
+export declare function createAuditLogEntry(tool: string, sessionId: string, outcome: AuditLogOutcome, options?: {
+    level?: AuditLogLevel;
+    repoFullName?: string;
+    issueNumber?: number;
+    phase?: WorkflowPhase;
+    duration?: number;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}): AuditLogEntry;
+export declare function serializeLogEntry(entry: AuditLogEntry): string;
+export declare function parseLogEntry(line: string): AuditLogEntry | null;
+export declare function getLogFileName(date?: Date): string;
+//# sourceMappingURL=audit-log.d.ts.map

package/dist/models/audit-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../src/models/audit-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,eAAO,MAAM,mBAAmB,sCAAoC,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB,8CAA4C,CAAC;AAC/E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GACA,aAAa,CAcf;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQhE;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAG9D"}