linear-toon-mcp 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4548c28ca6deb74cc3ea72d889aad5f931ed4d63265f9d742f8ad54b1af651b9
-  data.tar.gz: 8089aab524d5febf2207243b5de33524dc2a264fdc8624a009d1ed3fbf4ce9a0
+  metadata.gz: f153b22caa9c1df3508d6ee6e5e515c9233a45bb46e85cfe23dc4293f552eca1
+  data.tar.gz: 1b28577e054f4aa6759b1cd1a78f6ae189d78c94ec3f39b65abaaf28a4362128
 SHA512:
-  metadata.gz: 64044b9580eef34aab49067d721ee0435b38658a6bd99ba5594260457b1424beb4f9f3236de429986a6f099c2c60debfa9a72635538ac095f91f5440b343adf0
-  data.tar.gz: 2f679acce91253b8632c913c3be49bb0329aa8a2eb84538205a24ef248fcf7e0448b9ff0b8263087cbc39a993c23cf383f3868868ca94d7691b3c695051ebfbc
+  metadata.gz: 9edb2ad3b2bdec827ccd31c4bd18466e8d5c2e3ece9b6568d62ef21faa2262ffc7c3f4fdc98053993845485412f0ac2ed59ffb40db7478ff27668513dc716b6c
+  data.tar.gz: d765472c7885e39684d40ed9543fc73b30e8475c7e62af7cf6818d9bf61acf0fe6d135df2c500f71b54d7456d00e8c6ffac09f1f9dd0a92e5a3993b5e2adb4ec

data/README.md

@@ -68,6 +68,8 @@ Most parameters accept either a UUID or a human identifier (issue identifier lik
 | `get_project` | Retrieve a project by name, ID, or slug. Optional includes for members, milestones, and resources. |
 | `save_project` | Create or update a project. On create, `name` and `teams` (one or more) are required. Resolves names to IDs for teams, lead, members, labels, status, and initiative (initiative links on creation only — use `add_project_to_initiative` afterwards). |
 | `archive_project` | Archive a project (recoverable soft delete). Linear has no hard-delete for projects. |
+| `save_project_milestone` | Create or update a project milestone. On create, `name` and `project` are required. `sortOrder` positions the milestone among its siblings. `project` is create-only — this tool does not move milestones between projects, so it is rejected on update. |
+| `delete_project_milestone` | Delete a project milestone by ID. Issues assigned to it are detached, not deleted. |
 
 ### Initiatives
 

data/lib/linear_toon_mcp/tools/delete_project_milestone.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Tools
+    # Delete a project milestone by id. Issues assigned to the milestone
+    # are detached, not deleted.
+    class DeleteProjectMilestone < Delete
+      description "Delete a project milestone (issues are detached, not deleted)"
+
+      label "Milestone"
+
+      annotations(
+        read_only_hint: false,
+        destructive_hint: true,
+        idempotent_hint: false
+      )
+
+      input_schema(
+        properties: {
+          id: {type: "string", description: "Milestone ID"}
+        },
+        required: ["id"],
+        additionalProperties: false
+      )
+
+      MUTATION = <<~GRAPHQL
+        mutation($id: String!) {
+          projectMilestoneDelete(id: $id) { success entityId }
+        }
+      GRAPHQL
+
+      def variables(id:)
+        {id: id}
+      end
+    end
+  end
+end

data/lib/linear_toon_mcp/tools/save_project_milestone.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Tools
+    # Create or update a project milestone. +id+ presence determines
+    # create vs update. On create, +name+ and +project+ are required;
+    # +project+ is resolved via {Resolvers::Project}. +project+ is
+    # create-only — this tool does not move milestones between projects.
+    class SaveProjectMilestone < Base
+      description "Create or update a project milestone (id presence determines)"
+
+      annotations(
+        read_only_hint: false,
+        destructive_hint: false,
+        idempotent_hint: false
+      )
+
+      # standard:disable Layout/LineLength
+      input_schema(
+        properties: {
+          id: {type: "string", description: "Milestone ID. If provided, updates the existing milestone; otherwise creates"},
+          project: {type: "string", description: "Project name, ID, or slug (required when creating — rejected on update)"},
+          name: {type: "string", description: "Milestone name (required when creating)"},
+          description: {type: "string", description: "Description as Markdown"},
+          targetDate: {type: "string", description: "Target date (ISO format, YYYY-MM-DD)"},
+          sortOrder: {type: "number", description: "Position among the project's milestones — lower sorts first"}
+        },
+        additionalProperties: false
+      )
+      # standard:enable Layout/LineLength
+
+      RETURN_FIELDS = <<~GRAPHQL
+        id
+        name
+        description
+        targetDate
+        sortOrder
+        status
+        project { id name }
+      GRAPHQL
+
+      CREATE_MUTATION = <<~GRAPHQL
+        mutation($input: ProjectMilestoneCreateInput!) {
+          projectMilestoneCreate(input: $input) {
+            success
+            projectMilestone { #{RETURN_FIELDS.strip} }
+          }
+        }
+      GRAPHQL
+
+      UPDATE_MUTATION = <<~GRAPHQL
+        mutation($id: String!, $input: ProjectMilestoneUpdateInput!) {
+          projectMilestoneUpdate(id: $id, input: $input) {
+            success
+            projectMilestone { #{RETURN_FIELDS.strip} }
+          }
+        }
+      GRAPHQL
+
+      def perform(id: nil, **kwargs)
+        id ? update(id, kwargs) : create(kwargs)
+      end
+
+      private
+
+      def create(kwargs)
+        raise Error, "name is required when creating a milestone" unless kwargs[:name]
+        project = kwargs[:project] or raise Error, "project is required when creating a milestone"
+
+        input = build_input(kwargs).merge(projectId: Resolvers::Project.call(value: project))
+        submit(CREATE_MUTATION, "projectMilestoneCreate", input:)
+      end
+
+      def update(id, kwargs)
+        if kwargs.key?(:project)
+          raise Error, "Cannot pass `project` on update — this tool does not move milestones between projects"
+        end
+
+        submit(UPDATE_MUTATION, "projectMilestoneUpdate", id:, input: build_input(kwargs))
+      end
+
+      def submit(mutation, mutation_key, **variables)
+        data = client.query(mutation, variables:)
+        result = data[mutation_key] or raise Error, "Milestone save failed: no result returned"
+        raise Error, "Milestone save failed" unless result["success"]
+        result["projectMilestone"]
+      end
+
+      def build_input(kwargs)
+        {name: :name, description: :description, targetDate: :targetDate,
+         sortOrder: :sortOrder}.each_with_object({}) do |(key, field), input|
+          input[field] = kwargs[key] if kwargs.key?(key)
+        end
+      end
+    end
+  end
+end

data/lib/linear_toon_mcp/tools.rb

@@ -39,6 +39,8 @@ require_relative "tools/save_status_update"
 require_relative "tools/delete_status_update"
 require_relative "tools/save_project"
 require_relative "tools/archive_project"
+require_relative "tools/save_project_milestone"
+require_relative "tools/delete_project_milestone"
 require_relative "tools/get_team"
 require_relative "tools/get_user"
 require_relative "tools/get_issue_status"

data/lib/linear_toon_mcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LinearToonMcp
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/lib/linear_toon_mcp.rb

@@ -42,6 +42,7 @@ module LinearToonMcp
         Tools::ListStatusUpdates, Tools::GetStatusUpdate,
         Tools::SaveStatusUpdate, Tools::DeleteStatusUpdate,
         Tools::SaveProject, Tools::ArchiveProject,
+        Tools::SaveProjectMilestone, Tools::DeleteProjectMilestone,
         Tools::GetTeam, Tools::GetUser, Tools::GetIssueStatus,
         Tools::CreateIssueLabel
       ]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: linear-toon-mcp
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Yevhenii Hurin
@@ -85,6 +85,7 @@ files:
 - lib/linear_toon_mcp/tools/delete.rb
 - lib/linear_toon_mcp/tools/delete_comment.rb
 - lib/linear_toon_mcp/tools/delete_initiative.rb
+- lib/linear_toon_mcp/tools/delete_project_milestone.rb
 - lib/linear_toon_mcp/tools/delete_status_update.rb
 - lib/linear_toon_mcp/tools/get.rb
 - lib/linear_toon_mcp/tools/get_initiative.rb
@@ -110,6 +111,7 @@ files:
 - lib/linear_toon_mcp/tools/save_initiative.rb
 - lib/linear_toon_mcp/tools/save_issue.rb
 - lib/linear_toon_mcp/tools/save_project.rb
+- lib/linear_toon_mcp/tools/save_project_milestone.rb
 - lib/linear_toon_mcp/tools/save_status_update.rb
 - lib/linear_toon_mcp/version.rb
 homepage: https://github.com/hoblin/linear-toon-mcp