Github Milestone CRUD

README.md

@@ -657,6 +657,28 @@ The following sets of tools are available:
   - `title`: Issue title (string, required)
   - `type`: Type of this issue (string, optional)
 
+- **create_milestone** - Create new milestone
+  - `description`: Milestone description (string, optional)
+  - `due_on`: Milestone due date in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ) (string, optional)
+  - `owner`: Repository owner (string, required)
+  - `repo`: Repository name (string, required)
+  - `state`: Milestone state (string, required)
+  - `title`: Milestone title (string, required)
+
+- **delete_milestone** - Delete milestone
+  - `milestone_number`: The number of the milestone to delete (number, required)
+  - `owner`: Repository owner (string, required)
+  - `repo`: Repository name (string, required)
+
+- **edit_milestone** - Edit milestone
+  - `description`: New milestone description (string, optional)
+  - `due_on`: New milestone due date in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ) (string, optional)
+  - `milestone_number`: The number of the milestone to edit (number, required)
+  - `owner`: Repository owner (string, required)
+  - `repo`: Repository name (string, required)
+  - `state`: New milestone state (string, optional)
+  - `title`: New milestone title (string, optional)
+
 - **get_issue** - Get issue details
   - `issue_number`: The number of the issue (number, required)
   - `owner`: The owner of the repository (string, required)
@@ -688,6 +710,15 @@ The following sets of tools are available:
   - `since`: Filter by date (ISO 8601 timestamp) (string, optional)
   - `state`: Filter by state, by default both open and closed issues are returned when not provided (string, optional)
 
+- **list_milestones** - List milestones
+  - `direction`: Sort direction (string, optional)
+  - `owner`: Repository owner (string, required)
+  - `page`: Page number for pagination (min 1) (number, optional)
+  - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
+  - `repo`: Repository name (string, required)
+  - `sort`: Sort field (string, optional)
+  - `state`: Filter by state (string, optional)
+
 - **list_label** - List labels from a repository or an issue
   - `issue_number`: Issue number - if provided, lists labels on the specific issue (number, optional)
   - `owner`: Repository owner (username or organization name) - required for all operations (string, required)
@@ -723,6 +754,12 @@ The following sets of tools are available:
   - `repo`: Optional repository name. If provided with owner, only issues for this repository are listed. (string, optional)
   - `sort`: Sort field by number of matches of categories, defaults to best match (string, optional)
 
+- **search_milestones** - Search milestones
+  - `owner`: Repository owner (string, required)
+  - `query`: Search query to filter milestones by title or description (string, required)
+  - `repo`: Repository name (string, required)
+  - `state`: Filter by state (string, optional)
+
 - **update_issue** - Edit issue
   - `assignees`: New assignees (string[], optional)
   - `body`: New description (string, optional)

pkg/github/__toolsnaps__/create_milestone.snap

@@ -0,0 +1,47 @@
+{
+  "annotations": {
+    "title": "Create new milestone",
+    "readOnlyHint": false
+  },
+  "description": "Create a new milestone in a GitHub repository.",
+  "inputSchema": {
+    "properties": {
+      "description": {
+        "description": "Milestone description",
+        "type": "string"
+      },
+      "due_on": {
+        "description": "Milestone due date in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ)",
+        "type": "string"
+      },
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      },
+      "state": {
+        "description": "Milestone state",
+        "enum": [
+          "open",
+          "closed"
+        ],
+        "type": "string"
+      },
+      "title": {
+        "description": "Milestone title",
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo",
+      "title",
+      "state"
+    ],
+    "type": "object"
+  },
+  "name": "create_milestone"
+}

pkg/github/__toolsnaps__/delete_milestone.snap

@@ -0,0 +1,30 @@
+{
+  "annotations": {
+    "title": "Delete milestone",
+    "readOnlyHint": false
+  },
+  "description": "Delete a milestone from a GitHub repository.",
+  "inputSchema": {
+    "properties": {
+      "milestone_number": {
+        "description": "The number of the milestone to delete",
+        "type": "number"
+      },
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo",
+      "milestone_number"
+    ],
+    "type": "object"
+  },
+  "name": "delete_milestone"
+}

pkg/github/__toolsnaps__/edit_milestone.snap

@@ -0,0 +1,50 @@
+{
+  "annotations": {
+    "title": "Edit milestone",
+    "readOnlyHint": false
+  },
+  "description": "Edit an existing milestone in a GitHub repository.",
+  "inputSchema": {
+    "properties": {
+      "description": {
+        "description": "New milestone description",
+        "type": "string"
+      },
+      "due_on": {
+        "description": "New milestone due date in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ)",
+        "type": "string"
+      },
+      "milestone_number": {
+        "description": "The number of the milestone to edit",
+        "type": "number"
+      },
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      },
+      "state": {
+        "description": "New milestone state",
+        "enum": [
+          "open",
+          "closed"
+        ],
+        "type": "string"
+      },
+      "title": {
+        "description": "New milestone title",
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo",
+      "milestone_number"
+    ],
+    "type": "object"
+  },
+  "name": "edit_milestone"
+}

pkg/github/__toolsnaps__/list_milestones.snap

@@ -0,0 +1,61 @@
+{
+  "annotations": {
+    "title": "List milestones",
+    "readOnlyHint": true
+  },
+  "description": "List milestones for a repository.",
+  "inputSchema": {
+    "properties": {
+      "direction": {
+        "description": "Sort direction",
+        "enum": [
+          "asc",
+          "desc"
+        ],
+        "type": "string"
+      },
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "page": {
+        "description": "Page number for pagination (min 1)",
+        "minimum": 1,
+        "type": "number"
+      },
+      "perPage": {
+        "description": "Results per page for pagination (min 1, max 100)",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "number"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      },
+      "sort": {
+        "description": "Sort field",
+        "enum": [
+          "due_on",
+          "completeness"
+        ],
+        "type": "string"
+      },
+      "state": {
+        "description": "Filter by state",
+        "enum": [
+          "open",
+          "closed",
+          "all"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  },
+  "name": "list_milestones"
+}

pkg/github/__toolsnaps__/search_milestones.snap

@@ -0,0 +1,39 @@
+{
+  "annotations": {
+    "title": "Search milestones",
+    "readOnlyHint": true
+  },
+  "description": "Search for milestones in a repository.",
+  "inputSchema": {
+    "properties": {
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "query": {
+        "description": "Search query to filter milestones by title or description",
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      },
+      "state": {
+        "description": "Filter by state",
+        "enum": [
+          "open",
+          "closed",
+          "all"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo",
+      "query"
+    ],
+    "type": "object"
+  },
+  "name": "search_milestones"
+}