linear-rb 0.1.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9c94b7659e207b517fcf2960b83390d2c7a4e17d6ea02e59d5079730eca3da5
-  data.tar.gz: bbee449d73c50d2c6c623e138fd983faa46f98017ee9d8125b867d4902433452
+  metadata.gz: 2d86a47411e5f3e9ab46945cded06b74c305fee7552ac4770f6c93023dddb3dd
+  data.tar.gz: 8b8aa4987546fc77b34b7addab90d6181aa6b13b8d5fa1f7a32ce96d5c2814ef
 SHA512:
-  metadata.gz: 1cbe8c882e24fe6acd64f086b97e45f40cbf2029191b92f0d0be00a83e5b3cc0ece68d4b11bb6ae037c943e0efb704ee6f7fe83e8ccfe7dd98198f8c91969151
-  data.tar.gz: 69bba6defc5690f2663b1868cc14ca1e789177f8ce00d352484101b7ae3a53785d981cb3cd9447aa9df95e0238b551fb52fb4ca889802d6558805b88e8e37f40
+  metadata.gz: 89a95415e7aa7cc0d9f605eeb37d1444bd604fcb321cb182cb13b5f60410c35b95ff39836574462c56b4682c3a117fa7fcbeef8e0cfcad709fed91ab052b5e29
+  data.tar.gz: 7888ac607e72ae1480d9364bf0034acbe789e7bd6e7f4fa047b2e12cbce7dd626e0920d08c3d0aa1cc104aa92d0c2fb57632b46d0fb38506cb47b5bd471bc740

data/bin/linear

@@ -8,26 +8,57 @@ def show_usage
     Linear CLI - Ruby wrapper for Linear GraphQL API
 
     Usage:
-      linear issue ISSUE_ID                   Fetch issue details
-      linear search QUERY [OPTIONS]           Search for issues
+      linear issue ISSUE_ID                   Fetch a specific issue by ID
+      linear issues [OPTIONS]                 List and filter issues (all filters are optional)
       linear mine                             Show issues assigned to you
       linear teams                            List all teams
       linear projects                         List all projects
       linear comment ISSUE_ID COMMENT         Add a comment to an issue
-      linear update ISSUE_ID STATE            Update issue state
-
-    Search Options:
+      linear update ISSUE_ID [OPTIONS]        Update issue (at least one option required)
+        --state STATE                         Update issue state
+        --title TITLE                         Update issue title
+        --description DESCRIPTION             Update issue description
+
+    Issues Filters (all optional, can be combined):
+      --query TEXT                      Search by title text
+      --project PROJECT_ID              Filter by project ID
+      --state STATE                     Filter by state name (case-insensitive)
       --team TEAM_KEY                   Filter by team key
-      --state STATE                     Filter by state name
 
     Examples:
+      # View a specific issue
       linear issue ENG-123
-      linear search "bug fix" --team=ENG --state=Backlog
+
+      # List all issues
+      linear issues
+
+      # Search issues by title
+      linear issues --query "authentication"
+
+      # Filter by state (case-insensitive)
+      linear issues --state backlog
+      linear issues --state "In Progress"
+
+      # Filter by team
+      linear issues --team ENG
+
+      # Combine multiple filters
+      linear issues --query "bug" --state Backlog --team ENG
+      linear issues --project abc123 --state Done
+
+      # Your assigned issues
       linear mine
+
+      # Other commands
       linear teams
       linear projects
-      linear comment FAT-85 "This is done"
-      linear update FAT-85 "Done"
+      linear comment DEV-85 "This is done"
+
+      # Update issue
+      linear update DEV-85 --state "Done"
+      linear update DEV-85 --title "New title"
+      linear update DEV-85 --description "Updated description"
+      linear update DEV-85 --state "In Progress" --title "Working on it" --description "Started implementation"
 
     Configuration:
       Set the LINEAR_API_KEY environment variable with your API key from:
@@ -53,27 +84,6 @@ when 'issue'
     exit 1
   end
 
-when 'search'
-  query = ARGV.shift
-  if query.nil? || query.empty?
-    puts "Error: search query required"
-    puts "Usage: linear search QUERY [--team TEAM] [--state STATE]"
-    exit 1
-  end
-
-  options = {}
-  OptionParser.new do |opts|
-    opts.on("--team TEAM", "Filter by team key") { |v| options[:team] = v }
-    opts.on("--state STATE", "Filter by state name") { |v| options[:state] = v }
-  end.parse!
-
-  begin
-    Linear::Commands.search(query, options)
-  rescue => e
-    puts "Error: #{e.message}"
-    exit 1
-  end
-
 when 'mine'
   begin
     Linear::Commands.my_issues
@@ -98,6 +108,22 @@ when 'projects'
     exit 1
   end
 
+when 'issues'
+  options = {}
+  OptionParser.new do |opts|
+    opts.on("--query QUERY", "Filter by title text") { |v| options[:query] = v }
+    opts.on("--project PROJECT", "Filter by project ID") { |v| options[:project] = v }
+    opts.on("--state STATE", "Filter by state name") { |v| options[:state] = v }
+    opts.on("--team TEAM", "Filter by team key") { |v| options[:team] = v }
+  end.parse!
+
+  begin
+    Linear::Commands.list_issues(options)
+  rescue => e
+    puts "Error: #{e.message}"
+    exit 1
+  end
+
 when 'comment'
   issue_id = ARGV.shift
   comment_body = ARGV.shift
@@ -117,16 +143,27 @@ when 'comment'
 
 when 'update'
   issue_id = ARGV.shift
-  state_name = ARGV.shift
 
-  if issue_id.nil? || issue_id.empty? || state_name.nil? || state_name.empty?
-    puts "Error: issue ID and state name required"
-    puts "Usage: linear update ISSUE_ID \"State Name\""
+  if issue_id.nil? || issue_id.empty?
+    puts "Error: issue ID required"
+    puts "Usage: linear update ISSUE_ID [--state STATE] [--title TITLE] [--description DESCRIPTION]"
     exit 1
   end
 
+  options = {}
+  OptionParser.new do |opts|
+    opts.on("--state STATE", "Update issue state") { |v| options[:state] = v }
+    opts.on("--title TITLE", "Update issue title") { |v| options[:title] = v }
+    opts.on("--description DESCRIPTION", "Update issue description") { |v| options[:description] = v }
+  end.parse!
+
   begin
-    Linear::Commands.update_issue_state(issue_id, state_name)
+    Linear::Commands.update_issue(
+      issue_id,
+      state: options[:state],
+      title: options[:title],
+      description: options[:description]
+    )
   rescue => e
     puts "Error: #{e.message}"
     exit 1

data/lib/linear/commands.rb

@@ -13,16 +13,18 @@ module Linear
       end
     end
 
-    def search(query, options = {}, client: Client.new)
-      filter = { title: { contains: query } }
+    def list_issues(options = {}, client: Client.new)
+      filter = {}
+      filter[:title] = { contains: options[:query] } if options[:query]
+      filter[:project] = { id: { eq: options[:project] } } if options[:project]
+      filter[:state] = { name: { eqIgnoreCase: options[:state] } } if options[:state]
       filter[:team] = { key: { eq: options[:team] } } if options[:team]
-      filter[:state] = { name: { eq: options[:state] } } if options[:state]
 
-      result = client.query(Queries::SEARCH_ISSUES, { filter: filter })
+      result = client.query(Queries::LIST_ISSUES, { filter: filter })
 
       issues = result.dig("data", "issues", "nodes") || []
       if issues.empty?
-        puts "No issues found matching: #{query}"
+        puts "No issues found"
       else
         display_issue_list(issues)
       end
@@ -81,8 +83,14 @@ module Linear
       end
     end
 
-    def update_issue_state(issue_id, state_name, client: Client.new)
-      # Get the issue details including team
+    def update_issue(issue_id, state: nil, title: nil, description: nil, client: Client.new)
+      # 1. Validate at least one change provided
+      if state.nil? && title.nil? && description.nil?
+        puts "Error: At least one of --state, --title, or --description must be provided"
+        return
+      end
+
+      # 2. Fetch issue to get internal UUID
       issue_result = client.query(Queries::ISSUE, { id: issue_id })
       issue = issue_result.dig("data", "issue")
 
@@ -91,65 +99,51 @@ module Linear
         return
       end
 
-      # Get team states - need to find team ID first
-      teams_result = client.query(Queries::TEAMS)
-      teams = teams_result.dig("data", "teams", "nodes") || []
-
-      # Find the team from the issue identifier prefix (e.g., "FAT" from "FAT-85")
-      team_key = issue_id.split('-').first
-      team = teams.find { |t| t['key'] == team_key }
-
-      unless team
-        puts "Error: Team not found for issue #{issue_id}"
-        return
-      end
+      # 3. If state provided, resolve state ID (existing logic)
+      state_id = nil
+      target_state = nil
+      if state
+        team_key = issue_id.split('-').first
+        teams_result = client.query(Queries::TEAMS)
+        teams = teams_result.dig("data", "teams", "nodes") || []
+        team = teams.find { |t| t['key'] == team_key }
 
-      # Get workflow states for the team
-      states_result = client.query(Queries::WORKFLOW_STATES, { teamId: team['id'] })
-      states = states_result.dig("data", "team", "states", "nodes") || []
-
-      # Find the state by name (case-insensitive)
-      target_state = states.find { |s| s['name'].downcase == state_name.downcase }
+        unless team
+          puts "Error: Team not found for issue #{issue_id}"
+          return
+        end
 
-      unless target_state
-        puts "Error: State '#{state_name}' not found. Available states:"
-        states.each { |s| puts "  - #{s['name']}" }
-        return
-      end
+        states_result = client.query(Queries::WORKFLOW_STATES, { teamId: team['id'] })
+        states = states_result.dig("data", "team", "states", "nodes") || []
+        target_state = states.find { |s| s['name'].downcase == state.downcase }
 
-      # Update the issue
-      result = client.query(Queries::UPDATE_ISSUE, {
-        issueId: issue['id'],
-        stateId: target_state['id']
-      })
+        unless target_state
+          puts "Error: State '#{state}' not found. Available states:"
+          states.each { |s| puts "  - #{s['name']}" }
+          return
+        end
 
-      if result.dig("data", "issueUpdate", "success")
-        puts "Updated #{issue_id} to '#{target_state['name']}'"
-      else
-        puts "Error: Failed to update issue state"
+        state_id = target_state['id']
       end
-    end
 
-    def update_issue_description(issue_id, description, client: Client.new)
-      # Get the issue to get its internal ID
-      issue_result = client.query(Queries::ISSUE, { id: issue_id })
-      issue = issue_result.dig("data", "issue")
+      # 4. Build mutation parameters
+      params = { issueId: issue['id'] }
+      params[:stateId] = state_id if state_id
+      params[:title] = title if title
+      params[:description] = description if description
 
-      unless issue
-        puts "Error: Issue not found: #{issue_id}"
-        return
-      end
-
-      # Update the issue description
-      result = client.query(Queries::UPDATE_ISSUE, {
-        issueId: issue['id'],
-        description: description
-      })
+      # 5. Execute mutation
+      result = client.query(Queries::UPDATE_ISSUE, params)
 
+      # 6. Display results
       if result.dig("data", "issueUpdate", "success")
-        puts "Updated #{issue_id} description"
+        changes = []
+        changes << "state to '#{target_state['name']}'" if state
+        changes << "title" if title
+        changes << "description" if description
+        puts "Updated #{issue_id}: #{changes.join(', ')}"
       else
-        puts "Error: Failed to update issue description"
+        puts "Error: Failed to update issue"
       end
     end
 

data/lib/linear/queries.rb

@@ -23,7 +23,7 @@ module Linear
       }
     GQL
 
-    SEARCH_ISSUES = <<~GQL
+    LIST_ISSUES = <<~GQL
       query($filter: IssueFilter!) {
         issues(filter: $filter) {
           nodes {
@@ -127,15 +127,17 @@ module Linear
     GQL
 
     UPDATE_ISSUE = <<~GQL
-      mutation($issueId: String!, $stateId: String, $description: String) {
+      mutation($issueId: String!, $stateId: String, $description: String, $title: String) {
         issueUpdate(id: $issueId, input: {
           stateId: $stateId
           description: $description
+          title: $title
         }) {
           success
           issue {
             id
             identifier
+            title
             state {
               name
             }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: linear-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Dave Kinkead