memory-journal-mcp 6.1.2 → 6.2.1

package/src/handlers/tools/github/milestone-tools.ts

@@ -1,371 +0,0 @@
-/**
- * GitHub Milestone Tools - 5 tools
- *
- * Tools: get_github_milestones, get_github_milestone,
- *        create_github_milestone, update_github_milestone, delete_github_milestone
- */
-
-import { z } from 'zod'
-import type { ToolDefinition, ToolContext } from '../../../types/index.js'
-import { formatHandlerError } from '../../../utils/error-helpers.js'
-import { milestoneCompletionPct } from '../../resources/shared.js'
-import {
-    GitHubMilestonesListOutputSchema,
-    GitHubMilestoneResultOutputSchema,
-    CreateMilestoneOutputSchema,
-    UpdateMilestoneOutputSchema,
-    DeleteMilestoneOutputSchema,
-} from './schemas.js'
-import { resolveOwnerRepo } from './helpers.js'
-
-// ============================================================================
-// Tool Definitions
-// ============================================================================
-
-export function getGitHubMilestoneTools(context: ToolContext): ToolDefinition[] {
-    return [
-        {
-            name: 'get_github_milestones',
-            title: 'List GitHub Milestones',
-            description:
-                'List GitHub milestones for the repository with completion percentages and due dates.',
-            group: 'github',
-            inputSchema: z.object({
-                state: z
-                    .string()
-                    .optional()
-                    .default('open')
-                    .describe('Filter by state (default: open)'),
-                limit: z
-                    .number()
-                    .optional()
-                    .default(20)
-                    .describe('Max milestones to return (default: 20)'),
-                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
-                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
-            }),
-            outputSchema: GitHubMilestonesListOutputSchema,
-            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            state: z.enum(['open', 'closed', 'all']).optional().default('open'),
-                            limit: z.number().optional().default(20),
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(
-                        context,
-                        input,
-                        'What GitHub repository should I list milestones for? Please provide the owner and repo name (e.g., owner/repo).'
-                    )
-                    if ('error' in resolved) return resolved.response
-
-                    const milestones = await resolved.github.getMilestones(
-                        resolved.owner,
-                        resolved.repo,
-                        input.state,
-                        input.limit
-                    )
-                    const milestonesWithPercentage = milestones.map((ms) => {
-                        const completionPercentage = milestoneCompletionPct(
-                            ms.openIssues,
-                            ms.closedIssues
-                        )
-                        return { ...ms, completionPercentage }
-                    })
-
-                    return {
-                        milestones: milestonesWithPercentage,
-                        count: milestonesWithPercentage.length,
-                        owner: resolved.owner,
-                        repo: resolved.repo,
-                        detectedOwner: resolved.detectedOwner,
-                        detectedRepo: resolved.detectedRepo,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-        {
-            name: 'get_github_milestone',
-            title: 'Get GitHub Milestone Details',
-            description:
-                'Get detailed information about a specific GitHub milestone including progress and linked issue counts.',
-            group: 'github',
-            inputSchema: z.object({
-                milestone_number: z.number().describe('Milestone number'),
-                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
-                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
-            }),
-            outputSchema: GitHubMilestoneResultOutputSchema,
-            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            milestone_number: z.number(),
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(
-                        context,
-                        input,
-                        'What GitHub repository is this milestone from? Please provide the owner and repo name (e.g., owner/repo).'
-                    )
-                    if ('error' in resolved) return resolved.response
-
-                    const milestone = await resolved.github.getMilestone(
-                        resolved.owner,
-                        resolved.repo,
-                        input.milestone_number
-                    )
-                    if (!milestone) {
-                        return {
-                            success: false,
-                            error: `Milestone #${String(input.milestone_number)} not found`,
-                            code: 'RESOURCE_NOT_FOUND',
-                            category: 'resource',
-                            suggestion: 'Verify the milestone number exists in this repository.',
-                            recoverable: true,
-                            owner: resolved.owner,
-                            repo: resolved.repo,
-                            detectedOwner: resolved.detectedOwner,
-                            detectedRepo: resolved.detectedRepo,
-                        }
-                    }
-
-                    const completionPercentage = milestoneCompletionPct(
-                        milestone.openIssues,
-                        milestone.closedIssues
-                    )
-
-                    return {
-                        milestone: { ...milestone, completionPercentage },
-                        owner: resolved.owner,
-                        repo: resolved.repo,
-                        detectedOwner: resolved.detectedOwner,
-                        detectedRepo: resolved.detectedRepo,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-        {
-            name: 'create_github_milestone',
-            title: 'Create GitHub Milestone',
-            description:
-                'Create a new GitHub milestone for tracking progress toward a project goal.',
-            group: 'github',
-            inputSchema: z.object({
-                title: z.string().min(1).describe('Milestone title'),
-                description: z.string().optional().describe('Milestone description'),
-                due_on: z.string().optional().describe('Due date in YYYY-MM-DD format (optional)'),
-                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
-                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
-            }),
-            outputSchema: CreateMilestoneOutputSchema,
-            annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: true },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            title: z.string().min(1),
-                            description: z.string().optional(),
-                            due_on: z.string().optional(),
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(
-                        context,
-                        input,
-                        'What GitHub repository should I create the milestone in?'
-                    )
-                    if ('error' in resolved) return resolved.response
-
-                    const dueOn = input.due_on ? `${input.due_on}T08:00:00Z` : undefined
-                    const milestone = await resolved.github.createMilestone(
-                        resolved.owner,
-                        resolved.repo,
-                        input.title,
-                        input.description,
-                        dueOn
-                    )
-
-                    if (!milestone) {
-                        return {
-                            success: false,
-                            error: 'Failed to create milestone. Check GITHUB_TOKEN permissions.',
-                            code: 'GITHUB_API_ERROR',
-                            category: 'github',
-                            suggestion: 'Verify GITHUB_TOKEN has repo scope and try again.',
-                            recoverable: true,
-                        }
-                    }
-
-                    return {
-                        success: true,
-                        milestone: { ...milestone, completionPercentage: 0 },
-                        message: `Created milestone #${String(milestone.number)}: ${milestone.title}`,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-        {
-            name: 'update_github_milestone',
-            title: 'Update GitHub Milestone',
-            description:
-                'Update a GitHub milestone (title, description, due date, or state). Use state "closed" to close a completed milestone.',
-            group: 'github',
-            inputSchema: z.object({
-                milestone_number: z.number().describe('Milestone number to update'),
-                title: z.string().optional().describe('New title'),
-                description: z.string().optional().describe('New description'),
-                due_on: z.string().optional().describe('New due date in YYYY-MM-DD format'),
-                state: z.string().optional().describe('Set to "closed" to close the milestone'),
-                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
-                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
-            }),
-            outputSchema: UpdateMilestoneOutputSchema,
-            annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: true },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            milestone_number: z.number(),
-                            title: z.string().optional(),
-                            description: z.string().optional(),
-                            due_on: z.string().optional(),
-                            state: z.enum(['open', 'closed']).optional(),
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(
-                        context,
-                        input,
-                        'What GitHub repository is this milestone in?'
-                    )
-                    if ('error' in resolved) return resolved.response
-
-                    const dueOn = input.due_on ? `${input.due_on}T08:00:00Z` : undefined
-                    const milestone = await resolved.github.updateMilestone(
-                        resolved.owner,
-                        resolved.repo,
-                        input.milestone_number,
-                        {
-                            title: input.title,
-                            description: input.description,
-                            dueOn,
-                            state: input.state,
-                        }
-                    )
-
-                    if (!milestone) {
-                        return {
-                            success: false,
-                            error: `Failed to update milestone #${String(input.milestone_number)}. Check that it exists and GITHUB_TOKEN has permissions.`,
-                            code: 'GITHUB_API_ERROR',
-                            category: 'github',
-                            suggestion:
-                                'Verify the milestone exists and GITHUB_TOKEN has repo scope.',
-                            recoverable: true,
-                        }
-                    }
-
-                    const completionPercentage = milestoneCompletionPct(
-                        milestone.openIssues,
-                        milestone.closedIssues
-                    )
-
-                    return {
-                        success: true,
-                        milestone: { ...milestone, completionPercentage },
-                        message: `Updated milestone #${String(milestone.number)}: ${milestone.title}`,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-        {
-            name: 'delete_github_milestone',
-            title: 'Delete GitHub Milestone',
-            description:
-                'Permanently delete a GitHub milestone. Issues assigned to the milestone will be un-assigned but not deleted.',
-            group: 'github',
-            inputSchema: z.object({
-                milestone_number: z.number().describe('Milestone number to delete'),
-                confirm: z.literal(true).describe('Must be set to true to confirm deletion'),
-                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
-                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
-            }),
-            outputSchema: DeleteMilestoneOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                idempotentHint: false,
-                destructiveHint: true,
-                openWorldHint: true,
-            },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            milestone_number: z.number(),
-                            confirm: z.literal(true),
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(
-                        context,
-                        input,
-                        'What GitHub repository is this milestone in?'
-                    )
-                    if ('error' in resolved) return resolved.response
-
-                    const result = await resolved.github.deleteMilestone(
-                        resolved.owner,
-                        resolved.repo,
-                        input.milestone_number
-                    )
-
-                    if (!result.success) {
-                        return {
-                            success: false,
-                            milestoneNumber: input.milestone_number,
-                            message: `Failed to delete milestone #${String(input.milestone_number)}`,
-                            error: result.error ?? undefined,
-                            code: 'GITHUB_API_ERROR',
-                            category: 'github',
-                            suggestion:
-                                'Verify the milestone exists and GITHUB_TOKEN has repo scope.',
-                            recoverable: true,
-                        }
-                    }
-
-                    return {
-                        success: true,
-                        milestoneNumber: input.milestone_number,
-                        message: `Deleted milestone #${String(input.milestone_number)}`,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-    ]
-}

package/src/handlers/tools/github/mutation-tools.ts

@@ -1,17 +0,0 @@
-/**
- * GitHub Mutation Tools - Barrel file
- *
- * Composes kanban tools and issue tools into a single export
- * for backward compatibility with existing imports.
- */
-
-import type { ToolDefinition, ToolContext } from '../../../types/index.js'
-import { getKanbanTools } from './kanban-tools.js'
-import { getGitHubIssueTools } from './issue-tools.js'
-
-/**
- * Get all GitHub mutation tools (kanban + issue management)
- */
-export function getGitHubMutationTools(context: ToolContext): ToolDefinition[] {
-    return [...getKanbanTools(context), ...getGitHubIssueTools(context)]
-}

package/src/handlers/tools/github/read-tools.ts

@@ -1,302 +0,0 @@
-/**
- * GitHub Read Tools - 5 tools
- *
- * Tools: get_github_issues, get_github_prs, get_github_issue, get_github_pr, get_github_context
- */
-
-import { z } from 'zod'
-import type { ToolDefinition, ToolContext } from '../../../types/index.js'
-import { formatHandlerError } from '../../../utils/error-helpers.js'
-import { relaxedNumber } from '../schemas.js'
-import {
-    GitHubIssuesListOutputSchema,
-    GitHubIssueResultOutputSchema,
-    GitHubPRsListOutputSchema,
-    GitHubPRResultOutputSchema,
-    GitHubContextOutputSchema,
-} from './schemas.js'
-import { resolveOwnerRepo } from './helpers.js'
-
-// ============================================================================
-// Tool Definitions
-// ============================================================================
-
-export function getGitHubReadTools(context: ToolContext): ToolDefinition[] {
-    return [
-        {
-            name: 'get_github_issues',
-            title: 'Get GitHub Issues',
-            description:
-                'List issues from a GitHub repository. IMPORTANT: Do NOT guess owner/repo values - leave them empty to auto-detect from the current git repository.',
-            group: 'github',
-            inputSchema: z.object({
-                owner: z
-                    .string()
-                    .optional()
-                    .describe(
-                        'Repository owner - LEAVE EMPTY to auto-detect from git. Only specify if user explicitly provides.'
-                    ),
-                repo: z
-                    .string()
-                    .optional()
-                    .describe(
-                        'Repository name - LEAVE EMPTY to auto-detect from git. Only specify if user explicitly provides.'
-                    ),
-                state: z.string().optional().default('open'),
-                limit: relaxedNumber().optional().default(20),
-            }),
-            outputSchema: GitHubIssuesListOutputSchema,
-            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                            state: z.enum(['open', 'closed', 'all']).optional().default('open'),
-                            limit: z.number().optional().default(20),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(
-                        context,
-                        input,
-                        'would you like to query'
-                    )
-                    if ('error' in resolved) return resolved.response
-
-                    const issues = await resolved.github.getIssues(
-                        resolved.owner,
-                        resolved.repo,
-                        input.state,
-                        input.limit
-                    )
-                    return {
-                        owner: resolved.owner,
-                        repo: resolved.repo,
-                        detectedOwner: resolved.detectedOwner,
-                        detectedRepo: resolved.detectedRepo,
-                        issues,
-                        count: issues.length,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-        {
-            name: 'get_github_prs',
-            title: 'Get GitHub Pull Requests',
-            description:
-                'List pull requests from a GitHub repository. IMPORTANT: Do NOT guess owner/repo values - leave them empty to auto-detect from the current git repository.',
-            group: 'github',
-            inputSchema: z.object({
-                owner: z
-                    .string()
-                    .optional()
-                    .describe(
-                        'Repository owner - LEAVE EMPTY to auto-detect from git. Only specify if user explicitly provides.'
-                    ),
-                repo: z
-                    .string()
-                    .optional()
-                    .describe(
-                        'Repository name - LEAVE EMPTY to auto-detect from git. Only specify if user explicitly provides.'
-                    ),
-                state: z.string().optional().default('open'),
-                limit: relaxedNumber().optional().default(20),
-            }),
-            outputSchema: GitHubPRsListOutputSchema,
-            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                            state: z.enum(['open', 'closed', 'all']).optional().default('open'),
-                            limit: z.number().optional().default(20),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(
-                        context,
-                        input,
-                        'would you like to query'
-                    )
-                    if ('error' in resolved) return resolved.response
-
-                    const pullRequests = await resolved.github.getPullRequests(
-                        resolved.owner,
-                        resolved.repo,
-                        input.state,
-                        input.limit
-                    )
-                    return {
-                        owner: resolved.owner,
-                        repo: resolved.repo,
-                        detectedOwner: resolved.detectedOwner,
-                        detectedRepo: resolved.detectedRepo,
-                        pullRequests,
-                        count: pullRequests.length,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-        {
-            name: 'get_github_issue',
-            title: 'Get GitHub Issue Details',
-            description:
-                'Get detailed information about a specific GitHub issue. IMPORTANT: Do NOT guess owner/repo values - leave them empty to auto-detect from the current git repository.',
-            group: 'github',
-            inputSchema: z.object({
-                issue_number: z.number(),
-                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
-                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
-            }),
-            outputSchema: GitHubIssueResultOutputSchema,
-            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            issue_number: z.number(),
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(context, input, 'is this issue from')
-                    if ('error' in resolved) return resolved.response
-
-                    const issue = await resolved.github.getIssue(
-                        resolved.owner,
-                        resolved.repo,
-                        input.issue_number
-                    )
-                    if (!issue) {
-                        return {
-                            success: false,
-                            error: `Issue #${String(input.issue_number)} not found`,
-                            code: 'RESOURCE_NOT_FOUND',
-                            category: 'resource',
-                            suggestion: 'Verify the issue number exists in this repository.',
-                            recoverable: true,
-                            owner: resolved.owner,
-                            repo: resolved.repo,
-                            detectedOwner: resolved.detectedOwner,
-                            detectedRepo: resolved.detectedRepo,
-                        }
-                    }
-                    return {
-                        issue,
-                        owner: resolved.owner,
-                        repo: resolved.repo,
-                        detectedOwner: resolved.detectedOwner,
-                        detectedRepo: resolved.detectedRepo,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-        {
-            name: 'get_github_pr',
-            title: 'Get GitHub PR Details',
-            description:
-                'Get detailed information about a specific GitHub pull request. IMPORTANT: Do NOT guess owner/repo values - leave them empty to auto-detect from the current git repository.',
-            group: 'github',
-            inputSchema: z.object({
-                pr_number: z.number(),
-                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
-                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
-            }),
-            outputSchema: GitHubPRResultOutputSchema,
-            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
-            handler: async (params: unknown) => {
-                try {
-                    const input = z
-                        .object({
-                            pr_number: z.number(),
-                            owner: z.string().optional(),
-                            repo: z.string().optional(),
-                        })
-                        .parse(params)
-
-                    const resolved = await resolveOwnerRepo(context, input, 'is this PR from')
-                    if ('error' in resolved) return resolved.response
-
-                    const pullRequest = await resolved.github.getPullRequest(
-                        resolved.owner,
-                        resolved.repo,
-                        input.pr_number
-                    )
-                    if (!pullRequest) {
-                        return {
-                            success: false,
-                            error: `PR #${String(input.pr_number)} not found`,
-                            code: 'RESOURCE_NOT_FOUND',
-                            category: 'resource',
-                            suggestion: 'Verify the PR number exists in this repository.',
-                            recoverable: true,
-                            owner: resolved.owner,
-                            repo: resolved.repo,
-                            detectedOwner: resolved.detectedOwner,
-                            detectedRepo: resolved.detectedRepo,
-                        }
-                    }
-                    return {
-                        pullRequest,
-                        owner: resolved.owner,
-                        repo: resolved.repo,
-                        detectedOwner: resolved.detectedOwner,
-                        detectedRepo: resolved.detectedRepo,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-        {
-            name: 'get_github_context',
-            title: 'Get GitHub Repository Context',
-            description:
-                'Get current repository context including branch, open issues, and open PRs. Only counts OPEN items (closed items excluded).',
-            group: 'github',
-            inputSchema: z.object({}).strict(),
-            outputSchema: GitHubContextOutputSchema,
-            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
-            handler: async (_params: unknown) => {
-                try {
-                    if (!context.github) {
-                        return {
-                            success: false,
-                            error: 'GitHub integration not available',
-                            code: 'CONFIGURATION_ERROR',
-                            category: 'configuration',
-                            suggestion:
-                                'Set GITHUB_TOKEN and GITHUB_REPO_PATH environment variables to enable GitHub integration.',
-                            recoverable: true,
-                        }
-                    }
-
-                    const ctx = await context.github.getRepoContext()
-                    return {
-                        repoName: ctx.repoName,
-                        branch: ctx.branch,
-                        commit: ctx.commit,
-                        remoteUrl: ctx.remoteUrl,
-                        issues: ctx.issues,
-                        pullRequests: ctx.pullRequests,
-                        issueCount: ctx.issues.length,
-                        prCount: ctx.pullRequests.length,
-                    }
-                } catch (err) {
-                    return formatHandlerError(err)
-                }
-            },
-        },
-    ]
-}