shapeup-cli 0.3.3 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 919e0d1e776b34cb20cb2854bedcb2b1c12806b79fc1cd5297df8e1506d70eab
-  data.tar.gz: 7e4a40392f129a6262627ace44cd164bff87ac160be9d8b93f495acab1838a35
+  metadata.gz: 167d55101c1c27e4ce1bd6dc8e6f52599937489e4a6218c248f901a150282273
+  data.tar.gz: d511b7da6d77e6437ee431951dd591f59b6ed70807be55618564c79b2e9a828b
 SHA512:
-  metadata.gz: b3ef79a008f0f118d315621fe3980ba4d06f557f9276b19b569285e922647fd1e6f6e07924b25b21d3024281214297990859cf220dec3376890957f916cd3e4c
-  data.tar.gz: fc234742413cfe3e58d1cf75e19e48a88f28ff8fa300e4e6549a3948e09c53b4dbc02695e9792f1d2cc92fa03eef0acd8d19bfc27f0d40604b602750a9bb74ea
+  metadata.gz: 6cc0fc54f960c09e7338a5ca49ed2eb61820b9246438c2533ce1f1686f5dd4e4b053aed3f63a79e5855a046bff5b859efcf137b1f8db0bdceb8a014220a2c0aa
+  data.tar.gz: f4dbcbd90cd4ac33b2d9096fb683b08e76f71f042184faee5a4b91bd7a88802655a593c5b4a60ade0925ad14d07c5c8e7d37991dd31327a6f8c6adef598c403f

data/lib/shapeup_cli/commands/checklist.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Checklist < Base
+      def self.metadata
+        {
+          command: "checklist",
+          path: "shapeup checklist",
+          short: "Manage the checklist on a pitch or issue",
+          subcommands: [
+            { name: "list", short: "List items (default)", path: "shapeup checklist --pitch <id>" },
+            { name: "add", short: "Add an item", path: 'shapeup checklist add --pitch <id> "Item text"' },
+            { name: "tick", short: "Mark an item complete", path: "shapeup checklist tick <item_id>" },
+            { name: "untick", short: "Mark an item incomplete", path: "shapeup checklist untick <item_id>" },
+            { name: "edit", short: "Rename an item", path: 'shapeup checklist edit <item_id> "New text"' },
+            { name: "remove", short: "Delete an item", path: "shapeup checklist remove <item_id>" }
+          ],
+          flags: [
+            { name: "pitch", type: "string", usage: "Pitch ID (for list/add)" },
+            { name: "issue", type: "string", usage: "Issue ID (for list/add)" }
+          ],
+          examples: [
+            "shapeup checklist --pitch 42",
+            "shapeup checklist --issue 7",
+            'shapeup checklist add --pitch 42 "Confirm Slack webhook"',
+            "shapeup checklist tick 18",
+            "shapeup checklist untick 18",
+            'shapeup checklist edit 18 "Confirm Slack webhook secret rotation"',
+            "shapeup checklist remove 18"
+          ]
+        }
+      end
+
+      def execute
+        subcommand = positional_arg(0)
+
+        case subcommand
+        when "add"        then add
+        when "tick"       then tick
+        when "untick"     then untick
+        when "edit"       then edit
+        when "remove"     then remove
+        when "list", nil  then list
+        else list
+        end
+      end
+
+      private
+        def list
+          type, id = resolve_target
+          result = call_tool("list_checklist_items", checklistable_type: type, checklistable_id: id.to_s)
+
+          render result,
+            summary: "Checklist on #{type} ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup checklist add --#{type.downcase == 'package' ? 'pitch' : 'issue'} #{id} \"Item\"", description: "Add an item" },
+              { cmd: "shapeup checklist tick <item_id>", description: "Tick an item" }
+            ]
+        end
+
+        def add
+          type, id = resolve_target
+          text = positional_arg(1) || abort('Usage: shapeup checklist add --pitch <id> "Item text"')
+
+          result = call_tool("create_checklist_item", checklistable_type: type, checklistable_id: id.to_s, content: text)
+
+          render result,
+            summary: "Item added to #{type} ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup checklist --#{type.downcase == 'package' ? 'pitch' : 'issue'} #{id}", description: "View checklist" }
+            ]
+        end
+
+        def tick
+          item_id = positional_arg(1) || abort("Usage: shapeup checklist tick <item_id>")
+
+          result = call_tool("update_checklist_item", checklist_item: item_id.to_s, completed: true)
+
+          render result, summary: "Item ##{item_id} ticked"
+        end
+
+        def untick
+          item_id = positional_arg(1) || abort("Usage: shapeup checklist untick <item_id>")
+
+          result = call_tool("update_checklist_item", checklist_item: item_id.to_s, completed: false)
+
+          render result, summary: "Item ##{item_id} unticked"
+        end
+
+        def edit
+          item_id = positional_arg(1) || abort('Usage: shapeup checklist edit <item_id> "New text"')
+          text = positional_arg(2) || abort('Usage: shapeup checklist edit <item_id> "New text"')
+
+          result = call_tool("update_checklist_item", checklist_item: item_id.to_s, content: text)
+
+          render result, summary: "Item ##{item_id} updated"
+        end
+
+        def remove
+          item_id = positional_arg(1) || abort("Usage: shapeup checklist remove <item_id>")
+
+          result = call_tool("delete_checklist_item", checklist_item: item_id.to_s)
+
+          render result, summary: "Item ##{item_id} removed"
+        end
+
+        def resolve_target
+          pitch = extract_option("--pitch")
+          issue = extract_option("--issue")
+
+          if pitch
+            [ "Package", pitch ]
+          elsif issue
+            [ "Issue", issue ]
+          else
+            abort("Specify a target: --pitch <id> or --issue <id>")
+          end
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands/issues.rb

@@ -25,6 +25,8 @@ module ShapeupCli
             { name: "watch", short: "Watch an issue", path: "shapeup issues watch <id>" },
             { name: "unwatch", short: "Stop watching an issue", path: "shapeup issues unwatch <id>" },
             { name: "watching", short: "List issues you are watching", path: "shapeup watching" },
+            { name: "convert", short: "Convert issue into a new pitch", path: "shapeup issues convert <id>" },
+            { name: "add-to-pitch", short: "Fold issue content into an existing pitch", path: "shapeup issues add-to-pitch <id> --pitch <pitch_id>" },
             { name: "delete", short: "Delete an issue", path: "shapeup issues delete <id>" }
           ],
           flags: [
@@ -37,6 +39,7 @@ module ShapeupCli
             { name: "all", type: "bool", usage: "Include done/closed issues (hidden by default)" },
             { name: "content", type: "string", usage: "Issue content/description" },
             { name: "title", type: "string", usage: "Issue title (for update)" },
+            { name: "pitch", type: "string", usage: "Pitch ID (for add-to-pitch)" },
             { name: "archived", type: "bool", usage: "Include iceboxed issues in list" },
             { name: "no-comments", type: "bool", usage: "Hide embedded comments on show (default: show)" },
             { name: "comments-limit", type: "integer", usage: "Max comments to embed on show (default: 10, max: 50)" }
@@ -60,7 +63,9 @@ module ShapeupCli
             "shapeup issues assign 42 --user 7",
             "shapeup issues unassign 42",
             "shapeup issues watch 42",
-            "shapeup watching"
+            "shapeup watching",
+            "shapeup issues convert 42",
+            "shapeup issues add-to-pitch 42 --pitch 10"
           ]
         }
       end
@@ -69,22 +74,24 @@ module ShapeupCli
         subcommand = positional_arg(0)
 
         case subcommand
-        when "show"     then show
-        when "create"   then create
-        when "update"   then update
-        when "move"     then move
-        when "done"     then mark_done
-        when "close"    then close
-        when "reopen"   then reopen
-        when "icebox"   then icebox
-        when "defrost"  then defrost
-        when "assign"   then assign
-        when "unassign" then unassign
-        when "watch"    then watch
-        when "unwatch"  then unwatch
-        when "watching" then watching
-        when "delete"   then delete
-        when "list", nil then list
+        when "show"          then show
+        when "create"        then create
+        when "update"        then update
+        when "move"          then move
+        when "done"          then mark_done
+        when "close"         then close
+        when "reopen"        then reopen
+        when "icebox"        then icebox
+        when "defrost"       then defrost
+        when "assign"        then assign
+        when "unassign"      then unassign
+        when "watch"         then watch
+        when "unwatch"       then unwatch
+        when "watching"      then watching
+        when "convert"       then convert
+        when "add-to-pitch"  then add_to_pitch
+        when "delete"        then delete
+        when "list", nil     then list
         else
           # Bare numeric arg = show
           if subcommand&.match?(/\A\d+\z/)
@@ -334,6 +341,32 @@ module ShapeupCli
               { cmd: "shapeup issues", description: "List remaining issues" }
             ]
         end
+
+        def convert
+          id = positional_arg(1) || abort("Usage: shapeup issues convert <id>")
+
+          result = call_tool("convert_issue_to_pitch", issue: id.to_s)
+
+          render result,
+            summary: "Issue ##{id} converted to a pitch",
+            breadcrumbs: [
+              { cmd: "shapeup pitches", description: "List pitches" },
+              { cmd: "shapeup pitch <id>", description: "Open the new pitch" }
+            ]
+        end
+
+        def add_to_pitch
+          id = positional_arg(1) || abort('Usage: shapeup issues add-to-pitch <id> --pitch <pitch_id>')
+          pitch_id = extract_option("--pitch") || abort('Usage: shapeup issues add-to-pitch <id> --pitch <pitch_id>')
+
+          result = call_tool("add_issue_to_pitch", issue: id.to_s, package: pitch_id.to_s)
+
+          render result,
+            summary: "Issue ##{id} folded into pitch ##{pitch_id}",
+            breadcrumbs: [
+              { cmd: "shapeup pitch #{pitch_id}", description: "Open the pitch" }
+            ]
+        end
     end
   end
 end

data/lib/shapeup_cli/commands/pitches.rb

@@ -17,6 +17,7 @@ module ShapeupCli
           flags: [
             { name: "status", type: "string", usage: "Filter by status: idea, framed, shaped" },
             { name: "cycle", type: "string", usage: "Filter by cycle ID" },
+            { name: "tag", type: "string", usage: "Filter by tag name" },
             { name: "limit", type: "integer", usage: "Limit number of results" },
             { name: "stream", type: "string", usage: "Stream name or ID (for create)" },
             { name: "appetite", type: "string", usage: "Appetite: unknown, small_batch, big_batch (for create, default: big_batch)" },
@@ -28,6 +29,7 @@ module ShapeupCli
             "shapeup pitches list",
             "shapeup pitches list --status shaped",
             "shapeup pitches list --cycle 5",
+            "shapeup pitches list --tag q3-plan",
             "shapeup pitch 42",
             "shapeup pitch 42 --json",
             "shapeup pitches create \"Redesign Search\" --stream \"Platform\"",
@@ -53,9 +55,11 @@ module ShapeupCli
         def list
           cycle_id = extract_option("--cycle")
           status = extract_option("--status")
+          tag = extract_option("--tag")
           limit = extract_option("--limit")&.to_i
           args = {}
           args[:cycle] = cycle_id if cycle_id
+          args[:tag] = tag if tag
 
           result = call_tool("list_packages", **args)
           data = Output.extract_data(result)
@@ -68,6 +72,7 @@ module ShapeupCli
           summary = "Pitches"
           summary += " (#{status})" if status
           summary += " in cycle #{cycle_id}" if cycle_id
+          summary += " tagged #{tag}" if tag
           summary += " — #{packages.length} results"
 
           render_list(packages, summary)

data/lib/shapeup_cli/commands/tags.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Tags < Base
+      def self.metadata
+        {
+          command: "tags",
+          path: "shapeup tags",
+          short: "List, add, and remove tags on pitches and issues",
+          subcommands: [
+            { name: "list", short: "List the org's tag vocabulary (default)", path: "shapeup tags" },
+            { name: "add", short: "Tag a pitch or issue", path: "shapeup tags add --pitch <id> <name>" },
+            { name: "remove", short: "Untag a pitch or issue", path: "shapeup tags remove --pitch <id> <name>" }
+          ],
+          flags: [
+            { name: "pitch", type: "string", usage: "Pitch ID (for add/remove)" },
+            { name: "issue", type: "string", usage: "Issue ID (for add/remove)" }
+          ],
+          examples: [
+            "shapeup tags",
+            "shapeup tags add --pitch 42 q3-plan",
+            "shapeup tags add --issue 7 needs-design",
+            "shapeup tags remove --pitch 42 q3-plan",
+            "shapeup pitches list --tag q3-plan"
+          ]
+        }
+      end
+
+      def execute
+        subcommand = positional_arg(0)
+
+        case subcommand
+        when "add"        then add
+        when "remove"     then remove
+        when "list", nil  then list
+        else list
+        end
+      end
+
+      private
+        def list
+          result = call_tool("list_tags")
+
+          render result,
+            summary: "Tags",
+            breadcrumbs: [
+              { cmd: "shapeup tags add --pitch <id> <name>", description: "Tag a pitch" },
+              { cmd: "shapeup pitches list --tag <name>", description: "Filter pitches by tag" }
+            ]
+        end
+
+        def add
+          type, id = resolve_target
+          name = positional_arg(1) || abort("Usage: shapeup tags add --pitch <id> <name>")
+
+          result = call_tool("add_tag", taggable_type: type, taggable_id: id.to_s, name: name)
+
+          render result, summary: "Tagged #{type} ##{id}"
+        end
+
+        def remove
+          type, id = resolve_target
+          name = positional_arg(1) || abort("Usage: shapeup tags remove --pitch <id> <name>")
+
+          result = call_tool("remove_tag", taggable_type: type, taggable_id: id.to_s, name: name)
+
+          render result, summary: "Untagged #{type} ##{id}"
+        end
+
+        def resolve_target
+          pitch = extract_option("--pitch")
+          issue = extract_option("--issue")
+
+          if pitch
+            [ "Package", pitch ]
+          elsif issue
+            [ "Issue", issue ]
+          else
+            abort("Specify a target: --pitch <id> or --issue <id>")
+          end
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands.rb

@@ -62,6 +62,9 @@ module ShapeupCli
           issues unwatch <id>       Stop watching
           watching                  List issues you are watching
           issues delete <id>        Delete an issue
+          issues convert <id>       Convert issue to a new pitch
+          issues add-to-pitch <id> --pitch <pid>
+                                    Fold issue into an existing pitch
 
         Comments:
           comments list --issue <id>           List comments on an issue
@@ -69,6 +72,22 @@ module ShapeupCli
           comments add --issue <id> "Text"     Add a comment to an issue
           comments add --pitch <id> "Text"     Add a comment to a pitch
 
+        Checklist:
+          checklist --pitch <id>               List the checklist on a pitch
+          checklist --issue <id>               List the checklist on an issue
+          checklist add --pitch <id> "Text"    Add an item
+          checklist tick <item_id>             Mark an item complete
+          checklist untick <item_id>           Mark an item incomplete
+          checklist edit <item_id> "Text"      Rename an item
+          checklist remove <item_id>           Delete an item
+
+        Tags:
+          tags                                 List the org's tag vocabulary
+          tags add --pitch <id> <name>         Tag a pitch
+          tags add --issue <id> <name>         Tag an issue
+          tags remove --pitch <id> <name>      Untag a pitch
+          tags remove --issue <id> <name>      Untag an issue
+
         My Work:
           my-work, me               Show everything assigned to me
 
@@ -128,10 +147,12 @@ module ShapeupCli
         tasks          Manage tasks (list, create, complete)
         todo           Create a task (shortcut)
         done           Complete task(s) (shortcut)
-        issues         Manage issues (list, show, create, move, icebox, watch)
+        issues         Manage issues (list, show, create, move, icebox, watch, convert, add-to-pitch)
         issue          Show an issue (shortcut)
         watching       List watched issues (shortcut)
         comments       List and add comments (list, add)
+        checklist      Manage checklist items on pitches/issues (list, add, tick, untick, edit, remove)
+        tags           List/add/remove tags on pitches and issues
         my-work / me   Show my assigned work
         search         Search everything
         config         Show/set config (set, show, init)
@@ -159,3 +180,5 @@ require_relative "commands/auth"
 require_relative "commands/config_cmd"
 require_relative "commands/setup"
 require_relative "commands/comments"
+require_relative "commands/checklist"
+require_relative "commands/tags"

data/lib/shapeup_cli.rb

@@ -16,7 +16,7 @@ require_relative "shapeup_cli/output"
 require_relative "shapeup_cli/commands"
 
 module ShapeupCli
-  VERSION = "0.3.2"
+  VERSION = "0.3.4"
   DEFAULT_HOST = "https://shapeup.cc"
 
   # Exit codes
@@ -30,18 +30,20 @@ module ShapeupCli
   EXIT_INTERRUPTED = 130
 
   COMMAND_MAP = {
-    "orgs"    => Commands::Orgs,
-    "pitches" => Commands::Pitches,
-    "cycle"   => Commands::Cycle,
-    "scopes"  => Commands::Scopes,
-    "tasks"   => Commands::Tasks,
-    "issues"  => Commands::Issues,
-    "my-work" => Commands::MyWork,
-    "search"  => Commands::Search,
-    "auth"    => Commands::Auth,
-    "config"  => Commands::ConfigCmd,
-    "setup"   => Commands::Setup,
-    "comments" => Commands::Comments
+    "orgs"      => Commands::Orgs,
+    "pitches"   => Commands::Pitches,
+    "cycle"     => Commands::Cycle,
+    "scopes"    => Commands::Scopes,
+    "tasks"     => Commands::Tasks,
+    "issues"    => Commands::Issues,
+    "my-work"   => Commands::MyWork,
+    "search"    => Commands::Search,
+    "auth"      => Commands::Auth,
+    "config"    => Commands::ConfigCmd,
+    "setup"     => Commands::Setup,
+    "comments"  => Commands::Comments,
+    "checklist" => Commands::Checklist,
+    "tags"      => Commands::Tags
   }.freeze
 
   def self.run(argv)
@@ -77,6 +79,8 @@ module ShapeupCli
     when "issue"          then Commands::Issues.run(["show"] + args)
     when "watching"       then Commands::Issues.run(["watching"] + args)
     when "comments"       then Commands::Comments.run(args)
+    when "checklist"      then Commands::Checklist.run(args)
+    when "tags"           then Commands::Tags.run(args)
     when "my-work", "me"  then Commands::MyWork.run(args)
     when "search"         then Commands::Search.run(args)
     when "config"         then Commands::ConfigCmd.run(args)

data/skills/shapeup/SKILL.md

@@ -133,11 +133,26 @@ Manage pitches, scopes, tasks, issues, and cycles via the ShapeUp CLI. Columns a
 | Unassign from issue | `shapeup issues unassign <id>` (self) / `--user <id>` |
 | Watch / unwatch | `shapeup issues watch <id>` / `unwatch <id>` |
 | My watched issues | `shapeup watching --json` |
+| Convert issue to pitch | `shapeup issues convert <id>` |
+| Fold issue into pitch | `shapeup issues add-to-pitch <id> --pitch <pitch_id>` |
 | **Comments** | |
 | List comments on issue | `shapeup comments list --issue <id> --json` |
 | List comments on pitch | `shapeup comments list --pitch <id> --json` |
 | Add comment to issue | `shapeup comments add --issue <id> "Comment text"` |
 | Add comment to pitch | `shapeup comments add --pitch <id> "Comment text"` |
+| **Checklist** | |
+| List checklist on pitch | `shapeup checklist --pitch <id>` |
+| List checklist on issue | `shapeup checklist --issue <id>` |
+| Add an item | `shapeup checklist add --pitch <id> "Item text"` |
+| Tick / untick an item | `shapeup checklist tick <item_id>` / `untick <item_id>` |
+| Rename an item | `shapeup checklist edit <item_id> "New text"` |
+| Remove an item | `shapeup checklist remove <item_id>` |
+| **Tags** | |
+| List tag vocabulary | `shapeup tags` |
+| Tag a pitch | `shapeup tags add --pitch <id> <name>` |
+| Tag an issue | `shapeup tags add --issue <id> <name>` |
+| Untag | `shapeup tags remove --pitch <id> <name>` |
+| Filter pitches by tag | `shapeup pitches list --tag <name>` |
 | **Pitches** | |
 | List pitches | `shapeup pitches list --json` |
 | List shaped only | `shapeup pitches list --status shaped --json` |

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shapeup-cli
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.4
 platform: ruby
 authors:
 - ShapeUp
@@ -27,6 +27,7 @@ files:
 - lib/shapeup_cli/commands.rb
 - lib/shapeup_cli/commands/auth.rb
 - lib/shapeup_cli/commands/base.rb
+- lib/shapeup_cli/commands/checklist.rb
 - lib/shapeup_cli/commands/comments.rb
 - lib/shapeup_cli/commands/config_cmd.rb
 - lib/shapeup_cli/commands/cycle.rb
@@ -39,6 +40,7 @@ files:
 - lib/shapeup_cli/commands/scopes.rb
 - lib/shapeup_cli/commands/search.rb
 - lib/shapeup_cli/commands/setup.rb
+- lib/shapeup_cli/commands/tags.rb
 - lib/shapeup_cli/commands/tasks.rb
 - lib/shapeup_cli/config.rb
 - lib/shapeup_cli/output.rb
@@ -64,7 +66,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.6
 specification_version: 4
 summary: ShapeUp CLI — manage pitches, scopes, tasks, and cycles from the terminal
 test_files: []