linear-cli 0.7.6 → 0.7.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed24311870484d37b861be6bfe48af2edfc58b2c248764dd31f3f82a4ba282a5
-  data.tar.gz: c0404fc83e9157c97b75c1afa3fe0766a1d10838ea33e9284d380de6dde1d547
+  metadata.gz: 040dce1ff59ddd000240b8a03105928d775841be91d1fe50f974249e2ddc21fc
+  data.tar.gz: 0de33b286614b981e63ad75b14d1728e825d44e6ec2265c625a00888cdb32cf2
 SHA512:
-  metadata.gz: 529c58e8cfa1a550e23de0ea5f3c9bb43d559f34b8c6648aa80bdc0238ee63be00282bf6166da82bf4c5be909dd5a8212e74cd74b92e42a6d1e58bc0de98e0f8
-  data.tar.gz: ee09439dfb8d39fbec79ec0206822a9261b340b4e9c0bc15cfb529dcc68a0e3138810833250972cbbd4a30bee1149f5e280b544193dfc414cb825aefe1c20218
+  metadata.gz: 1f45d0fc3280fda121430d10078e49a5a870753a8fa4788943934a586134101b58c40cacbd8fb3d83bd140d36db70bf19e82a65e3a87770bcf6a6ab48aa8bbbe
+  data.tar.gz: 9333ae8a1cb9bab180035dba641c23a5315783bf3d6bd0e790f0b21eb3da0a8ae149c1264ff4619ef75caaff1ec51bf8fdf4cd7c1f36659552d8cb685b7f4332

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.7.7] - 2024-02-06
+### Added
+- Added ability to attach project to command (@bougyman)
+- Added issue pr command (@bougyman)
+- Added lcomment alias to add comments to issues (@bougyman)
+
 ## [0.7.5] - 2024-02-05
 ### Fixed
 - Fixed problem when choosing from multiple completed states (@bougyman)
@@ -45,8 +51,9 @@
 ### Added
 - Added new changelog management system (changelog-rb) (@bougyman)
 
-[Unreleased]: https://github.com/rubyists/linear-cli/compare/0.7.5...HEAD
-[0.7.5]: https://github.com/rubyists/linear-cli/compare/v0.7.3...0.7.5
+[Unreleased]: https://github.com/rubyists/linear-cli/compare/0.7.7...HEAD
+[0.7.7]: https://github.com/rubyists/linear-cli/compare/v0.7.5...0.7.7
+[0.7.5]: https://github.com/rubyists/linear-cli/compare/v0.7.3...v0.7.5
 [0.7.3]: https://github.com/rubyists/linear-cli/compare/v0.7.2...v0.7.3
 [0.7.2]: https://github.com/rubyists/linear-cli/compare/v0.7.1...v0.7.2
 [0.7.1]: https://github.com/rubyists/linear-cli/compare/v0.7.0...v0.7.1

data/Readme.adoc

@@ -133,8 +133,13 @@ at a time. You can also use the 'u' alias for 'update', and as always, the 'i' a
 
 [source,sh]
 ----
-$ lc issue update --comment "Here is a comment" CRY-1234
+$ lc issue update --comment "Here is a comment" CRY-1234 <1>
+$ lc issue update --comment - CRY-14 CRY-15 <2>
+$ lcomment CRY-1234 CRY-3 <3>
 ----
+<1> This will use the provided comment
+<2> This will prompt for a comment (use '-' to prompt)
+<3> This will always prompt you for a comment ('lcomment' is an alias for 'lc issue update --comment -')
 
 ===== Close one or many issues
 
@@ -152,4 +157,5 @@ Some command aliases are available to make things easier to type.
 $ lcls
 $ lcreate --description "This is a new issue" --labels Bug,Feature --team CRY
 $ lclose --reason "This issue sucks" CRY-1234 CRY-456
+$ lcancel --reason "These should never have been here" --trash CRY-1234 CRY-456
 ----

data/changelog/0.7.7/added_ability_to_attach_project_to_command.yml

@@ -0,0 +1,4 @@
+type: Added
+title: >
+  Added ability to attach project to command
+author: bougyman

data/changelog/0.7.7/added_issue_pr_command.yml

@@ -0,0 +1,4 @@
+type: Added
+title: >
+  Added issue pr command
+author: bougyman

data/changelog/0.7.7/added_lcomment_alias_to_add_comments_to_issues.yml

@@ -0,0 +1,4 @@
+type: Added
+title: >
+  Added lcomment alias to add comments to issues
+author: bougyman

data/changelog/0.7.7/tag.yml

@@ -0,0 +1 @@
+date: 2024-02-06

data/exe/lc

@@ -1,4 +1,8 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-exec File.join(__dir__, 'lc.sh'), *ARGV
+require 'pathname'
+script_dir = Pathname(__dir__).join('scripts')
+basename = File.basename(__FILE__)
+script = script_dir.join(basename).exist? ? script_dir.join(basename) : script_dir.join("#{basename}.sh")
+exec script.to_s, *ARGV

data/exe/lclose

@@ -0,0 +1 @@
+lc

data/exe/lcls

@@ -0,0 +1 @@
+lc

data/exe/lcomment

@@ -0,0 +1 @@
+lc

data/exe/lcreate

@@ -0,0 +1 @@
+lc

data/exe/{lc.sh → scripts/lc.sh}

@@ -9,9 +9,10 @@ then
     linear-cli "$@" 2>&1|sed 's/linear-cli/lc/g'
     exit 0
 fi
-if ! linear-cli "$@"
-then
-    printf "lc: linear-cli failed\n" >&2
+linear-cli "$@"
+result=$?
+if [ $result -gt 1 ]; then
+    printf "lc: linear-cli failed %s\n" $result >&2
     lc "$@" --help 2>&1
     exit 1
 fi

data/exe/scripts/lcls.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+exec lc issue list "$@"

data/exe/scripts/lcomment.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+exec linear-cli issue update --comment - "$@"

data/lib/linear/api.rb

@@ -42,7 +42,7 @@ module Rubyists
 
       def query(query)
         call format('{ "query": %s }', query.to_s.to_json)
-      rescue StandardError => e
+      rescue SmellsBad => e
         logger.error('Error in query', query:, error: e)
         raise e unless Rubyists::Linear.verbosity > 2
 

data/lib/linear/cli/caller.rb

@@ -9,8 +9,13 @@ module Rubyists
           # Global options for all commands
           mod.instance_eval do
             option :output, type: :string, default: 'text', values: %w[text json], desc: 'Output format'
-            option :debug, type: :integer, default: 0, desc: 'Debug level'
+            option :debug,
+                   type: :integer,
+                   aliases: ['-D'],
+                   default: 0,
+                   desc: 'Debug level (greater than 0 to see backtraces)'
           end
+
           Caller.class_eval do
             # Wraps the :call method so the debug option is honored, and we can trace the call
             # as well as handle any exceptions that are raised

data/lib/linear/cli/sub_commands.rb

@@ -1,10 +1,15 @@
 # frozen_string_literal: true
 
+# This is where all the _for methods live
+require_relative 'what_for'
+
 module Rubyists
   module Linear
     module CLI
       # The SubCommands module should be included in all commands with subcommands
       module SubCommands
+        include CLI::WhatFor
+
         def self.included(mod)
           mod.instance_eval do
             def const_added(const)
@@ -41,73 +46,6 @@ module Rubyists
           @prompt ||= CLI.prompt
         end
 
-        def team_for(key = nil)
-          return Rubyists::Linear::Team.find(key) if key
-
-          ask_for_team
-        end
-
-        def reason_for(reason = nil, four: nil)
-          return reason if reason
-
-          question = four ? "Reason for #{four}:" : 'Reason:'
-          prompt.ask(question)
-        end
-
-        def cancelled_state_for(thingy)
-          states = thingy.cancelled_states
-          return states.first if states.size == 1
-
-          selection = prompt.select('Choose a cancelled state', states.to_h { |s| [s.name, s.id] })
-          Rubyists::Linear::WorkflowState.find selection
-        end
-
-        def completed_state_for(thingy)
-          states = thingy.completed_states
-          return states.first if states.size == 1
-
-          selection = prompt.select('Choose a completed state', states.to_h { |s| [s.name, s.id] })
-          Rubyists::Linear::WorkflowState.find selection
-        end
-
-        def description_for(description = nil)
-          return description if description
-
-          prompt.multiline('Description:').map(&:chomp).join('\\n')
-        end
-
-        def title_for(title = nil)
-          return title if title
-
-          prompt.ask('Title:')
-        end
-
-        def labels_for(team, labels = nil)
-          return Rubyists::Linear::Label.find_all_by_name(labels.map(&:strip)) if labels
-
-          prompt.on(:keypress) do |event|
-            prompt.trigger(:keydown) if event.value == 'j'
-            prompt.trigger(:keyup) if event.value == 'k'
-          end
-          prompt.multi_select('Labels:', team.labels.to_h { |t| [t.name, t] })
-        end
-
-        def cut_branch!(branch_name)
-          if current_branch != default_branch
-            prompt.yes?("You are not on the default branch (#{default_branch}). Do you want to checkout #{default_branch} and create a new branch?") && git.checkout(default_branch) # rubocop:disable Layout/LineLength
-          end
-          git.branch(branch_name)
-        end
-
-        def branch_for(branch_name)
-          logger.trace('Looking for branch', branch_name:)
-          existing = git.branches[branch_name]
-          return cut_branch!(branch_name) unless existing
-
-          logger.trace('Branch found', branch: existing&.name)
-          existing
-        end
-
         def current_branch
           git.current_branch
         end

data/lib/linear/cli/version.rb

@@ -2,6 +2,6 @@
 
 module Rubyists
   module Linear
-    VERSION = '0.7.6'
+    VERSION = '0.7.7'
   end
 end

data/lib/linear/cli/what_for.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Linear
+    module CLI
+      # Module for the _for methods
+      module WhatFor
+        def editor_for(prefix)
+          file = Tempfile.open(prefix, Rubyists::Linear.tmpdir)
+          TTY::Editor.open(file.path)
+          file.close
+          File.readlines(file.path).map(&:chomp).join('\\n')
+        ensure
+          file&.close
+        end
+
+        def comment_for(issue, comment)
+          return comment unless comment.nil? || comment == '-'
+
+          comment = prompt.ask("Comment for #{issue.identifier} - #{issue.title} (- to open an editor)", default: '-')
+          return comment unless comment == '-'
+
+          editor_for %w[comment .md]
+        end
+
+        def team_for(key = nil)
+          return Rubyists::Linear::Team.find(key) if key
+
+          ask_for_team
+        end
+
+        def reason_for(reason = nil, four: nil)
+          return reason if reason && reason != '-'
+
+          question = four ? "Reason for #{TTY::Markdown.parse(four)}" : 'Reason'
+          answer = prompt.ask("#{question} (- to open an editor):", default: '-')
+          return answer unless answer == '-'
+
+          editor_for %w[reason .md]
+        end
+
+        def cancelled_state_for(thingy)
+          states = thingy.cancelled_states
+          return states.first if states.size == 1
+
+          selection = prompt.select('Choose a cancelled state', states.to_h { |s| [s.name, s.id] })
+          Rubyists::Linear::WorkflowState.find selection
+        end
+
+        def completed_state_for(thingy)
+          states = thingy.completed_states
+          return states.first if states.size == 1
+
+          selection = prompt.select('Choose a completed state', states.to_h { |s| [s.name, s.id] })
+          Rubyists::Linear::WorkflowState.find selection
+        end
+
+        def description_for(description = nil)
+          return description if description
+
+          prompt.multiline('Description:').map(&:chomp).join('\\n')
+        end
+
+        def title_for(title = nil)
+          return title if title
+
+          prompt.ask('Title:')
+        end
+
+        def ask_for_projects(projects, search: true)
+          prompt.warn("No project found matching #{search}.") if search
+          return projects.first if projects.size == 1
+
+          prompt.select('Project:', projects.to_h { |p| [p.name, p] })
+        end
+
+        def project_scores(projects, search_term)
+          projects.select { |p| p.match_score?(search_term).positive? }.sort_by { |p| p.match_score?(search_term) }
+        end
+
+        def project_for(team, project = nil)
+          projects = team.projects
+          return nil if projects.empty?
+
+          possibles = project_scores(projects, project)
+          return ask_for_projects(projects, search: project) if possibles.empty?
+
+          first = possibles.first
+          return first if first.match_score?(project) == 100
+
+          selections = possibles + (projects - possibles)
+          prompt.select('Project:', selections.to_h { |p| [p.name, p] }) if possibles.size.positive?
+        end
+
+        def pr_title_for(issue)
+          proposed = [pr_type_for(issue)]
+          proposed_scope = pr_scope_for(issue.title)
+          proposed << "(#{proposed_scope})" if proposed_scope
+          summary = issue.title.sub(/(?:#{ALLOWED_PR_TYPES})(\([^)]+\))? /, '')
+          proposed << ": #{issue.identifier} - #{summary}"
+          prompt.ask("Title for PR for #{issue.identifier} - #{summary}", default: proposed.join)
+        end
+
+        def pr_description_for(issue)
+          tmpfile = Tempfile.new([issue.identifier, '.md'], Rubyists::Linear.tmpdir)
+          # TODO: Look up templates
+          proposed = "# Context\n\n#{issue.description}\n\n## Issue\n\n#{issue.identifier}\n\n# Solution\n\n# Testing\n\n# Notes\n\n" # rubocop:disable Layout/LineLength
+          tmpfile.write(proposed) && tmpfile.close
+          desc = TTY::Editor.open(tmpfile.path)
+          return tmpfile if desc
+
+          File.open(tmpfile.path, 'w+') do |file|
+            file.puts prompt.ask("Description for PR for #{issue.identifier} - #{issue.title}", default: proposed)
+          end
+          tmpfile
+        end
+
+        def pr_type_for(issue)
+          proposed_type = issue.title.match(/^(#{ALLOWED_PR_TYPES})/i)
+          return proposed_type[1].downcase if proposed_type
+
+          prompt.select('What type of PR is this?', %w[fix feature chore refactor test docs style ci perf security])
+        end
+
+        def pr_scope_for(title)
+          proposed_scope = title.match(/^\w+\(([^\)]+)\)/)
+          return proposed_scope[1].downcase if proposed_scope
+
+          scope = prompt.ask('What is the scope of this PR?', default: 'none')
+          return nil if scope.empty? && scope == 'none'
+
+          scope
+        end
+
+        def labels_for(team, labels = nil)
+          return Rubyists::Linear::Label.find_all_by_name(labels.map(&:strip)) if labels
+
+          prompt.multi_select('Labels:', team.labels.to_h { |t| [t.name, t] })
+        end
+      end
+    end
+  end
+end

data/lib/linear/cli.rb

@@ -16,7 +16,14 @@ module Rubyists
       extend Dry::CLI::Registry
 
       def self.prompt
-        @prompt ||= TTY::Prompt.new
+        return @prompt if @prompt
+
+        @prompt = TTY::Prompt.new
+        @prompt.on(:keypress) do |event|
+          @prompt.trigger(:keydown) if event.value == 'j'
+          @prompt.trigger(:keyup) if event.value == 'k'
+        end
+        @prompt
       end
 
       def self.register_sub!(command, sub_file, klass)

data/lib/linear/commands/issue/create.rb

@@ -21,6 +21,7 @@ module Rubyists
           option :description, type: :string, aliases: ['-d'], desc: 'Issue Description'
           option :team, type: :string, aliases: ['-T'], desc: 'Team Identifier'
           option :labels, type: :array, aliases: ['-l'], desc: 'Labels for the issue (Comma separated list)'
+          option :project, type: :string, aliases: ['-p'], desc: 'Project Identifier'
           option :develop, type: :boolean, aliases: ['-D', '--dev'], desc: 'Start development after creating the issue'
 
           def call(**options)

data/lib/linear/commands/issue/pr.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'semantic_logger'
+require 'git'
+require_relative '../issue'
+
+module Rubyists
+  # Namespace for Linear
+  module Linear
+    M :issue, :user, :label
+    # Namespace for CLI
+    module CLI
+      module Issue
+        Pr = Class.new Dry::CLI::Command
+        # The Develop class is a Dry::CLI::Command to start/update development status of an issue
+        class Pr
+          include SemanticLogger::Loggable
+          include Rubyists::Linear::CLI::CommonOptions
+          include Rubyists::Linear::CLI::Issue # for #gimme_da_issue! and other Issue methods
+          desc 'Create a PR for an issue and push it to the remote'
+          argument :issue_id, required: true, desc: 'The Issue (i.e. CRY-1)'
+          option :title, required: false, desc: 'The title of the PR'
+          option :description, required: false, desc: 'The description of the PR'
+
+          def call(issue_id:, **options)
+            logger.debug('Creating  PR for issue issue', options:)
+            issue = gimme_da_issue!(issue_id, me: Rubyists::Linear::User.me)
+            branch_name = issue.branchName
+            branch = branch_for(branch_name)
+            branch.checkout
+            prompt.ok "Checked out branch #{branch_name}"
+            issue_pr(issue, **options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/linear/commands/issue/update.rb

@@ -19,11 +19,11 @@ module Rubyists
           include Rubyists::Linear::CLI::Issue # for #gimme_da_issue! and other Issue methods
           desc 'Update an issue'
           argument :issue_ids, type: :array, required: true, desc: 'Issue IDs (i.e. CRY-1)'
-          option :comment, type: :string, aliases: ['-m'], desc: 'Comment to add to the issue'
-          option :pr, type: :boolean, aliases: ['--pull-request'], default: false, desc: 'Create a pull request'
+          option :comment, type: :string, aliases: ['-m'], desc: 'Comment to add to the issue. - open an editor'
+          option :project, type: :string, aliases: ['-p'], desc: 'Project to move the issue to. - select from a list'
           option :cancel, type: :boolean, default: false, desc: 'Cancel the issue'
           option :close, type: :boolean, default: false, desc: 'Close the issue'
-          option :reason, type: :string, aliases: ['--butwhy'], desc: 'Reason for closing the issue'
+          option :reason, type: :string, aliases: ['--butwhy'], desc: 'Reason for closing the issue. - open an editor'
           option :trash,
                  type: :boolean,
                  default: false,
@@ -31,7 +31,8 @@ module Rubyists
 
           example [
             '--comment "This is a comment" CRY-1 CRY2    # Add a comment to multiple issues',
-            '--pr CRY-10                                 # Create a pull request for the issue',
+            '--comment -                   CRY-1 CRY2    # Add a comment to multiple issues, open an editor',
+            '--project "Manhattan" CRY-3 CRY-4           # Move tickets to a different project',
             '--close CRY-2                               # Close an issue. Will be prompted for a reason',
             '--close --reason "Done" CRY-1 CRY-2         # Close multiple issues with a reason',
             '--cancel --trash --reason "Garbage" CRY-2   # Cancel an issue, and throw it in the trash'

data/lib/linear/commands/issue.rb

@@ -4,6 +4,8 @@
 # as well as other helpers which are used in multiple commands and subcommands
 # This is also where the #prompt method is defined, which is used to display messages to the user and get input
 require_relative '../cli/sub_commands'
+require 'tty-editor'
+require 'git'
 
 module Rubyists
   module Linear
@@ -15,6 +17,7 @@ module Rubyists
         include CLI::SubCommands
 
         DESCRIPTION = 'Manage issues'
+        ALLOWED_PR_TYPES = 'bug|fix|sec(urity)|feat(ure)|chore|refactor|test|docs|style|ci|perf'
 
         # Aliases for Issue commands
         ALIASES = {
@@ -22,20 +25,21 @@ module Rubyists
           develop: %w[d dev],    # aliases for the develop command
           list: %w[l ls],        # aliases for the list command
           update: %w[u],         # aliases for the close command
+          pr: %w[pull-request],  # aliases for the pr command
           issue: %w[i issues]    # aliases for the main issue command itself
         }.freeze
 
         def issue_comment(issue, comment)
-          issue.add_comment(comment)
-          prompt.ok("Comment added to #{issue.identifier}")
+          issue.add_comment comment_for(issue, comment)
+          prompt.ok "Comment added to #{issue.identifier}"
         end
 
         def cancel_issue(issue, **options)
           reason = reason_for(options[:reason], four: "cancelling #{issue.identifier} - #{issue.title}")
-          issue_comment(issue, reason)
+          issue_comment issue, reason
           cancel_state = cancel_state_for(issue)
-          issue.close!(state: cancel_state, trash: options[:trash])
-          prompt.ok("#{issue.identifier} was cancelled")
+          issue.close! state: cancel_state, trash: options[:trash]
+          prompt.ok "#{issue.identifier} was cancelled"
         end
 
         def close_issue(issue, **options)
@@ -43,46 +47,61 @@ module Rubyists
           doing = cancelled ? 'cancelling' : 'closing'
           done = cancelled ? 'cancelled' : 'closed'
           workflow_state = cancelled ? cancelled_state_for(issue) : completed_state_for(issue)
-          reason = reason_for(options[:reason], four: "#{doing} #{issue.identifier} - #{issue.title}")
-          issue_comment(issue, reason)
-          issue.close!(state: workflow_state, trash: options[:trash])
-          prompt.ok("#{issue.identifier} was #{done}")
+          reason = reason_for(options[:reason], four: "#{doing} *#{issue.identifier} - #{issue.title}*")
+          issue_comment issue, reason
+          issue.close! state: workflow_state, trash: options[:trash]
+          prompt.ok "#{issue.identifier} was #{done}"
         end
 
-        def issue_pr(issue)
-          issue.create_pr!
-          prompt.ok("Pull request created for #{issue.identifier}")
+        def create_pr!(title:, body:)
+          return `gh pr create -a @me --title "#{title}" --body-file "#{body.path}"` if body.respond_to?(:path)
+
+          `gh pr create -a @me --title "#{title}" --body "#{body}"`
+        end
+
+        def issue_pr(issue, **options)
+          title = options[:title] || pr_title_for(issue)
+          body = options[:description] || pr_description_for(issue)
+          create_pr!(title:, body:)
+        end
+
+        def attach_project(issue, project_search)
+          project = project_for(issue.team, project_search)
+          issue.attach_to_project project
+          prompt.ok "#{issue.identifier} was attached to #{project.name}"
         end
 
         def update_issue(issue, **options)
           issue_comment(issue, options[:comment]) if options[:comment]
           return close_issue(issue, **options) if options[:close]
           return issue_pr(issue) if options[:pr]
+          return attach_project(issue, options[:project]) if options[:project]
           return if options[:comment]
 
-          prompt.warn('No action taken, no options specified')
-          prompt.ok('Issue was not updated')
+          prompt.warn 'No action taken, no options specified'
+          prompt.ok 'Issue was not updated'
         end
 
         def make_da_issue!(**options)
           # These *_for methods are defined in Rubyists::Linear::CLI::SubCommands
-          title = title_for options[:title]
-          description = description_for options[:description]
-          team = team_for options[:team]
-          labels = labels_for team, options[:labels]
-          Rubyists::Linear::Issue.create(title:, description:, team:, labels:)
+          title = title_for(options[:title])
+          description = description_for(options[:description])
+          team = team_for(options[:team])
+          labels = labels_for(team, options[:labels])
+          project = project_for(team, options[:project])
+          Rubyists::Linear::Issue.create(title:, description:, team:, labels:, project:)
         end
 
         def gimme_da_issue!(issue_id, me: Rubyists::Linear::User.me) # rubocop:disable Naming/MethodParameterName
           logger.trace('Looking up issue', issue_id:, me:)
           issue = Rubyists::Linear::Issue.find(issue_id)
-          if issue.assignee && issue.assignee[:id] == me.id
-            prompt.say("You are already assigned #{issue_id}")
+          if issue.assignee && issue.assignee.id == me.id
+            prompt.say "You are already assigned #{issue_id}"
             return issue
           end
 
-          prompt.say("Assigning issue #{issue_id} to ya")
-          updated = issue.assign! me
+          prompt.say "Assigning issue #{issue_id} to ya"
+          updated = issue.assign!(me)
           logger.trace 'Issue taken', issue: updated
           updated
         end

data/lib/linear/models/base_model/class_methods.rb

@@ -5,27 +5,55 @@ module Rubyists
     class BaseModel
       # Class methods for Linear models.
       module ClassMethods
-        def many_to_one(relation, klass)
+        def setter!(relation, klass)
+          define_method "#{relation}=" do |val|
+            hash = val.is_a?(Hash) ? val : val.updated_data
+            updated_data[relation] = hash
+            instance_variable_set("@#{relation}", Rubyists::Linear.const_get(klass).new(hash))
+          end
+        end
+
+        def getter!(relation)
           define_method relation do
             return instance_variable_get("@#{relation}") if instance_variable_defined?("@#{relation}")
-            return unless (val = data[relation])
 
-            instance_variable_set("@#{relation}", Rubyists::Linear.const_get(klass).new(val))
+            return unless (val = updated_data[relation])
+
+            send("#{relation}=", val)
           end
+        end
+
+        def many_to_one(relation, klass = nil)
+          klass ||= relation.to_s.camelize.to_sym
+          getter! relation
+          setter! relation, klass
+        end
+
+        alias one_to_one many_to_one
 
+        def many_setter!(relation, klass)
           define_method "#{relation}=" do |val|
-            hash = val.is_a?(Hash) ? val : val.data
-            updated_data[relation] = hash
-            instance_variable_set("@#{relation}", Rubyists::Linear.const_get(klass).new(hash))
+            vals = if val&.key?(:nodes)
+                     val[:nodes]
+                   else
+                     Array(val)
+                   end
+            updated_data[relation] = vals.map { |v| v.is_a?(Hash) ? v : v.updated_data }
+            new_relations = vals.map { |v| v.is_a?(Hash) ? Rubyists::Linear.const_get(klass).new(v) : v }
+            instance_variable_set("@#{relation}", new_relations)
           end
         end
 
-        alias one_to_one many_to_one
+        def one_to_many(relation, klass = nil)
+          klass ||= relation.to_s.singularize.camelize.to_sym
+          getter! relation
+          many_setter! relation, klass
+        end
 
         def find(id_val)
           camel_name = just_name.camelize :lower
-          bf = base_fragment
-          query_data = Api.query(query { __node(camel_name, id: id_val) { ___ bf } })
+          ff = full_fragment
+          query_data = Api.query(query { __node(camel_name, id: id_val) { ___ ff } })
           new query_data[camel_name.to_sym]
         end
 
@@ -63,6 +91,10 @@ module Rubyists
           const_get(:Base)
         end
 
+        def full_fragment
+          base_fragment
+        end
+
         def basic_filter
           return const_get(:BASIC_FILTER) if const_defined?(:BASIC_FILTER)
 

data/lib/linear/models/base_model/method_magic.rb

@@ -5,17 +5,15 @@ module Rubyists
     class BaseModel
       # Methods for Linear models.
       module MethodMagic
-        def self.included(base) # rubocop:disable Metrics/MethodLength
+        def self.included(base) # rubocop:disable Metrics/AbcSize
           base.instance_eval do
             base.base_fragment.__nodes.each do |node|
               sym = node.__name.to_sym
-              define_method node.__name do
-                updated_data[sym]
-              end
+              define_method(sym) { updated_data[sym] } unless instance_methods.include? sym
+              esym = :"#{sym}="
+              next if instance_methods.include? esym
 
-              define_method "#{node.__name}=" do |value|
-                updated_data[sym] = value
-              end
+              define_method(esym) { |value| updated_data[sym] = value }
             end
           end
         end

data/lib/linear/models/issue/class_methods.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Rubyists
+  # Namespace for Linear
+  module Linear
+    M :user, :team
+    # The Issue class represents a Linear issue.
+    class Issue
+      # Class methods for Issue
+      module ClassMethods
+        def base_fragment
+          @base_fragment ||= fragment('BaseIssue', 'Issue') do
+            ___ Base
+            assignee { ___ User.base_fragment }
+            team { ___ Team.base_fragment }
+          end
+        end
+
+        def full_fragment
+          @full_fragment ||= fragment('FullIssue', 'Issue') do
+            ___ Base
+            assignee { ___ User.full_fragment }
+            team { ___ Team.full_fragment }
+          end
+        end
+
+        def find_all(*slugs)
+          slugs.flatten.map { |slug| find(slug) }
+        end
+
+        def create(title:, description:, team:, project:, labels: [])
+          team_id = team.id
+          label_ids = labels.map(&:id)
+          input = { title:, description:, teamId: team_id }
+          input[:labelIds] = label_ids unless label_ids.empty?
+          input[:projectId] = project.id if project
+          m = mutation { issueCreate(input:) { issue { ___ Issue.base_fragment } } }
+          query_data = Api.query(m)
+          new query_data.dig(:issueCreate, :issue)
+        end
+      end
+    end
+  end
+end

data/lib/linear/models/issue.rb

@@ -5,13 +5,15 @@ require 'gqli'
 module Rubyists
   # Namespace for Linear
   module Linear
-    M :base_model, :user
+    M :base_model
     Issue = Class.new(BaseModel)
+    M 'issue/class_methods'
     # The Issue class represents a Linear issue.
-    class Issue # rubocop:disable Metrics/ClassLength
+    class Issue
       include SemanticLogger::Loggable
-      one_to_one :assignee, :User
-      one_to_one :team, :Team
+      extend ClassMethods
+      many_to_one :assignee, :User
+      many_to_one :team, :Team
 
       BASIC_FILTER = { completedAt: { null: true } }.freeze
 
@@ -25,38 +27,6 @@ module Rubyists
         updatedAt
       end
 
-      class << self
-        def base_fragment
-          @base_fragment ||= fragment('IssueWithTeams', 'Issue') do
-            ___ Base
-            assignee { ___ User.base_fragment }
-            team { ___ Team.base_fragment }
-          end
-        end
-
-        def find(slug)
-          q = query { issue(id: slug) { ___ Issue.base_fragment } }
-          data = Api.query(q)
-          raise NotFoundError, "Issue not found: #{slug}" if data.nil?
-
-          new(data[:issue])
-        end
-
-        def find_all(*slugs)
-          slugs.flatten.map { |slug| find(slug) }
-        end
-
-        def create(title:, description:, team:, labels: [])
-          team_id = team.id
-          label_ids = labels.map(&:id)
-          input = { title:, description:, teamId: team_id }
-          input[:labelIds] = label_ids unless label_ids.empty?
-          m = mutation { issueCreate(input:) { issue { ___ Issue.base_fragment } } }
-          query_data = Api.query(m)
-          new query_data.dig(:issueCreate, :issue)
-        end
-      end
-
       def comment_fragment
         @comment_fragment ||= fragment('Comment', 'Comment') do
           id
@@ -65,6 +35,21 @@ module Rubyists
         end
       end
 
+      def update!(input)
+        id_for_this = identifier
+        m = mutation { issueUpdate(id: id_for_this, input:) { issue { ___ Issue.full_fragment } } }
+        query_data = Api.query(m)
+        updated = query_data.dig(:issueUpdate, :issue)
+        raise SmellsBad, "Unknown response for issue update: #{data} (should have :issueUpdate key)" if updated.nil?
+
+        @data = @updated_data = updated
+        self
+      end
+
+      def attach_to_project(project)
+        update!({ projectId: project.id })
+      end
+
       # Reference for this mutation:
       # https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference/inputs/CommentCreateInput
       def add_comment(comment)
@@ -81,7 +66,7 @@ module Rubyists
         id_for_this = identifier
         input = { stateId: close_state.id }
         input[:trash] = true if trash
-        mutation { issueUpdate(id: id_for_this, input:) { issue { ___ Issue.base_fragment } } }
+        mutation { issueUpdate(id: id_for_this, input:) { issue { ___ Issue.full_fragment } } }
       end
 
       def close!(state: nil, trash: false)
@@ -97,7 +82,7 @@ module Rubyists
 
       def assign!(user)
         this_id = identifier
-        m = mutation { issueUpdate(id: this_id, input: { assigneeId: user.id }) { issue { ___ Issue.base_fragment } } }
+        m = mutation { issueUpdate(id: this_id, input: { assigneeId: user.id }) { issue { ___ Issue.full_fragment } } }
         query_data = Api.query(m)
         updated = query_data.dig(:issueUpdate, :issue)
         raise SmellsBad, "Unknown response for issue update: #{data} (should have :issueUpdate key)" if updated.nil?

data/lib/linear/models/project.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'gqli'
+
+module Rubyists
+  # Namespace for Linear
+  module Linear
+    M :base_model
+    Project = Class.new(BaseModel)
+    # The Project class represents a Linear workflow state.
+    class Project
+      include SemanticLogger::Loggable
+
+      Base = fragment('BaseProject', 'Project') do
+        id
+        name
+        content
+        slugId
+        description
+        url
+        createdAt
+        updatedAt
+      end
+
+      def slug
+        File.basename(url).sub("-#{slugId}", '')
+      end
+
+      def match_score?(string)
+        downed = string.downcase
+        return 100 if downed.split.join('-') == slug || downed == name.downcase
+        return 75 if name.include?(string) || slug.include?(downed)
+        return 50 if description.downcase.include?(downed)
+
+        0
+      end
+
+      def to_s
+        format('%<name>-12s %<url>s', name:, url:)
+      end
+
+      def inspection
+        format('name: "%<name>s" type: "%<url>s"', name:, url:)
+      end
+    end
+  end
+end

data/lib/linear/models/team.rb

@@ -5,11 +5,12 @@ require 'gqli'
 module Rubyists
   # Namespace for Linear
   module Linear
-    M :base_model, :issue, :user, :workflow_state
+    M :base_model, :issue, :project, :workflow_state, :user
     Team = Class.new(BaseModel)
     # The Issue class represents a Linear issue.
     class Team
       include SemanticLogger::Loggable
+      one_to_many :projects
 
       # TODO: Make this configurable
       BaseFilter = { # rubocop:disable Naming/ConstantName
@@ -29,15 +30,11 @@ module Rubyists
         updatedAt
       end
 
-      def self.find(key)
-        q = query do
-          team(id: key) { ___ Base }
+      def self.full_fragment
+        @full_fragment ||= fragment('WholeTeam', 'Team') do
+          ___ Base
+          projects { nodes { ___ Project.base_fragment } }
         end
-        data = Api.query(q)
-        hash = data[:team]
-        raise NotFoundError, "Team not found: #{key}" unless hash
-
-        new hash
       end
 
       def self.mine

data/linear-cli.gemspec

@@ -29,7 +29,7 @@ Gem::Specification.new do |spec|
     end
   end
   spec.bindir = 'exe'
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }.reject { |f| f.end_with?('.sh') }
   spec.require_paths = ['lib']
 
   # Uncomment to register a new dependency of your gem

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: linear-cli
 version: !ruby/object:Gem::Version
-  version: 0.7.6
+  version: 0.7.7
 platform: ruby
 authors:
 - Tj (bougyman) Vanderpoel
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-05 00:00:00.000000000 Z
+date: 2024-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -197,13 +197,10 @@ email:
 - tj@rubyists.com
 executables:
 - lc
-- lc.sh
 - lclose
-- lclose.sh
 - lcls
-- lcls.sh
+- lcomment
 - lcreate
-- lcreate.sh
 - linear-cli
 extensions: []
 extra_rdoc_files: []
@@ -233,17 +230,23 @@ files:
 - changelog/0.7.3/tag.yml
 - changelog/0.7.5/fixed_problem_when_choosing_from_multiple_completed_states.yml
 - changelog/0.7.5/tag.yml
+- changelog/0.7.7/added_ability_to_attach_project_to_command.yml
+- changelog/0.7.7/added_issue_pr_command.yml
+- changelog/0.7.7/added_lcomment_alias_to_add_comments_to_issues.yml
+- changelog/0.7.7/tag.yml
 - changelog/unreleased/.gitkeep
 - cinemas/listings.cinema
 - exe/lc
-- exe/lc.sh
 - exe/lclose
-- exe/lclose.sh
 - exe/lcls
-- exe/lcls.sh
+- exe/lcomment
 - exe/lcreate
-- exe/lcreate.sh
 - exe/linear-cli
+- exe/scripts/lc.sh
+- exe/scripts/lclose.sh
+- exe/scripts/lcls.sh
+- exe/scripts/lcomment.sh
+- exe/scripts/lcreate.sh
 - lib/linear.rb
 - lib/linear/api.rb
 - lib/linear/cli.rb
@@ -252,10 +255,12 @@ files:
 - lib/linear/cli/sub_commands.rb
 - lib/linear/cli/version.rb
 - lib/linear/cli/watcher.rb
+- lib/linear/cli/what_for.rb
 - lib/linear/commands/issue.rb
 - lib/linear/commands/issue/create.rb
 - lib/linear/commands/issue/develop.rb
 - lib/linear/commands/issue/list.rb
+- lib/linear/commands/issue/pr.rb
 - lib/linear/commands/issue/take.rb
 - lib/linear/commands/issue/update.rb
 - lib/linear/commands/team.rb
@@ -267,7 +272,9 @@ files:
 - lib/linear/models/base_model/class_methods.rb
 - lib/linear/models/base_model/method_magic.rb
 - lib/linear/models/issue.rb
+- lib/linear/models/issue/class_methods.rb
 - lib/linear/models/label.rb
+- lib/linear/models/project.rb
 - lib/linear/models/team.rb
 - lib/linear/models/user.rb
 - lib/linear/models/workflow_state.rb

data/exe/lclose

@@ -1,4 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-exec File.join(__dir__, 'lclose.sh'), *ARGV

data/exe/lcls

@@ -1,4 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-exec File.join(__dir__, 'lcls.sh'), *ARGV

data/exe/lcls.sh

@@ -1,2 +0,0 @@
-#!/usr/bin/env bash
-exec linear-cli issue list "$@"

data/exe/lcreate

@@ -1,4 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-exec File.join(__dir__, 'lcreate.sh'), *ARGV