shapeup-cli 0.3.2

data/lib/shapeup_cli/commands/comments.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Comments < Base
+      def self.metadata
+        {
+          command: "comments",
+          path: "shapeup comments",
+          short: "List and add comments on issues, pitches, scopes, and tasks",
+          subcommands: [
+            { name: "list", short: "List comments", path: "shapeup comments list --issue <id>" },
+            { name: "add", short: "Add a comment", path: 'shapeup comments add --issue <id> "Comment text"' }
+          ],
+          flags: [
+            { name: "issue", type: "string", usage: "Issue ID" },
+            { name: "pitch", type: "string", usage: "Pitch ID" },
+            { name: "scope", type: "string", usage: "Scope ID" },
+            { name: "task", type: "string", usage: "Task ID" }
+          ],
+          examples: [
+            "shapeup comments list --issue 42",
+            'shapeup comments add --issue 42 "Investigated — this is a CSS issue in the navbar"',
+            "shapeup comments list --pitch 10",
+            'shapeup comments add --pitch 10 "Shaped and ready for betting"'
+          ]
+        }
+      end
+
+      def execute
+        subcommand = positional_arg(0)
+
+        case subcommand
+        when "add"    then add
+        when "list", nil then list
+        else list
+        end
+      end
+
+      private
+
+        def list
+          type, id = resolve_commentable
+          result = call_tool("list_comments", commentable_type: type, commentable_id: id.to_s)
+
+          render result,
+            summary: "Comments on #{type} ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup comments add --#{type.downcase} #{id} \"Your comment\"", description: "Add a comment" }
+            ]
+        end
+
+        def add
+          type, id = resolve_commentable
+          text = positional_arg(1) || abort('Usage: shapeup comments add --issue <id> "Comment text"')
+
+          result = call_tool("create_comment", commentable_type: type, commentable_id: id.to_s, content: text)
+
+          render result,
+            summary: "Comment added to #{type} ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup comments list --#{type.downcase} #{id}", description: "View all comments" }
+            ]
+        end
+
+        def resolve_commentable
+          issue = extract_option("--issue")
+          pitch = extract_option("--pitch")
+          scope = extract_option("--scope")
+          task = extract_option("--task")
+
+          if issue
+            [ "Issue", issue ]
+          elsif pitch
+            [ "Package", pitch ]
+          elsif scope
+            [ "Scope", scope ]
+          elsif task
+            [ "Task", task ]
+          else
+            abort("Specify a target: --issue <id>, --pitch <id>, --scope <id>, or --task <id>")
+          end
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands/config_cmd.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class ConfigCmd < Base
+      def self.metadata
+        {
+          command: "config",
+          path: "shapeup config",
+          short: "Show and manage CLI configuration",
+          subcommands: [
+            { name: "show", short: "Show current config (default)", path: "shapeup config show" },
+            { name: "set", short: "Set a config value", path: "shapeup config set <key> <value>" },
+            { name: "init", short: "Create .shapeup/config.json for this directory", path: "shapeup config init <org>" }
+          ],
+          flags: [],
+          notes: [
+            "Config keys: org (organisation name or ID), host (ShapeUp URL)",
+            "Resolution order: --org flag > .shapeup/config.json > ~/.config/shapeup/config.json"
+          ],
+          examples: [
+            "shapeup config show",
+            "shapeup config set org \"Acme Corp\"",
+            "shapeup config init \"Acme Corp\""
+          ]
+        }
+      end
+
+      def execute
+        subcommand = positional_arg(0)
+
+        case subcommand
+        when "set"  then set
+        when "show" then show
+        when "init" then init_project
+        else show
+        end
+      end
+
+      private
+        def set
+          key = positional_arg(1) || abort("Usage: shapeup config set <key> <value>")
+          value = positional_arg(2) || abort("Usage: shapeup config set #{key} <value>")
+
+          case key
+          when "org"
+            resolved = resolve_org_value(value)
+            Config.save_config("organisation_id", resolved.to_s)
+            puts "Default organisation set to #{resolved}"
+          when "host"
+            Config.save_config("host", value)
+            puts "Host set to #{value}"
+          else
+            abort "Unknown config key: #{key}. Available: org, host"
+          end
+        end
+
+        def show
+          config = Config.load_config
+          profile = Config.current_profile
+
+          puts "Profile:"
+          if profile
+            puts "  active  #{profile["profile_name"]}"
+            puts "  org     #{profile["name"]} (#{profile["organisation_id"]})"
+            puts "  host    #{profile["host"]}"
+            puts "  token   #{profile["token"][0..7]}..."
+          else
+            puts "  (not logged in)"
+          end
+          puts
+
+          overrides = []
+          overrides << "org=#{config["organisation_id"]}" if config["organisation_id"]
+          overrides << "host=#{config["host"]}" if config["host"]
+          if overrides.any?
+            puts "Overrides:"
+            puts "  #{overrides.join(", ")}"
+            puts
+          end
+
+          puts "Files:"
+          puts "  profiles  #{Config::PROFILES_FILE}"
+          puts "  config    #{Config::CONFIG_FILE}"
+          puts "  project   #{Config::PROJECT_CONFIG_NAME} #{find_project_display}"
+
+          env_vars = []
+          env_vars << "SHAPEUP_TOKEN" if ENV["SHAPEUP_TOKEN"]
+          env_vars << "SHAPEUP_ORG" if ENV["SHAPEUP_ORG"]
+          env_vars << "SHAPEUP_HOST" if ENV["SHAPEUP_HOST"]
+          env_vars << "SHAPEUP_PROFILE" if ENV["SHAPEUP_PROFILE"]
+          if env_vars.any?
+            puts
+            puts "Env vars active:"
+            puts "  #{env_vars.join(", ")}"
+          end
+        end
+
+        def find_project_display
+          dir = Dir.pwd
+          loop do
+            candidate = File.join(dir, Config::PROJECT_CONFIG_NAME)
+            return "(found: #{candidate})" if File.exist?(candidate)
+            parent = File.dirname(dir)
+            break if parent == dir
+            dir = parent
+          end
+          "(not found)"
+        end
+
+        # Create .shapeup/config.json in the current directory
+        def init_project
+          org_value = positional_arg(1) || extract_option("--org") || @org_id
+          abort("Usage: shapeup config init <org>") unless org_value
+
+          resolved = resolve_org_value(org_value)
+
+          FileUtils.mkdir_p(".shapeup")
+          File.write(".shapeup/config.json", JSON.pretty_generate(organisation_id: resolved.to_s))
+          puts "Created .shapeup/config.json (org: #{resolved})"
+          puts "All commands in this directory will use this organisation by default."
+        end
+
+        def resolve_org_value(value)
+          return value if value.to_s.match?(/\A\d+\z/)
+
+          # Need to resolve name to ID
+          result = client.call_tool("list_organisations")
+          data = Output.extract_data(result)
+          orgs = data.is_a?(Hash) ? (data["organisations"] || []) : Array(data)
+
+          match = orgs.find { |o| o["name"]&.downcase == value.downcase }
+
+          if match
+            match["id"]
+          else
+            names = orgs.map { |o| "  #{o["id"]}  #{o["name"]}" }.join("\n")
+            abort "Organisation '#{value}' not found. Available:\n#{names}"
+          end
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands/cycle.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Cycle < Base
+      def self.metadata
+        {
+          command: "cycle",
+          path: "shapeup cycle",
+          short: "List and show cycles",
+          subcommands: [
+            { name: "list", short: "List cycles (default)", path: "shapeup cycles" },
+            { name: "show", short: "Show cycle details with pitches and progress", path: "shapeup cycle show <id>" }
+          ],
+          flags: [
+            { name: "status", type: "string", usage: "Filter by status: active, past, future, all" }
+          ],
+          examples: [
+            "shapeup cycles",
+            "shapeup cycles --status active",
+            "shapeup cycle show 12"
+          ]
+        }
+      end
+
+      def execute
+        subcommand = positional_arg(0)
+
+        case subcommand
+        when "show"  then show
+        when "list", nil then list
+        else
+          subcommand.match?(/\A\d+\z/) ? show(subcommand) : list
+        end
+      end
+
+      private
+        def list
+          status = extract_option("--status")
+          args = {}
+          args[:status] = status if status
+
+          result = call_tool("list_cycles", **args)
+
+          render result,
+            summary: "Cycles",
+            breadcrumbs: [
+              { cmd: "shapeup cycle show <id>", description: "View cycle details and progress" },
+              { cmd: "shapeup cycles --status active", description: "Show active cycles only" }
+            ]
+        end
+
+        def show(id = nil)
+          id ||= positional_arg(1) || abort("Usage: shapeup cycle show <id>")
+
+          result = call_tool("show_cycle", cycle: id.to_s)
+
+          render result,
+            summary: "Cycle ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup pitches list --cycle #{id}", description: "List pitches in this cycle" }
+            ]
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands/issues.rb

@@ -0,0 +1,336 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Issues < Base
+      def self.metadata
+        {
+          command: "issues",
+          path: "shapeup issues",
+          short: "Manage issues on the kanban board",
+          aliases: { "issue" => "issues show", "watching" => "issues watching" },
+          subcommands: [
+            { name: "list", short: "List active issues", path: "shapeup issues" },
+            { name: "show", short: "Show issue details", path: "shapeup issue <id>" },
+            { name: "create", short: "Create an issue", path: "shapeup issues create \"Title\" --stream <id>" },
+            { name: "update", short: "Update an issue", path: "shapeup issues update <id> --title \"New title\"" },
+            { name: "move", short: "Move to a kanban column", path: "shapeup issues move <id> --column <id>" },
+            { name: "done", short: "Mark issue as done", path: "shapeup issues done <id>" },
+            { name: "close", short: "Close issue (won't fix)", path: "shapeup issues close <id>" },
+            { name: "reopen", short: "Reopen a done/closed issue", path: "shapeup issues reopen <id>" },
+            { name: "icebox", short: "Move issue to icebox", path: "shapeup issues icebox <id>" },
+            { name: "defrost", short: "Restore issue from icebox", path: "shapeup issues defrost <id>" },
+            { name: "assign", short: "Assign a user to an issue", path: "shapeup issues assign <id> [--user <id>]" },
+            { name: "unassign", short: "Unassign a user from an issue", path: "shapeup issues unassign <id> [--user <id>]" },
+            { 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: "delete", short: "Delete an issue", path: "shapeup issues delete <id>" }
+          ],
+          flags: [
+            { name: "stream", type: "string", usage: "Stream ID (required for create, optional filter for list)" },
+            { name: "column", type: "string", usage: "Kanban column ID (for move or filter)" },
+            { name: "kind", type: "string", usage: "Filter by kind: bug, request, all" },
+            { name: "assignee", type: "string", usage: "User ID or 'me' (for list)" },
+            { name: "user", type: "string", usage: "User ID or 'me' (for assign/unassign, defaults to 'me')" },
+            { name: "tag", type: "string", usage: "Filter by tag name (for list)" },
+            { 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: "archived", type: "bool", usage: "Include iceboxed issues in list" }
+          ],
+          examples: [
+            "shapeup issues",
+            "shapeup issues --tag seo",
+            "shapeup issues --assignee me",
+            "shapeup issues --column 3",
+            "shapeup issues --all",
+            "shapeup issues --stream 3 --kind bug",
+            "shapeup issue 42",
+            "shapeup issues create \"Fix checkout\" --stream 3 --content \"The button is broken\"",
+            "shapeup issues move 42 --column 5",
+            "shapeup issues done 42",
+            "shapeup issues close 42",
+            "shapeup issues reopen 42",
+            "shapeup issues icebox 42",
+            "shapeup issues defrost 42",
+            "shapeup issues assign 42",
+            "shapeup issues assign 42 --user 7",
+            "shapeup issues unassign 42",
+            "shapeup issues watch 42",
+            "shapeup watching"
+          ]
+        }
+      end
+
+      def execute
+        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
+        else
+          # Bare numeric arg = show
+          if subcommand&.match?(/\A\d+\z/)
+            @remaining.unshift(subcommand)
+            show
+          else
+            list
+          end
+        end
+      end
+
+      private
+
+        def list
+          stream = extract_option("--stream")
+          column = extract_option("--column")
+          kind = extract_option("--kind")
+          assignee = extract_option("--assignee")
+          tag = extract_option("--tag")
+          show_all = @remaining.delete("--all")
+
+          args = {}
+          args[:stream] = stream if stream
+          args[:kanban_column] = column if column
+          args[:kind] = kind if kind
+          args[:assignee] = assignee if assignee
+          args[:tag] = tag if tag
+          args[:include_closed] = true if show_all
+          args[:include_archived] = true if @remaining.delete("--archived")
+
+          result = call_tool("list_issues", **args)
+
+          render result,
+            summary: "Issues",
+            breadcrumbs: [
+              { cmd: "shapeup issue <id>", description: "View issue details" },
+              { cmd: "shapeup issues create \"Title\" --stream <id>", description: "Create an issue" }
+            ]
+        end
+
+        def show
+          id = positional_arg(1) || positional_arg(0) || abort("Usage: shapeup issue <id>")
+          result = call_tool("show_issue", issue: id.to_s)
+
+          render result,
+            summary: "Issue ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup issues move #{id} --column <id>", description: "Move to column" },
+              { cmd: "shapeup issues icebox #{id}", description: "Move to icebox" },
+              { cmd: "shapeup issues watch #{id}", description: "Watch this issue" }
+            ]
+        end
+
+        def create
+          stream_id = extract_option("--stream") || abort("Usage: shapeup issues create \"Title\" --stream <id> [--content \"...\"] [--kind bug|request]")
+          content = extract_option("--content")
+          kind = extract_option("--kind")
+          column = extract_option("--column")
+          title = positional_arg(1) || abort("Usage: shapeup issues create \"Title\" --stream <id>")
+
+          args = { stream: stream_id.to_s, title: title, content: content || title }
+          args[:kind] = kind if kind
+          args[:kanban_column] = column if column
+
+          result = call_tool("create_issue", **args)
+
+          render result,
+            summary: "Issue created",
+            breadcrumbs: [
+              { cmd: "shapeup issues", description: "List all issues" },
+              { cmd: "shapeup issue <id>", description: "View the issue" }
+            ]
+        end
+
+        def update
+          id = positional_arg(1) || abort("Usage: shapeup issues update <id> [--title \"...\"] [--content \"...\"] [--kind bug|request]")
+          title = extract_option("--title")
+          content = extract_option("--content")
+          kind = extract_option("--kind")
+
+          args = { issue: id.to_s }
+          args[:title] = title if title
+          args[:content] = content if content
+          args[:kind] = kind if kind
+
+          result = call_tool("update_issue", **args)
+
+          render result,
+            summary: "Issue ##{id} updated",
+            breadcrumbs: [
+              { cmd: "shapeup issue #{id}", description: "View issue" }
+            ]
+        end
+
+        def move
+          id = positional_arg(1) || abort("Usage: shapeup issues move <id> --column <id>")
+          column_id = extract_option("--column") || abort("Usage: shapeup issues move <id> --column <id>")
+
+          result = call_tool("move_issue", issue: id.to_s, kanban_column: column_id.to_s)
+
+          render result,
+            summary: "Issue ##{id} moved",
+            breadcrumbs: [
+              { cmd: "shapeup issue #{id}", description: "View issue" },
+              { cmd: "shapeup issues", description: "List all issues" }
+            ]
+        end
+
+        def icebox
+          id = positional_arg(1) || abort("Usage: shapeup issues icebox <id>")
+
+          result = call_tool("archive_issue", issue: id.to_s)
+
+          render result,
+            summary: "Issue ##{id} iceboxed",
+            breadcrumbs: [
+              { cmd: "shapeup issues defrost #{id}", description: "Defrost this issue" },
+              { cmd: "shapeup issues --archived", description: "List iceboxed issues" }
+            ]
+        end
+
+        def mark_done
+          id = positional_arg(1) || abort("Usage: shapeup issues done <id>")
+
+          result = call_tool("close_issue", issue: id.to_s, resolution: "done")
+
+          render result,
+            summary: "Issue ##{id} done",
+            breadcrumbs: [
+              { cmd: "shapeup issues reopen #{id}", description: "Reopen this issue" },
+              { cmd: "shapeup issues", description: "List open issues" }
+            ]
+        end
+
+        def close
+          id = positional_arg(1) || abort("Usage: shapeup issues close <id>")
+
+          result = call_tool("close_issue", issue: id.to_s, resolution: "closed")
+
+          render result,
+            summary: "Issue ##{id} closed",
+            breadcrumbs: [
+              { cmd: "shapeup issues reopen #{id}", description: "Reopen this issue" },
+              { cmd: "shapeup issues", description: "List open issues" }
+            ]
+        end
+
+        def reopen
+          id = positional_arg(1) || abort("Usage: shapeup issues reopen <id>")
+
+          result = call_tool("reopen_issue", issue: id.to_s)
+
+          render result,
+            summary: "Issue ##{id} reopened",
+            breadcrumbs: [
+              { cmd: "shapeup issue #{id}", description: "View issue" },
+              { cmd: "shapeup issues", description: "List all issues" }
+            ]
+        end
+
+        def defrost
+          id = positional_arg(1) || abort("Usage: shapeup issues defrost <id>")
+
+          result = call_tool("unarchive_issue", issue: id.to_s)
+
+          render result,
+            summary: "Issue ##{id} defrosted",
+            breadcrumbs: [
+              { cmd: "shapeup issue #{id}", description: "View issue" },
+              { cmd: "shapeup issues", description: "List all issues" }
+            ]
+        end
+
+        def assign
+          id = positional_arg(1) || abort("Usage: shapeup issues assign <id> [--user <id>]")
+          user_id = extract_option("--user") || "me"
+
+          result = call_tool("assign_user", assignable_type: "Issue", assignable_id: id.to_s, user_id: user_id.to_s)
+
+          render result,
+            summary: "Assigned to issue ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup issues unassign #{id}", description: "Unassign from issue" },
+              { cmd: "shapeup issue #{id}", description: "View issue" }
+            ]
+        end
+
+        def unassign
+          id = positional_arg(1) || abort("Usage: shapeup issues unassign <id> [--user <id>]")
+          user_id = extract_option("--user") || "me"
+
+          result = call_tool("unassign_user", assignable_type: "Issue", assignable_id: id.to_s, user_id: user_id.to_s)
+
+          render result,
+            summary: "Unassigned from issue ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup issues assign #{id}", description: "Assign to issue" },
+              { cmd: "shapeup issue #{id}", description: "View issue" }
+            ]
+        end
+
+        def watch
+          id = positional_arg(1) || abort("Usage: shapeup issues watch <id>")
+
+          result = call_tool("watch_issue", issue: id.to_s)
+
+          render result,
+            summary: "Watching issue ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup watching", description: "List watched issues" },
+              { cmd: "shapeup issues unwatch #{id}", description: "Stop watching" }
+            ]
+        end
+
+        def unwatch
+          id = positional_arg(1) || abort("Usage: shapeup issues unwatch <id>")
+
+          result = call_tool("unwatch_issue", issue: id.to_s)
+
+          render result,
+            summary: "Unwatched issue ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup watching", description: "List watched issues" }
+            ]
+        end
+
+        def watching
+          result = call_tool("list_watched_issues")
+
+          render result,
+            summary: "Watched Issues",
+            breadcrumbs: [
+              { cmd: "shapeup issue <id>", description: "View issue details" },
+              { cmd: "shapeup issues unwatch <id>", description: "Stop watching" }
+            ]
+        end
+
+        def delete
+          id = positional_arg(1) || abort("Usage: shapeup issues delete <id>")
+
+          result = call_tool("delete_issue", issue: id.to_s)
+
+          render result,
+            summary: "Issue ##{id} deleted",
+            breadcrumbs: [
+              { cmd: "shapeup issues", description: "List remaining issues" }
+            ]
+        end
+    end
+  end
+end