linear-toon-mcp 0.6.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0daf1704fb96cea3eec8dbd60cb0c51a0facdd3e2ede5c3575b4f312fdde23c6
-  data.tar.gz: 8f45de9bd2c1a409b506cd87cfa47479b4aeaf731b0f928d84882eb21aeed9fd
+  metadata.gz: 4548c28ca6deb74cc3ea72d889aad5f931ed4d63265f9d742f8ad54b1af651b9
+  data.tar.gz: 8089aab524d5febf2207243b5de33524dc2a264fdc8624a009d1ed3fbf4ce9a0
 SHA512:
-  metadata.gz: 9a1609b91fc4d8a4dd5fa5f46b77fe3bd38cf48a022dd1de9f00432ac29ab55a7c55ada94b0acc9342dc50134890f272db9531a6e6fb7e7e7736f766ef4c58c1
-  data.tar.gz: 7b9adcc7084b17bb7167ff469679559a033f217bcb523591bd5a74cee79f51798aa9c5f22695937738f4175bab45691c59da8e16b341f182e53f4f68d74561cf
+  metadata.gz: 64044b9580eef34aab49067d721ee0435b38658a6bd99ba5594260457b1424beb4f9f3236de429986a6f099c2c60debfa9a72635538ac095f91f5440b343adf0
+  data.tar.gz: 2f679acce91253b8632c913c3be49bb0329aa8a2eb84538205a24ef248fcf7e0448b9ff0b8263087cbc39a993c23cf383f3868868ca94d7691b3c695051ebfbc

data/README.md

@@ -42,21 +42,66 @@ 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.
+
+### Issues
+
+| Tool | Description |
+|------|-------------|
+| `get_issue` | Retrieve an issue by ID or identifier (e.g., `LIN-123`). Returns the issue plus its parent and direct children. |
+| `list_issues` | List issues with filters (team, assignee, state, label, priority, project, cycle) and cursor pagination. |
+| `save_issue` | Create or update an issue. Accepts names for team, assignee, state, labels, project, cycle, and milestone. Relation params (`blocks`, `relatedTo`, `duplicateOf`) and `parentId` accept UUIDs or identifiers. On create, relations are appended; on update, they replace existing. Null clears nullable fields on update. |
+
+### Comments
+
+| Tool | Description |
+|------|-------------|
+| `list_comments` | List comments on an issue, project, initiative, or project status update (exactly one parent). Cursor-paginated. |
+| `save_comment` | Create or update a comment. On create, exactly one of `issue` / `project` / `initiative` / `projectUpdate` identifies the parent. Supports threaded replies via `parentId`. |
+| `delete_comment` | Delete a comment by ID. |
+
+### Projects
+
+| Tool | Description |
+|------|-------------|
+| `list_projects` | List projects, optionally scoped to a team. Returns id, name, and status. |
+| `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. |
+
+### Initiatives
+
+| Tool | Description |
+|------|-------------|
+| `list_initiatives` | List initiatives with filters (status, owner, parent initiative, date ranges) and cursor pagination. Optional `includeProjects` adds linked projects. |
+| `get_initiative` | Retrieve an initiative by name or ID. Returns linked projects. Optional `includeSubInitiatives`. |
+| `save_initiative` | Create or update an initiative. Resolves `owner` and `parentInitiative` names to IDs. Exposes both `description` (short summary, ~255 chars) and `content` (long Markdown). |
+| `delete_initiative` | Delete an initiative. `archive: true` soft-deletes via `initiativeArchive`. Hard delete is refused while projects are still linked — unlink first or archive. |
+| `add_project_to_initiative` | Link a project to an initiative. |
+| `remove_project_from_initiative` | Unlink a project from an initiative; finds and deletes the underlying join record. |
+
+### Status updates
+
+| Tool | Description |
+|------|-------------|
+| `list_status_updates` | List status updates posted to a project or initiative (exactly one parent). Cursor-paginated. |
+| `get_status_update` | Retrieve a status update by ID — transparently fetches whichever parent type owns it. |
+| `save_status_update` | Create or update a status update on a project or initiative. `health` enum: `onTrack` / `atRisk` / `offTrack`. Body is Markdown. |
+| `delete_status_update` | Archive a status update by ID. Linear has no hard-delete for status updates; this maps to `*UpdateArchive`. |
+
+### Workspace
+
 | Tool | Description |
 |------|-------------|
-| `get_issue` | Retrieve a Linear issue by ID or identifier (e.g., `LIN-123`). Returns issue details including title, description, state, assignee, labels, project, attachments, and the parent and direct child issues (each with identifier, title, state, and url). |
-| `list_issues` | List issues with optional filters (team, assignee, state, label, priority, project, cycle) and cursor-based pagination. Supports name or UUID for most filters. |
-| `list_issue_statuses` | List available workflow states for a team. Returns status id, type (backlog/unstarted/started/completed/canceled), and name. Accepts team name or UUID. |
-| `list_teams` | List all teams in the workspace. Returns team id, name, and key. |
-| `list_users` | List users in the workspace, optionally scoped to a team. Returns user id, name, and email. |
-| `list_issue_labels` | List issue labels, optionally scoped to a team. Returns label id and name. |
-| `list_projects` | List projects, optionally scoped to a team. Returns project id, name, and state. |
-| `list_cycles` | List cycles for a team. Returns cycle id, name, number, startsAt, and endsAt. Requires team name or UUID. |
-| `get_project` | Retrieve a specific project by name, ID, or slug. Returns project details including state, priority, dates, progress, and lead. Optional includes for members, milestones, and resources. |
-| `create_issue` | Create a new Linear issue. Accepts human-friendly names for team, assignee, state, labels, project, cycle, and milestone (resolved to IDs automatically; label names resolve against the target team or workspace-wide labels). Relation params (`blocks`, `relatedTo`, `duplicateOf`) and `parentId` accept either issue UUIDs or human identifiers (e.g., `LIN-123`). 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. Relation params (`blocks`, `relatedTo`, `duplicateOf`) and `parentId` accept either issue UUIDs or human identifiers (e.g., `LIN-123`). Label names resolve against the issue's team or workspace-wide labels. |
-| `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. |
+| `list_teams` | List all teams. Returns id, name, and key. |
+| `get_team` | Retrieve a team by id, key (e.g., `VIB`), or name. |
+| `list_users` | List users, optionally scoped to a team. |
+| `get_user` | Retrieve a user by id, name, email, or `"me"`. |
+| `list_cycles` | List cycles for a team. Returns id, name, number, startsAt, endsAt. |
+| `list_issue_statuses` | List workflow states for a team. Returns id, type (`backlog`, `unstarted`, `started`, `completed`, `canceled`, `triage`, `duplicate`), and name. |
+| `get_issue_status` | Retrieve a workflow state by name or UUID, team-scoped. |
+| `list_issue_labels` | List issue labels, optionally scoped to a team. |
+| `create_issue_label` | Create an issue label. Omit `team` for a workspace-wide label. |
 
 ## Development
 
@@ -70,7 +115,7 @@ bundle exec standardrb   # lint
 
 ## Versioning
 
-Version `1.0.0` means feature parity with the official Linear MCP server. Until then, each new tool (or set of tools) bumps the minor version. The single source of truth is `lib/linear_toon_mcp/version.rb`.
+[Semantic versioning](https://semver.org/). Breaking tool removals or rename go in a major bump, new tools or new optional parameters go in a minor, fixes and internal refactors go in a patch. The single source of truth is `lib/linear_toon_mcp/version.rb`.
 
 ## Releasing
 

data/lib/linear_toon_mcp/resolvers/base.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Base class for entity resolvers. Subclasses declare their lookup
+    # attributes and any required parent scope. UUIDs always pass through
+    # unchanged regardless of the declared attributes.
+    #
+    # Defaults derive from the class name:
+    #
+    #   WorkflowState.connection_name   # => "workflowStates"
+    #   WorkflowState.filter_type_name  # => "WorkflowStateFilter"
+    #   WorkflowState.entity_label      # => "State"
+    #
+    # Override any default via {.connection}, {.filter_type}, or {.label}.
+    class Base
+      # Lookup attribute catalog: value predicate paired with GraphQL filter builder.
+      ATTRIBUTES = {
+        name: {
+          matches: ->(_v) { true },
+          filter: ->(v) { {name: {eqIgnoreCase: v}} }
+        },
+        email: {
+          matches: ->(v) { v.include?("@") },
+          filter: ->(v) { {email: {eq: v}} }
+        },
+        number: {
+          matches: ->(v) { v.match?(NUMERIC_RE) },
+          filter: ->(v) { {number: {eq: v.to_i}} }
+        },
+        slug: {
+          matches: ->(_v) { true },
+          filter: ->(v) { {slugId: {eqIgnoreCase: v}} }
+        },
+        key: {
+          matches: ->(v) { v.match?(/\A[A-Z]+\z/) },
+          filter: ->(v) { {key: {eq: v}} }
+        },
+        type: {
+          matches: ->(v) { v.match?(/\A[a-z]+\z/) },
+          filter: ->(v) { {type: {eq: v}} }
+        }
+      }.freeze
+
+      class << self
+        # Declares lookup attributes for this resolver, in priority order.
+        #
+        #   class Team < Base
+        #     lookup_by :key, :name
+        #   end
+        #
+        # @param attrs [Array<Symbol>] attribute names from {ATTRIBUTES}
+        def lookup_by(*attrs)
+          @attributes = attrs.freeze
+        end
+
+        # Declares a parent-scoping kwarg expected by {.call}. The kwarg name
+        # implies the GraphQL filter key — +:team_id+ produces
+        # +{team: {id: {eq: value}}}+.
+        #
+        #   class Cycle < Base
+        #     scoped_by :team_id
+        #     lookup_by :name
+        #   end
+        #
+        # @param key [Symbol] kwarg name passed to {.call}
+        # @param optional [Boolean] omit the scope filter when scope arg is nil
+        # @param workspace_fallback [Boolean] when set, the scope filter becomes
+        #   an +or:+ matching either the scoped parent or workspace-level
+        #   records (parent +null+)
+        def scoped_by(key, optional: false, workspace_fallback: false)
+          @scope_config = {key: key, optional: optional, workspace_fallback: workspace_fallback}.freeze
+        end
+
+        # Overrides the derived GraphQL connection name.
+        def connection(name)
+          @connection = name.to_s
+        end
+
+        # Overrides the derived GraphQL filter type name.
+        def filter_type(name)
+          @filter_type = name.to_s
+        end
+
+        # Overrides the derived not-found label.
+        def label(name)
+          @label = name.to_s
+        end
+
+        # Returns the attributes declared via {.lookup_by}.
+        def attributes
+          @attributes || []
+        end
+
+        attr_reader :scope_config
+
+        # Returns the GraphQL connection name.
+        #
+        #   WorkflowState.connection_name  # => "workflowStates"
+        def connection_name
+          @connection ||= "#{entity_name[0].downcase}#{entity_name[1..]}s"
+        end
+
+        # Returns the GraphQL filter input type name.
+        #
+        #   WorkflowState.filter_type_name  # => "WorkflowStateFilter"
+        def filter_type_name
+          @filter_type ||= "#{entity_name}Filter"
+        end
+
+        # Returns the not-found label — the trailing CamelCase word of
+        # {.entity_name}.
+        #
+        #   WorkflowState.entity_label  # => "State"
+        def entity_label
+          @label ||= entity_name.scan(/[A-Z][a-z]+/).last || entity_name
+        end
+
+        # Returns the entity name.
+        #
+        #   WorkflowState.entity_name  # => "WorkflowState"
+        def entity_name
+          @entity_name ||= name.split("::").last
+        end
+
+        # Returns the memoized GraphQL query.
+        def query
+          @query ||= <<~GRAPHQL
+            query($filter: #{filter_type_name}) {
+              #{connection_name}(filter: $filter, first: 1) { nodes { id } }
+            }
+          GRAPHQL
+        end
+
+        # Resolves +value+ to a UUID using {LinearToonMcp.client}.
+        #
+        #   Team.call(value: "Engineering")
+        #   WorkflowState.call(value: "Done", team_id: tid)
+        #
+        # @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
+        def call(value:, **scope)
+          new(**scope).resolve(value)
+        end
+
+        # Resolves each value via {.call}, forwarding scope.
+        #
+        #   IssueLabel.call_many(values: ["bug", "p1"], team_id: tid)
+        #
+        # @return [Array<String>]
+        def call_many(values:, **scope)
+          values.map { |v| call(value: v, **scope) }
+        end
+      end
+
+      def initialize(**scope)
+        @scope = scope
+      end
+
+      # Resolves +value+ to a UUID. UUIDs pass through unchanged; otherwise
+      # each {.lookup_by} attribute is tried in declared order and the first
+      # GraphQL lookup that returns a node wins.
+      #
+      # @raise [Error] when nothing resolves +value+
+      def resolve(value)
+        return value if value.match?(UUID_RE)
+
+        self.class.attributes.each do |attr|
+          definition = ATTRIBUTES.fetch(attr) { raise Error, "Unknown attribute: #{attr.inspect}" }
+          next unless definition[:matches].call(value)
+
+          id = lookup(definition[:filter].call(value).merge(scope_filter))
+          return id if id
+        end
+
+        raise Error, not_found_message(value)
+      end
+
+      private
+
+      attr_reader :scope
+
+      def client
+        LinearToonMcp.client
+      end
+
+      def scope_filter
+        cfg = self.class.scope_config
+        return {} unless cfg
+
+        scope_id = scope[cfg[:key]]
+        if scope_id.nil?
+          return {} if cfg[:optional]
+          raise Error, "Missing required scope: #{cfg[:key]}"
+        end
+
+        parent_field = cfg[:key].to_s.sub(/_id\z/, "").to_sym
+        if cfg[:workspace_fallback]
+          {or: [{parent_field => {null: true}}, {parent_field => {id: {eq: scope_id}}}]}
+        else
+          {parent_field => {id: {eq: scope_id}}}
+        end
+      end
+
+      def lookup(filter)
+        data = client.query(self.class.query, variables: {filter:})
+        data.dig(self.class.connection_name, "nodes", 0, "id")
+      end
+
+      def not_found_message(value)
+        "#{self.class.entity_label} not found: #{value}"
+      end
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/cycle.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear cycle by number or name. Team-scoped.
+    class Cycle < Base
+      scoped_by :team_id
+      lookup_by :number, :name
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/initiative.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear initiative by name.
+    class Initiative < Base
+      lookup_by :name
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/issue_label.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear issue label by name. Optionally scoped to a team;
+    # when scoped, matches either the team's labels or workspace-wide labels
+    # (team +null+).
+    class IssueLabel < Base
+      scoped_by :team_id, optional: true, workspace_fallback: true
+      lookup_by :name
+
+      private
+
+      def not_found_message(value)
+        scope[:team_id] ? "Label not found on target team or workspace: #{value}" : super
+      end
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/project.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear project by name or slug.
+    class Project < Base
+      lookup_by :name, :slug
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/project_milestone.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear project milestone by name. Project-scoped.
+    class ProjectMilestone < Base
+      scoped_by :project_id
+      lookup_by :name
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/project_status.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear project status by name (workspace-scoped).
+    class ProjectStatus < Base
+      connection :projectStatuses
+      filter_type :ProjectStatusFilter
+      lookup_by :name
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/team.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear team by key or name.
+    class Team < Base
+      lookup_by :key, :name
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/user.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear user by email, name, or the literal +"me"+.
+    class User < Base
+      VIEWER_QUERY = "query { viewer { id } }"
+
+      lookup_by :email, :name
+
+      def resolve(value)
+        return resolve_viewer if value == "me"
+        super
+      end
+
+      private
+
+      def resolve_viewer
+        data = client.query(VIEWER_QUERY)
+        data.dig("viewer", "id") || raise(Error, "Could not resolve current user")
+      end
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers/workflow_state.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module LinearToonMcp
+  module Resolvers
+    # Resolves a Linear workflow state (issue status) by type or name.
+    # Team-scoped.
+    class WorkflowState < Base
+      scoped_by :team_id
+      lookup_by :type, :name
+    end
+  end
+end

data/lib/linear_toon_mcp/resolvers.rb

@@ -1,182 +1,27 @@
 # frozen_string_literal: true
 
 module LinearToonMcp
-  # Shared resolvers for converting human-friendly names to Linear API UUIDs.
-  # Each resolver passes through UUIDs unchanged and performs a GraphQL lookup otherwise.
+  # Resolvers translate human-friendly identifiers — UUIDs, names, emails,
+  # slugs, numbers, the literal "me" — into Linear API UUIDs. They read
+  # {LinearToonMcp.client} for API calls.
+  #
+  # @example
+  #   Resolvers::Team.call(value: "Engineering")
+  #   Resolvers::WorkflowState.call(value: "In Progress", team_id: tid)
+  #   Resolvers::IssueLabel.call_many(values: ["bug", "p1"], team_id: tid)
   module Resolvers
     UUID_RE = /\A\h{8}-\h{4}-\h{4}-\h{4}-\h{12}\z/
     NUMERIC_RE = /\A\d+\z/
-
-    TEAM_QUERY = <<~GRAPHQL
-      query($filter: TeamFilter) {
-        teams(filter: $filter, first: 1) { nodes { id } }
-      }
-    GRAPHQL
-
-    VIEWER_QUERY = "query { viewer { id } }"
-
-    USER_QUERY = <<~GRAPHQL
-      query($filter: UserFilter) {
-        users(filter: $filter, first: 1) { nodes { id } }
-      }
-    GRAPHQL
-
-    STATE_QUERY = <<~GRAPHQL
-      query($filter: WorkflowStateFilter) {
-        workflowStates(filter: $filter, first: 1) { nodes { id } }
-      }
-    GRAPHQL
-
-    LABEL_QUERY = <<~GRAPHQL
-      query($filter: IssueLabelFilter) {
-        issueLabels(filter: $filter, first: 1) { nodes { id } }
-      }
-    GRAPHQL
-
-    PROJECT_QUERY = <<~GRAPHQL
-      query($filter: ProjectFilter) {
-        projects(filter: $filter, first: 1) { nodes { id } }
-      }
-    GRAPHQL
-
-    CYCLE_QUERY = <<~GRAPHQL
-      query($filter: CycleFilter) {
-        cycles(filter: $filter, first: 1) { nodes { id } }
-      }
-    GRAPHQL
-
-    MILESTONE_QUERY = <<~GRAPHQL
-      query($filter: ProjectMilestoneFilter) {
-        projectMilestones(filter: $filter, first: 1) { nodes { id } }
-      }
-    GRAPHQL
-
-    module_function
-
-    # @param client [Client]
-    # @param value [String] team UUID or name
-    # @return [String] team UUID
-    # @raise [Error] when team not found
-    def resolve_team(client, value)
-      return value if value.match?(UUID_RE)
-      data = client.query(TEAM_QUERY, variables: {filter: {name: {eqIgnoreCase: value}}})
-      data.dig("teams", "nodes", 0, "id") or raise Error, "Team not found: #{value}"
-    end
-
-    # @param client [Client]
-    # @param value [String] user UUID, "me", email, or name
-    # @return [String] user UUID
-    # @raise [Error] when user not found
-    def resolve_user(client, value)
-      return value if value.match?(UUID_RE)
-
-      if value == "me"
-        data = client.query(VIEWER_QUERY)
-        return data.dig("viewer", "id") || raise(Error, "Could not resolve current user")
-      end
-
-      filter = value.include?("@") ? {email: {eq: value}} : {name: {eqIgnoreCase: value}}
-      data = client.query(USER_QUERY, variables: {filter:})
-      data.dig("users", "nodes", 0, "id") or raise Error, "User not found: #{value}"
-    end
-
-    # @param client [Client]
-    # @param team_id [String] team UUID (for scoping)
-    # @param value [String] state UUID or name
-    # @return [String] state UUID
-    # @raise [Error] when state not found
-    def resolve_state(client, team_id, value)
-      return value if value.match?(UUID_RE)
-      filter = {name: {eqIgnoreCase: value}, team: {id: {eq: team_id}}}
-      data = client.query(STATE_QUERY, variables: {filter:})
-      data.dig("workflowStates", "nodes", 0, "id") or raise Error, "State not found: #{value}"
-    end
-
-    # Resolve a single label name or UUID to its UUID.
-    # When +team_id+ is supplied, restricts the lookup to labels scoped to that
-    # team or to workspace-wide labels (where the label's team relation is null),
-    # so a name like "Bug" matches the right team-scoped label and not a same-named
-    # label on another team.
-    # @param client [Client]
-    # @param value [String] label UUID or name
-    # @param team_id [String, nil] optional team UUID to scope the lookup
-    # @return [String] label UUID
-    # @raise [Error] when label not found
-    def resolve_label(client, value, team_id: nil)
-      return value if value.match?(UUID_RE)
-
-      filter = {name: {eqIgnoreCase: value}}
-      if team_id
-        filter[:or] = [
-          {team: {null: true}},
-          {team: {id: {eq: team_id}}}
-        ]
-      end
-
-      data = client.query(LABEL_QUERY, variables: {filter:})
-      id = data.dig("issueLabels", "nodes", 0, "id")
-      return id if id
-
-      raise Error, label_not_found_message(value, team_id)
-    end
-
-    # @param client [Client]
-    # @param values [Array<String>] label UUIDs or names
-    # @param team_id [String, nil] optional team UUID to scope the lookup
-    # @return [Array<String>] label UUIDs
-    def resolve_labels(client, values, team_id: nil)
-      values.map { |v| resolve_label(client, v, team_id:) }
-    end
-
-    def label_not_found_message(value, team_id)
-      return "Label not found: #{value}" unless team_id
-      "Label not found on target team or workspace: #{value}"
-    end
-
-    # @param client [Client]
-    # @param value [String] project UUID, name, or slug
-    # @return [String] project UUID
-    # @raise [Error] when project not found
-    def resolve_project(client, value)
-      return value if value.match?(UUID_RE)
-
-      # Try name first, then slug
-      data = client.query(PROJECT_QUERY, variables: {filter: {name: {eqIgnoreCase: value}}})
-      id = data.dig("projects", "nodes", 0, "id")
-      return id if id
-
-      data = client.query(PROJECT_QUERY, variables: {filter: {slugId: {eqIgnoreCase: value}}})
-      data.dig("projects", "nodes", 0, "id") or raise Error, "Project not found: #{value}"
-    end
-
-    # @param client [Client]
-    # @param team_id [String] team UUID (for scoping)
-    # @param value [String] cycle UUID, number, or name
-    # @return [String] cycle UUID
-    # @raise [Error] when cycle not found
-    def resolve_cycle(client, team_id, value)
-      return value if value.match?(UUID_RE)
-
-      filter = if value.match?(NUMERIC_RE)
-        {number: {eq: value.to_i}, team: {id: {eq: team_id}}}
-      else
-        {name: {eqIgnoreCase: value}, team: {id: {eq: team_id}}}
-      end
-
-      data = client.query(CYCLE_QUERY, variables: {filter:})
-      data.dig("cycles", "nodes", 0, "id") or raise Error, "Cycle not found: #{value}"
-    end
-
-    # @param client [Client]
-    # @param project_id [String] project UUID (for scoping)
-    # @param value [String] milestone UUID or name
-    # @return [String] milestone UUID
-    # @raise [Error] when milestone not found
-    def resolve_milestone(client, project_id, value)
-      return value if value.match?(UUID_RE)
-      filter = {name: {eqIgnoreCase: value}, project: {id: {eq: project_id}}}
-      data = client.query(MILESTONE_QUERY, variables: {filter:})
-      data.dig("projectMilestones", "nodes", 0, "id") or raise Error, "Milestone not found: #{value}"
-    end
   end
 end
+
+require_relative "resolvers/base"
+require_relative "resolvers/team"
+require_relative "resolvers/user"
+require_relative "resolvers/workflow_state"
+require_relative "resolvers/issue_label"
+require_relative "resolvers/project"
+require_relative "resolvers/cycle"
+require_relative "resolvers/project_milestone"
+require_relative "resolvers/initiative"
+require_relative "resolvers/project_status"