linear-toon-mcp 1.0.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4548c28ca6deb74cc3ea72d889aad5f931ed4d63265f9d742f8ad54b1af651b9
-  data.tar.gz: 8089aab524d5febf2207243b5de33524dc2a264fdc8624a009d1ed3fbf4ce9a0
+  metadata.gz: 2c8f7853b331d24b32b67d2f6f5db8fae9c4833a25470011019463c69c621fac
+  data.tar.gz: '058de398a53a8109347de0ac55f75d6407a2a65e07cbdd10cd8a65754ae99009'
 SHA512:
-  metadata.gz: 64044b9580eef34aab49067d721ee0435b38658a6bd99ba5594260457b1424beb4f9f3236de429986a6f099c2c60debfa9a72635538ac095f91f5440b343adf0
-  data.tar.gz: 2f679acce91253b8632c913c3be49bb0329aa8a2eb84538205a24ef248fcf7e0448b9ff0b8263087cbc39a993c23cf383f3868868ca94d7691b3c695051ebfbc
+  metadata.gz: bd93c8d45aa51d44ae10b3e83adebc94db4f09588c73483797163b7ea8ee9ee8b7659383b450beab5759449e99c2788899c97430acd466dc16f5ee25adfbd129
+  data.tar.gz: 417404d0048ec42ae75cd1d11f445d283ac3bc72f2bfa265f8825e47e7d1da0746ff579236755285efbaf0ea1288340c390d9e6f41df31834059e6522c222464

data/README.md

@@ -42,7 +42,7 @@ claude mcp add linear-toon -e LINEAR_API_KEY=lin_api_xxxxx -- linear-toon-mcp
 
 ## Tools
 
-Most parameters accept either a UUID or a human identifier (issue identifier like `LIN-123`, team key like `VIB`, project/initiative/label name, user email or `"me"`); the server resolves it. `save_*` tools dispatch by `id` presence — provide an `id` to update, omit it to create. All responses are TOON-encoded.
+Most parameters accept either a UUID or a human identifier (issue identifier like `LIN-123`, team key like `VIB`, project/initiative/label name, user email or `"me"`); the server resolves it, and rejects blank values. `save_*` tools dispatch by `id` presence — provide an `id` to update, omit it to create. All responses are TOON-encoded.
 
 ### Issues
 
@@ -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/resolvers/base.rb

@@ -140,8 +140,9 @@ module LinearToonMcp
         # @param value [String]
         # @param scope [Hash] parent-scope kwargs (e.g. +team_id:+)
         # @return [String] resolved UUID
-        # @raise [Error] when no attribute resolves the value
+        # @raise [Error] when +value+ is blank or no attribute resolves it
         def call(value:, **scope)
+          raise Error, "#{entity_label} must not be blank" if value.strip.empty?
           new(**scope).resolve(value)
         end
 

data/lib/linear_toon_mcp/resolvers/project_status.rb

@@ -5,8 +5,30 @@ module LinearToonMcp
     # Resolves a Linear project status by name (workspace-scoped).
     class ProjectStatus < Base
       connection :projectStatuses
-      filter_type :ProjectStatusFilter
-      lookup_by :name
+
+      class << self
+        # Linear's projectStatuses field accepts no filter argument.
+        def query
+          @query ||= "query { #{connection_name} { nodes { id name } } }"
+        end
+      end
+
+      # Resolves +value+ to a UUID. UUIDs pass through unchanged; otherwise the
+      # workspace status list is matched by name, ignoring case.
+      #
+      # @raise [Error] when no status matches +value+
+      def resolve(value)
+        return value if value.match?(UUID_RE)
+
+        status = statuses.find { |node| node["name"].casecmp?(value) }
+        status&.fetch("id") || raise(Error, not_found_message(value))
+      end
+
+      private
+
+      def statuses
+        client.query(self.class.query).dig(self.class.connection_name, "nodes") || []
+      end
     end
   end
 end

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_issue.rb

@@ -27,7 +27,7 @@ module LinearToonMcp
           priority: {type: "number", description: "0=None, 1=Urgent, 2=High, 3=Normal, 4=Low"},
           state: {type: "string", description: "State name or ID"},
           labels: {type: "array", items: {type: "string"}, description: "Label names or IDs"},
-          project: {type: "string", description: "Project name or ID"},
+          project: {type: ["string", "null"], description: "Project name or ID. Null to remove (update only)"},
           cycle: {type: "string", description: "Cycle name, number, or ID"},
           estimate: {type: "number", description: "Issue estimate value"},
           dueDate: {type: "string", description: "Due date (ISO format)"},
@@ -200,8 +200,8 @@ module LinearToonMcp
           input[:labelIds] = Resolvers::IssueLabel.call_many(values: kwargs[:labels], team_id: team_id)
         end
         project_id = nil
-        if kwargs.key?(:project) && kwargs[:project]
-          project_id = Resolvers::Project.call(value: kwargs[:project])
+        if kwargs.key?(:project)
+          project_id = Resolvers::Project.call(value: kwargs[:project]) if kwargs[:project]
           input[:projectId] = project_id
         end
         if kwargs.key?(:milestone)

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.1"
 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.1
 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