linear-toon-mcp 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf06d4bccdbce8b42b754913248e6d2380aa8f695725714de733603a8fd65e6b
-  data.tar.gz: 32e7d3447fc0a55462f6f8b544bbe27801a4ac22d8192ec76208d99236275d73
+  metadata.gz: 3c8a4dfd15f2122d8742273f0a2b305d9f52f15b26173f177589348efcaceffb
+  data.tar.gz: 5f6f12e5bb56fe7c62cdabf552e110bd6b91dfabe0d0a6c241de074c5d1a02b3
 SHA512:
-  metadata.gz: 2aa03787fd5668f525d274650f8c334caf9e0c199d1c0ab93f96c6d609f4ee92f89d412af4daa9a3a1052e50fa30c813624e4c5e3ae10ffedc55616965977591
-  data.tar.gz: 255d287d3d61419cb4dcecbb224ef4b840dc821aa6fb09cd4109803018d30cf8e15f4300ee7c1fca82db8235b305cd193cda78fe8a420fcb36c14cb19419a2a0
+  metadata.gz: b163ae42837c5ae08eecf3b3897345f8c81312b7692a937ad0ef9586a42978155e2e1260fe7aeaa91d5fde1dddf29f0d0c5b8bad40658351dc925c017e4507ad
+  data.tar.gz: abd70a25debba62a651736fc0bfc018bda3171b3dc71070a2a4c17e5f2bd3476519def4f80dfb4c51853ad513ef9ecf898fc40aa3ad5630415144a9dd7e4e4a9

data/README.md

@@ -56,6 +56,7 @@ claude mcp add linear-toon -e LINEAR_API_KEY=lin_api_xxxxx -- linear-toon-mcp
 | `create_issue` | Create a new Linear issue. Accepts human-friendly names for team, assignee, state, labels, project, cycle, and milestone (resolved to IDs automatically). Supports issue relations and link attachments. |
 | `update_issue` | Update an existing Linear issue by ID. Supports partial updates, null to remove fields, and relation replacement. |
 | `create_comment` | Create a comment on a Linear issue. Supports Markdown content and threaded replies via parentId. |
+| `list_comments` | List comments for a specific Linear issue in chronological order. Returns each comment's id, body, author, and timestamps. |
 
 ## Development
 

data/lib/linear_toon_mcp/tools/create_issue.rb

@@ -92,10 +92,10 @@ module LinearToonMcp
           raise Error, "Issue creation failed" unless result["success"]
 
           issue = result["issue"]
-          create_relations(client, issue["id"], **kwargs)
-          create_links(client, issue["id"], kwargs[:links])
+          warnings = post_create(client, issue["id"], **kwargs)
 
           text = Toon.encode(issue)
+          text += "\nWARNING (issue was created): #{warnings.join("; ")}" if warnings.any?
           MCP::Tool::Response.new([{type: "text", text:}])
         rescue Error => e
           MCP::Tool::Response.new([{type: "text", text: e.message}], error: true)
@@ -103,6 +103,21 @@ module LinearToonMcp
 
         private
 
+        def post_create(client, issue_id, links: nil, **kwargs)
+          warnings = []
+          begin
+            create_relations(client, issue_id, **kwargs)
+          rescue Error => e
+            warnings << e.message
+          end
+          begin
+            create_links(client, issue_id, links)
+          rescue Error => e
+            warnings << e.message
+          end
+          warnings
+        end
+
         def add_direct_fields(input, description: nil, priority: nil, estimate: nil,
           dueDate: nil, parentId: nil, **)
           input[:description] = description if description
@@ -143,9 +158,9 @@ module LinearToonMcp
           return unless links
 
           links.each do |link|
-            data = client.query(LINK_MUTATION, variables: {url: link["url"], issueId: issue_id, title: link["title"]})
+            data = client.query(LINK_MUTATION, variables: {url: link[:url], issueId: issue_id, title: link[:title]})
             next if data.dig("attachmentLinkURL", "success")
-            raise Error, "Failed to attach link: #{link["url"]}"
+            raise Error, "Failed to attach link: #{link[:url]}"
           end
         end
       end

data/lib/linear_toon_mcp/tools/list_comments.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "toon"
+
+module LinearToonMcp
+  module Tools
+    # List comments on a Linear issue in chronological order.
+    # Returns each comment's author, body, and timestamps.
+    class ListComments < MCP::Tool
+      description "List comments for a specific Linear issue"
+
+      annotations(
+        read_only_hint: true,
+        destructive_hint: false,
+        idempotent_hint: true
+      )
+
+      input_schema(
+        properties: {
+          issueId: {type: "string", description: "Issue ID or identifier (e.g., LIN-123)"}
+        },
+        required: ["issueId"],
+        additionalProperties: false
+      )
+
+      QUERY = <<~GRAPHQL
+        query($id: String!) {
+          issue(id: $id) {
+            comments(orderBy: createdAt) {
+              nodes {
+                id
+                body
+                createdAt
+                editedAt
+                user { id name }
+              }
+              pageInfo {
+                hasNextPage
+                endCursor
+              }
+            }
+          }
+        }
+      GRAPHQL
+
+      # standard:disable Naming/VariableName
+      class << self
+        # @param issueId [String] Linear issue ID or identifier (e.g., "LIN-123")
+        # @param server_context [Hash, nil] must contain +:client+ key with a {Client}
+        # @return [MCP::Tool::Response] TOON-encoded comments connection or error
+        def call(issueId:, server_context: nil)
+          client = server_context&.dig(:client) or raise Error, "client missing from server_context"
+          data = client.query(QUERY, variables: {id: issueId})
+          issue = data["issue"] or raise Error, "Issue not found: #{issueId}"
+          text = Toon.encode(issue["comments"])
+          MCP::Tool::Response.new([{type: "text", text:}])
+        rescue Error => e
+          MCP::Tool::Response.new([{type: "text", text: e.message}], error: true)
+        end
+      end
+      # standard:enable Naming/VariableName
+    end
+  end
+end

data/lib/linear_toon_mcp/tools/update_issue.rb

@@ -115,10 +115,10 @@ module LinearToonMcp
           raise Error, "Issue update failed" unless result["success"]
 
           issue = result["issue"]
-          replace_relations(client, id, kwargs)
-          create_links(client, id, kwargs[:links])
+          warnings = post_update(client, id, **kwargs)
 
           text = Toon.encode(issue)
+          text += "\nWARNING (issue was updated): #{warnings.join("; ")}" if warnings.any?
           MCP::Tool::Response.new([{type: "text", text:}])
         rescue Error => e
           MCP::Tool::Response.new([{type: "text", text: e.message}], error: true)
@@ -126,6 +126,21 @@ module LinearToonMcp
 
         private
 
+        def post_update(client, issue_id, links: nil, **kwargs)
+          warnings = []
+          begin
+            replace_relations(client, issue_id, kwargs)
+          rescue Error => e
+            warnings << e.message
+          end
+          begin
+            create_links(client, issue_id, links)
+          rescue Error => e
+            warnings << e.message
+          end
+          warnings
+        end
+
         def resolve_team_id(client, issue_id, kwargs)
           return Resolvers.resolve_team(client, kwargs[:team]) if kwargs.key?(:team)
           return unless needs_team_id?(kwargs)
@@ -206,10 +221,10 @@ module LinearToonMcp
           return unless links
 
           links.each do |link|
-            vars = {url: link["url"], issueId: issue_id, title: link["title"]}
+            vars = {url: link[:url], issueId: issue_id, title: link[:title]}
             data = client.query(LINK_MUTATION, variables: vars)
             next if data.dig("attachmentLinkURL", "success")
-            raise Error, "Failed to attach link: #{link["url"]}"
+            raise Error, "Failed to attach link: #{link[:url]}"
           end
         end
       end

data/lib/linear_toon_mcp/version.rb

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

data/lib/linear_toon_mcp.rb

@@ -7,6 +7,7 @@ require_relative "linear_toon_mcp/resolvers"
 require_relative "linear_toon_mcp/tools/get_issue"
 require_relative "linear_toon_mcp/tools/list_issues"
 require_relative "linear_toon_mcp/tools/create_comment"
+require_relative "linear_toon_mcp/tools/list_comments"
 require_relative "linear_toon_mcp/tools/create_issue"
 require_relative "linear_toon_mcp/tools/update_issue"
 require_relative "linear_toon_mcp/tools/list_issue_statuses"
@@ -31,7 +32,7 @@ module LinearToonMcp
       name: "linear-toon-mcp",
       version: VERSION,
       description: "Manage Linear issues, projects, and teams",
-      tools: [Tools::GetIssue, Tools::ListIssues, Tools::ListIssueStatuses, Tools::ListTeams, Tools::ListUsers, Tools::ListIssueLabels, Tools::ListProjects, Tools::ListCycles, Tools::GetProject, Tools::CreateComment, Tools::CreateIssue, Tools::UpdateIssue],
+      tools: [Tools::GetIssue, Tools::ListIssues, Tools::ListIssueStatuses, Tools::ListTeams, Tools::ListUsers, Tools::ListIssueLabels, Tools::ListProjects, Tools::ListCycles, Tools::GetProject, Tools::CreateComment, Tools::ListComments, Tools::CreateIssue, Tools::UpdateIssue],
       server_context: {client:}
     )
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: linear-toon-mcp
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors:
 - Yevhenii Hurin
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.11'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.11'
 - !ruby/object:Gem::Dependency
   name: openssl
   requirement: !ruby/object:Gem::Requirement
@@ -70,6 +70,7 @@ files:
 - lib/linear_toon_mcp/tools/create_issue.rb
 - lib/linear_toon_mcp/tools/get_issue.rb
 - lib/linear_toon_mcp/tools/get_project.rb
+- lib/linear_toon_mcp/tools/list_comments.rb
 - lib/linear_toon_mcp/tools/list_cycles.rb
 - lib/linear_toon_mcp/tools/list_issue_labels.rb
 - lib/linear_toon_mcp/tools/list_issue_statuses.rb