linear-rb 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95f692f69f9d45f3b6f37dc1fa41a8f5312814eabb13ebfb6ed93828a7748699
-  data.tar.gz: 4176ed98a5f0b85cc30677622215ce39e1a1d0a4251dd5c88e61c67eb4d2df77
+  metadata.gz: 1da26699f5a96c66c0ab9eaff87b6d6b0af051810e289ba0fd7474d5874c2e8d
+  data.tar.gz: 61c18f121fc85cd46821d4291f49021cd2d2e9334e0b75ec8d54fffb4b16f840
 SHA512:
-  metadata.gz: e3b1154891eab716f95223b77a867b1a21ada9c7336a841027db055253febc21262797a7bf17c1b7cf10ca0f9c6784d212b6b85bf81e2c3b8dcf67e794b6c27b
-  data.tar.gz: 738eefde06923665d76b822818f93b5d1fe0c6e0dc30232c940d5fa73b2d1e4deb4010b3ea1eb0ee8115772b12e1d90dbb14fe36ac5d015121d051b447a3f05a
+  metadata.gz: ff8b25a4e714cc5dc5b5db510912f4eb1a157ee9f1e7289166de519797fd9a4eb1008bf4d44dc38ad16456a6a43116ade1b2b9f8893f810e12f58c358dde5efd
+  data.tar.gz: 2a1fa04804fa329fc0cb8d1e73c926cc08e7b290d6eadc88dff4baae898f0007f861f30fc2a0c321bb39f0de505ff95ca5f6b59f0e7fca9a6380f01cb0d08ea0

data/bin/linear

@@ -8,21 +8,47 @@ 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:
+    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"
 
@@ -50,38 +76,41 @@ 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]"
+when 'mine'
+  begin
+    Linear::Commands.my_issues
+  rescue => e
+    puts "Error: #{e.message}"
     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!
-
+when 'teams'
   begin
-    Linear::Commands.search(query, options)
+    Linear::Commands.list_teams
   rescue => e
     puts "Error: #{e.message}"
     exit 1
   end
 
-when 'mine'
+when 'projects'
   begin
-    Linear::Commands.my_issues
+    Linear::Commands.list_projects
   rescue => e
     puts "Error: #{e.message}"
     exit 1
   end
 
-when 'teams'
+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_teams
+    Linear::Commands.list_issues(options)
   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
@@ -48,6 +50,17 @@ module Linear
       end
     end
 
+    def list_projects(client: Client.new)
+      result = client.query(Queries::PROJECTS)
+
+      projects = result.dig("data", "projects", "nodes") || []
+      if projects.empty?
+        puts "No projects found"
+      else
+        display_project_list(projects)
+      end
+    end
+
     def add_comment(issue_id, body, client: Client.new)
       # First get the issue to get its internal ID
       issue_result = client.query(Queries::ISSUE, { id: issue_id })
@@ -178,5 +191,30 @@ module Linear
       else "Unknown"
       end
     end
+
+    def display_project_list(projects)
+      puts "\nFound #{projects.length} project(s):\n\n"
+      projects.each do |project|
+        state_badge = "[#{project['state']}]".ljust(15)
+        progress = project['progress'] ? "#{(project['progress'] * 100).round}%" : "0%"
+        progress_badge = progress.ljust(6)
+        lead = (project.dig('lead', 'name') || 'No lead').ljust(20)
+
+        puts "#{project['name'].ljust(30)} #{state_badge} #{progress_badge} #{lead}"
+
+        if project['description'] && !project['description'].empty?
+          # Show first line of description
+          first_line = project['description'].lines.first&.strip
+          puts "  #{first_line[0..80]}#{'...' if first_line && first_line.length > 80}" if first_line
+        end
+
+        if project['targetDate']
+          puts "  Target: #{project['targetDate']}"
+        end
+
+        puts "  URL: #{project['url']}" if project['url']
+        puts ""
+      end
+    end
   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 {
@@ -76,6 +76,27 @@ module Linear
       }
     GQL
 
+    PROJECTS = <<~GQL
+      query {
+        projects {
+          nodes {
+            id
+            name
+            description
+            state
+            progress
+            startDate
+            targetDate
+            url
+            lead {
+              name
+              email
+            }
+          }
+        }
+      }
+    GQL
+
     WORKFLOW_STATES = <<~GQL
       query($teamId: String!) {
         team(id: $teamId) {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: linear-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Dave Kinkead
@@ -57,7 +57,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.1
 specification_version: 4
 summary: Ruby CLI wrapper for Linear GraphQL API
 test_files: []