@fractary/core-mcp 0.1.1

package/dist/handlers/repo.js

@@ -0,0 +1,651 @@
+import { RepoManager } from '@fractary/core/repo';
+import { successResult, errorResult, isValidBranchLocation, isValidBranchType, isValidCommitType, isValidPrState, isValidReviewAction, isValidMergeStrategy, isValidIssueState, validateRepoConfig } from './helpers.js';
+/**
+ * NOTE: All handlers in this file validate config.repo before use
+ * Pattern: if (!validateRepoConfig(config)) { return errorResult(...) }
+ */
+// ============================================================================
+// Repository Status
+// ============================================================================
+export async function handleRepoStatus(_params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const status = await manager.getStatus();
+        return successResult(status);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error getting status: ${message}`);
+    }
+}
+export async function handleRepoBranchCurrent(_params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const branch = await manager.getCurrentBranch();
+        return successResult({ branch });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error getting current branch: ${message}`);
+    }
+}
+export async function handleRepoIsDirty(_params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const dirty = await manager.isDirty();
+        return successResult({ dirty });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error checking if dirty: ${message}`);
+    }
+}
+export async function handleRepoDiff(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const diff = await manager.getDiff({
+            staged: params.staged,
+            base: params.base,
+            head: params.head,
+        });
+        return successResult({ diff });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error getting diff: ${message}`);
+    }
+}
+// ============================================================================
+// Branch Operations
+// ============================================================================
+export async function handleRepoBranchCreate(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const branch = await manager.createBranch(params.name, {
+            baseBranch: params.base_branch,
+            fromProtected: params.from_protected,
+        });
+        return successResult(branch);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error creating branch: ${message}`);
+    }
+}
+export async function handleRepoBranchDelete(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        if (params.location && !isValidBranchLocation(params.location)) {
+            return errorResult(`Invalid location: ${params.location}. Must be 'local', 'remote', or 'both'`);
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.deleteBranch(params.name, {
+            force: params.force,
+            location: isValidBranchLocation(params.location) ? params.location : undefined,
+        });
+        return successResult({ deleted: true, branch: params.name });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error deleting branch: ${message}`);
+    }
+}
+export async function handleRepoBranchList(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const branches = await manager.listBranches({
+            pattern: params.pattern,
+            merged: params.merged,
+            limit: params.limit,
+        });
+        return successResult(branches);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error listing branches: ${message}`);
+    }
+}
+export async function handleRepoBranchGet(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const branch = await manager.getBranch(params.name);
+        if (!branch) {
+            return errorResult(`Branch not found: ${params.name}`);
+        }
+        return successResult(branch);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error getting branch: ${message}`);
+    }
+}
+export async function handleRepoCheckout(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.checkout(params.branch);
+        return successResult({ checked_out: params.branch });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error checking out branch: ${message}`);
+    }
+}
+export async function handleRepoBranchNameGenerate(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        if (!isValidBranchType(params.type)) {
+            return errorResult(`Invalid type: ${params.type}. Must be 'feature', 'fix', 'chore', or 'docs'`);
+        }
+        const manager = new RepoManager(config.repo);
+        const name = await manager.generateBranchName({
+            type: params.type,
+            description: params.description,
+            workId: params.work_id,
+        });
+        return successResult({ name });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error generating branch name: ${message}`);
+    }
+}
+// ============================================================================
+// Staging
+// ============================================================================
+export async function handleRepoStage(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.stage(params.patterns);
+        return successResult({ staged: params.patterns });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error staging files: ${message}`);
+    }
+}
+export async function handleRepoStageAll(_params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.stageAll();
+        return successResult({ staged_all: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error staging all files: ${message}`);
+    }
+}
+export async function handleRepoUnstage(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.unstage(params.patterns);
+        return successResult({ unstaged: params.patterns });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error unstaging files: ${message}`);
+    }
+}
+// ============================================================================
+// Commits
+// ============================================================================
+export async function handleRepoCommit(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        if (params.type && !isValidCommitType(params.type)) {
+            return errorResult(`Invalid type: ${params.type}. Must be 'feat', 'fix', 'docs', 'style', 'refactor', 'test', or 'chore'`);
+        }
+        const manager = new RepoManager(config.repo);
+        const commit = await manager.commit({
+            message: params.message,
+            type: isValidCommitType(params.type) ? params.type : undefined,
+            scope: params.scope,
+            body: params.body,
+            breaking: params.breaking,
+            workId: params.work_id,
+        });
+        return successResult(commit);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error creating commit: ${message}`);
+    }
+}
+export async function handleRepoCommitGet(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const commit = await manager.getCommit(params.ref);
+        return successResult(commit);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error getting commit: ${message}`);
+    }
+}
+export async function handleRepoCommitList(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const commits = await manager.listCommits({
+            limit: params.limit,
+            branch: params.branch,
+            since: params.since,
+            until: params.until,
+            author: params.author,
+        });
+        return successResult(commits);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error listing commits: ${message}`);
+    }
+}
+// ============================================================================
+// Push/Pull/Fetch
+// ============================================================================
+export async function handleRepoPush(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.push({
+            branch: params.branch,
+            remote: params.remote,
+            force: params.force,
+            setUpstream: params.set_upstream,
+        });
+        return successResult({ pushed: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error pushing: ${message}`);
+    }
+}
+export async function handleRepoPull(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.pull({
+            branch: params.branch,
+            remote: params.remote,
+            rebase: params.rebase,
+        });
+        return successResult({ pulled: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error pulling: ${message}`);
+    }
+}
+export async function handleRepoFetch(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.fetch(params.remote);
+        return successResult({ fetched: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error fetching: ${message}`);
+    }
+}
+// ============================================================================
+// Pull Requests
+// ============================================================================
+export async function handleRepoPrCreate(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const pr = await manager.createPR({
+            title: params.title,
+            body: params.body,
+            base: params.base,
+            head: params.head,
+            draft: params.draft,
+        });
+        return successResult(pr);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error creating PR: ${message}`);
+    }
+}
+export async function handleRepoPrGet(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const pr = await manager.getPR(params.number);
+        return successResult(pr);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error getting PR: ${message}`);
+    }
+}
+export async function handleRepoPrUpdate(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        if (params.state && !isValidPrState(params.state)) {
+            return errorResult(`Invalid state: ${params.state}. Must be 'open' or 'closed'`);
+        }
+        const manager = new RepoManager(config.repo);
+        const pr = await manager.updatePR(params.number, {
+            title: params.title,
+            body: params.body,
+            state: isValidPrState(params.state) ? params.state : undefined,
+        });
+        return successResult(pr);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error updating PR: ${message}`);
+    }
+}
+export async function handleRepoPrComment(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.addPRComment(params.number, params.body);
+        return successResult({ commented: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error commenting on PR: ${message}`);
+    }
+}
+export async function handleRepoPrReview(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        if (!isValidReviewAction(params.action)) {
+            return errorResult(`Invalid action: ${params.action}. Must be 'approve', 'request_changes', or 'comment'`);
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.reviewPR(params.number, {
+            action: params.action,
+            comment: params.comment,
+        });
+        return successResult({ reviewed: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error reviewing PR: ${message}`);
+    }
+}
+export async function handleRepoPrRequestReview(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.requestReview(params.number, params.reviewers);
+        return successResult({ requested: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error requesting review: ${message}`);
+    }
+}
+export async function handleRepoPrApprove(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.approvePR(params.number, params.comment);
+        return successResult({ approved: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error approving PR: ${message}`);
+    }
+}
+export async function handleRepoPrMerge(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        if (params.strategy && !isValidMergeStrategy(params.strategy)) {
+            return errorResult(`Invalid strategy: ${params.strategy}. Must be 'merge', 'squash', or 'rebase'`);
+        }
+        const manager = new RepoManager(config.repo);
+        const pr = await manager.mergePR(params.number, {
+            strategy: isValidMergeStrategy(params.strategy) ? params.strategy : undefined,
+            deleteBranch: params.delete_branch,
+        });
+        return successResult(pr);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error merging PR: ${message}`);
+    }
+}
+export async function handleRepoPrList(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        if (params.state && !isValidIssueState(params.state)) {
+            return errorResult(`Invalid state: ${params.state}. Must be 'open', 'closed', or 'all'`);
+        }
+        const manager = new RepoManager(config.repo);
+        const prs = await manager.listPRs({
+            state: isValidIssueState(params.state) ? params.state : undefined,
+            author: params.author,
+            limit: params.limit,
+        });
+        return successResult(prs);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error listing PRs: ${message}`);
+    }
+}
+// ============================================================================
+// Tags
+// ============================================================================
+export async function handleRepoTagCreate(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.createTag(params.name, {
+            name: params.name,
+            message: params.message,
+            sha: params.sha,
+            commit: params.commit,
+            sign: params.sign,
+            force: params.force,
+        });
+        return successResult({ tag: params.name, created: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error creating tag: ${message}`);
+    }
+}
+export async function handleRepoTagDelete(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.deleteTag(params.name);
+        return successResult({ tag: params.name, deleted: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error deleting tag: ${message}`);
+    }
+}
+export async function handleRepoTagPush(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.pushTag(params.name, params.remote);
+        return successResult({ tag: params.name, pushed: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error pushing tag: ${message}`);
+    }
+}
+export async function handleRepoTagList(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const tags = await manager.listTags({
+            pattern: params.pattern,
+            latest: params.latest,
+        });
+        return successResult(tags);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error listing tags: ${message}`);
+    }
+}
+// ============================================================================
+// Worktrees
+// ============================================================================
+export async function handleRepoWorktreeCreate(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const worktree = await manager.createWorktree({
+            path: params.path,
+            branch: params.branch,
+            baseBranch: params.base_branch,
+        });
+        return successResult(worktree);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error creating worktree: ${message}`);
+    }
+}
+export async function handleRepoWorktreeList(_params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const worktrees = await manager.listWorktrees();
+        return successResult(worktrees);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error listing worktrees: ${message}`);
+    }
+}
+export async function handleRepoWorktreeRemove(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.removeWorktree(params.path, params.force);
+        return successResult({ path: params.path, removed: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error removing worktree: ${message}`);
+    }
+}
+export async function handleRepoWorktreePrune(_params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        await manager.pruneWorktrees();
+        return successResult({ pruned: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error pruning worktrees: ${message}`);
+    }
+}
+export async function handleRepoWorktreeCleanup(params, config) {
+    try {
+        if (!validateRepoConfig(config)) {
+            return errorResult('Repository configuration is missing or incomplete. Please configure repo.platform and repo.token.');
+        }
+        const manager = new RepoManager(config.repo);
+        const result = await manager.cleanupWorktrees({
+            merged: params.merged,
+            force: params.force,
+            deleteBranch: params.delete_branch,
+        });
+        return successResult(result);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return errorResult(`Error cleaning up worktrees: ${message}`);
+    }
+}
+//# sourceMappingURL=repo.js.map