shapeup-cli 0.3.2

data/lib/shapeup_cli/commands/login.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Login
+      def self.run(args)
+        host = nil
+        profile_name = nil
+        args.each_with_index do |arg, i|
+          case arg
+          when "--host" then host = args[i + 1]
+          when /\A--host=(.+)\z/ then host = $1
+          when "--profile" then profile_name = args[i + 1]
+          when /\A--profile=(.+)\z/ then profile_name = $1
+          end
+        end
+
+        host ||= Config.host
+        token_response = ShapeupCli::Auth.login(host: host)
+        token = token_response["access_token"]
+
+        # Fetch orgs to let user pick one for this profile
+        client = Client.new(host: host, token: token)
+        result = client.call_tool("list_organisations")
+        data = Output.extract_data(result)
+        orgs = data.is_a?(Hash) ? (data["organisations"] || []) : []
+
+        if orgs.empty?
+          puts "No organisations found."
+          return
+        end
+
+        # If only one org, use it automatically
+        org = if orgs.length == 1
+          orgs.first
+        else
+          puts "\nChoose an organisation for this profile:\n"
+          orgs.each_with_index do |o, i|
+            puts "  #{i + 1}) #{o["name"]}"
+          end
+          print "\nEnter number (1-#{orgs.length}): "
+          choice = $stdin.gets&.strip&.to_i
+          orgs[choice - 1] if choice&.between?(1, orgs.length)
+        end
+
+        unless org
+          puts "No organisation selected."
+          return
+        end
+
+        # Generate profile name from org name (slug it)
+        profile_name ||= org["name"].downcase.gsub(/[^a-z0-9]+/, "-").gsub(/\A-|-\z/, "")
+
+        Config.save_profile(
+          profile_name,
+          token: token,
+          host: host,
+          organisation_id: org["id"],
+          display_name: org["name"]
+        )
+
+        # Also set as default
+        Config.switch_profile(profile_name)
+
+        puts "\nProfile '#{profile_name}' created and set as default."
+        puts "  org: #{org["name"]} (#{org["id"]})"
+        puts "  host: #{host}"
+        puts "\nTo add another profile, run 'shapeup login' again."
+        puts "To switch: 'shapeup auth switch <name>'"
+      end
+    end
+  end
+end

data/lib/shapeup_cli/commands/logout.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Logout
+      def self.run(_args)
+        Config.clear_credentials
+        puts "Logged out."
+      end
+    end
+  end
+end

data/lib/shapeup_cli/commands/my_work.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class MyWork < Base
+      def self.metadata
+        {
+          command: "my-work",
+          path: "shapeup me",
+          short: "Show all pitches, scopes, and tasks assigned to you",
+          aliases: { "me" => "my-work" },
+          flags: [
+            { name: "user", type: "string", usage: "User ID to show work for (default: me)" }
+          ],
+          examples: [
+            "shapeup me",
+            "shapeup me --json",
+            "shapeup my-work --user 5"
+          ]
+        }
+      end
+
+      def execute
+        assignee = extract_option("--user") || "me"
+
+        result = call_tool("show_my_work", assignee: assignee)
+
+        render result,
+          summary: assignee == "me" ? "My Work" : "Work for #{assignee}",
+          breadcrumbs: [
+            { cmd: "shapeup pitch <id>", description: "View pitch details" },
+            { cmd: "shapeup done <id>", description: "Complete a task" },
+            { cmd: "shapeup tasks list --assignee me", description: "List just my tasks" }
+          ]
+      end
+    end
+  end
+end

data/lib/shapeup_cli/commands/orgs.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Orgs < Base
+      def self.metadata
+        {
+          command: "orgs",
+          path: "shapeup orgs",
+          short: "List organisations you have access to",
+          flags: [],
+          examples: [
+            "shapeup orgs",
+            "shapeup orgs --json"
+          ]
+        }
+      end
+
+      def execute
+        result = client.call_tool("list_organisations")
+
+        render result,
+          summary: "Organisations",
+          breadcrumbs: [
+            { cmd: "shapeup pitches list --org <id>", description: "List pitches for an org" },
+            { cmd: "shapeup cycles --org <id>", description: "List cycles for an org" }
+          ]
+      end
+
+      private
+        # Override: orgs doesn't need an org_id
+        def org_id = nil
+    end
+  end
+end

data/lib/shapeup_cli/commands/pitches.rb

@@ -0,0 +1,170 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Pitches < Base
+      def self.metadata
+        {
+          command: "pitches",
+          path: "shapeup pitches",
+          short: "List and show pitches (packages)",
+          subcommands: [
+            { name: "list", short: "List pitches (default)", path: "shapeup pitches list" },
+            { name: "show", short: "Show pitch details with scopes and tasks", path: "shapeup pitches show <id>" },
+            { name: "create", short: "Create a new pitch", path: "shapeup pitches create \"Title\" --stream \"Name\"" },
+            { name: "help", short: "Show usage", path: "shapeup pitches help" }
+          ],
+          flags: [
+            { name: "status", type: "string", usage: "Filter by status: idea, framed, shaped" },
+            { name: "cycle", type: "string", usage: "Filter by cycle ID" },
+            { 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)" },
+            { name: "cycle-id", type: "string", usage: "Assign to cycle ID (for create)" }
+          ],
+          examples: [
+            "shapeup pitches list",
+            "shapeup pitches list --status shaped",
+            "shapeup pitches list --cycle 5",
+            "shapeup pitch 42",
+            "shapeup pitch 42 --json",
+            "shapeup pitches create \"Redesign Search\" --stream \"Platform\"",
+            "shapeup pitches create \"Auth Overhaul\" --stream \"Platform\" --appetite small_batch"
+          ]
+        }
+      end
+
+      def execute
+        subcommand = positional_arg(0)
+
+        case subcommand
+        when "show"      then show
+        when "create"    then create
+        when "list", nil then list
+        when "help"      then help
+        else
+          subcommand.match?(/\A\d+\z/) ? show(subcommand) : list
+        end
+      end
+
+      private
+        def list
+          cycle_id = extract_option("--cycle")
+          status = extract_option("--status")
+          limit = extract_option("--limit")&.to_i
+          args = {}
+          args[:cycle] = cycle_id if cycle_id
+
+          result = call_tool("list_packages", **args)
+          data = Output.extract_data(result)
+          packages = data.is_a?(Hash) ? (data["packages"] || []) : Array(data)
+
+          # Client-side filtering
+          packages = packages.select { |p| p["status"] == status } if status
+          packages = packages.first(limit) if limit
+
+          summary = "Pitches"
+          summary += " (#{status})" if status
+          summary += " in cycle #{cycle_id}" if cycle_id
+          summary += " — #{packages.length} results"
+
+          render_list(packages, summary)
+        end
+
+        def show(id = nil)
+          id ||= positional_arg(1) || abort("Usage: shapeup pitches show <id>")
+
+          result = call_tool("show_package", package: id.to_s)
+
+          render result,
+            summary: "Pitch ##{id}",
+            breadcrumbs: [
+              { cmd: "shapeup scopes list --pitch #{id}", description: "List scopes" },
+              { cmd: "shapeup scopes create --pitch #{id} \"Title\"", description: "Add a scope" },
+              { cmd: "shapeup todo \"Task\" --pitch #{id}", description: "Add a task" },
+              { cmd: "shapeup tasks list --pitch #{id}", description: "List all tasks" }
+            ]
+        end
+
+        def render_list(packages, summary)
+          # Build a simplified list for display
+          items = packages.map do |p|
+            {
+              "id" => p["id"],
+              "title" => p["title"],
+              "status" => p["status"],
+              "appetite" => p["appetite"],
+              "cycle" => p["cycle"]
+            }
+          end
+
+          Output.render(
+            { "content" => [ { "type" => "text", "text" => JSON.generate(items) } ] },
+            breadcrumbs: [
+              { cmd: "shapeup pitch <id>", description: "View pitch details" },
+              { cmd: "shapeup pitches list --status shaped", description: "Show shaped pitches" },
+              { cmd: "shapeup pitches list --cycle <id>", description: "Filter by cycle" },
+              { cmd: "shapeup pitches help", description: "Show usage" }
+            ],
+            mode: @mode,
+            summary: summary
+          )
+        end
+
+        def create
+          title = positional_arg(1) || abort("Usage: shapeup pitches create \"Title\" --stream \"Name\"")
+          stream = extract_option("--stream") || abort("Usage: shapeup pitches create \"Title\" --stream \"Name\"")
+          appetite = extract_option("--appetite")
+          cycle_id = extract_option("--cycle-id")
+
+          args = { title: title, stream: stream }
+          args[:appetite] = appetite if appetite
+          args[:cycle] = cycle_id if cycle_id
+
+          result = call_tool("create_package", **args)
+
+          render result,
+            summary: "Pitch created",
+            breadcrumbs: [
+              { cmd: "shapeup scopes create --pitch <id> \"Title\"", description: "Add a scope" },
+              { cmd: "shapeup todo \"Task\" --pitch <id>", description: "Add a task" },
+              { cmd: "shapeup pitch <id>", description: "View pitch details" }
+            ]
+        end
+
+        def help
+          puts <<~HELP
+            Usage: shapeup pitches <subcommand> [options]
+
+            Subcommands:
+              list              List pitches (default)
+              show <id>         Show pitch details
+              create "Title"    Create a new pitch
+              help              This help
+
+            Filters (list):
+              --status <s>      Filter by status: idea, framed, shaped
+              --cycle <id>      Filter by cycle
+              --limit <n>       Limit results
+
+            Options (create):
+              --stream <name>   Stream name or ID (required)
+              --appetite <a>    unknown, small_batch, big_batch (default: big_batch)
+              --cycle-id <id>   Assign to a cycle
+
+            Output:
+              --json            JSON envelope with breadcrumbs
+              --md              Markdown table
+              --agent           Raw data only
+
+            Examples:
+              shapeup pitches list
+              shapeup pitches list --status shaped
+              shapeup pitch 42
+              shapeup pitches create "Redesign Search" --stream "Platform"
+              shapeup pitches create "Auth Overhaul" --stream "Platform" --appetite small_batch
+          HELP
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands/scopes.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Scopes < Base
+      def self.metadata
+        {
+          command: "scopes",
+          path: "shapeup scopes",
+          short: "Manage scopes within a pitch",
+          subcommands: [
+            { name: "list", short: "List scopes for a pitch", path: "shapeup scopes list --pitch <id>" },
+            { name: "create", short: "Create a new scope", path: "shapeup scopes create --pitch <id> \"Title\"" },
+            { name: "update", short: "Update scope title or color", path: "shapeup scopes update <id> --title \"New\"" },
+            { name: "position", short: "Update hill chart position (0-100)", path: "shapeup scopes position <id> <position>" }
+          ],
+          flags: [
+            { name: "pitch", type: "string", usage: "Pitch ID (required for list and create)" },
+            { name: "title", type: "string", usage: "Scope title (for create/update)" },
+            { name: "color", type: "string", usage: "Hex color code (for update)" }
+          ],
+          examples: [
+            "shapeup scopes list --pitch 42",
+            "shapeup scopes create --pitch 42 \"User onboarding\"",
+            "shapeup scopes update 7 --title \"Revised onboarding\"",
+            "shapeup scopes position 7 50"
+          ]
+        }
+      end
+
+      def execute
+        subcommand = positional_arg(0)
+
+        case subcommand
+        when "create"   then create
+        when "update"   then update
+        when "position" then position
+        when "list", nil then list
+        else list
+        end
+      end
+
+      private
+        def list
+          pitch_id = extract_option("--pitch") || abort("Usage: shapeup scopes list --pitch <id>")
+
+          result = call_tool("show_package", package: pitch_id.to_s)
+
+          render result,
+            summary: "Scopes for Pitch ##{pitch_id}",
+            breadcrumbs: [
+              { cmd: "shapeup scopes create --pitch #{pitch_id} \"Title\"", description: "Add a scope" },
+              { cmd: "shapeup tasks list --pitch #{pitch_id}", description: "List all tasks" }
+            ]
+        end
+
+        def create
+          pitch_id = extract_option("--pitch") || abort("Usage: shapeup scopes create --pitch <id> \"Title\"")
+          title = positional_arg(1) || abort("Usage: shapeup scopes create --pitch <id> \"Title\"")
+
+          result = call_tool("create_scope", package: pitch_id.to_s, title: title)
+
+          render result,
+            summary: "Scope created",
+            breadcrumbs: [
+              { cmd: "shapeup tasks list --scope <id>", description: "List tasks in this scope" },
+              { cmd: "shapeup todo \"Task\" --pitch #{pitch_id} --scope <id>", description: "Add a task" }
+            ]
+        end
+
+        def position
+          scope_id = positional_arg(1) || abort("Usage: shapeup scopes position <id> <position>")
+          pos = positional_arg(2) || abort("Usage: shapeup scopes position <id> <position>")
+
+          result = call_tool("update_scope_position", scope: scope_id.to_s, position: pos.to_f)
+
+          render result,
+            summary: "Scope ##{scope_id} moved to position #{pos}",
+            breadcrumbs: [
+              { cmd: "shapeup scopes list --pitch <id>", description: "List scopes" }
+            ]
+        end
+
+        def update
+          scope_id = positional_arg(1) || abort("Usage: shapeup scopes update <id> [--title \"New\"] [--color #hex]")
+          args = { scope: scope_id.to_s }
+          args[:title] = extract_option("--title") if @remaining.include?("--title")
+          args[:color] = extract_option("--color") if @remaining.include?("--color")
+
+          result = call_tool("update_scope", **args)
+
+          render result, summary: "Scope ##{scope_id} updated"
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands/search.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Search < Base
+      def self.metadata
+        {
+          command: "search",
+          path: "shapeup search",
+          short: "Search across pitches, scopes, tasks, tickets, and users",
+          flags: [],
+          examples: [
+            "shapeup search \"onboarding\"",
+            "shapeup search \"login bug\" --json"
+          ]
+        }
+      end
+
+      def execute
+        query = positional_arg(0) || abort("Usage: shapeup search \"query\"")
+
+        result = call_tool("search", query: query)
+
+        render result,
+          summary: "Search: #{query}",
+          breadcrumbs: [
+            { cmd: "shapeup pitch <id>", description: "View a pitch" },
+            { cmd: "shapeup cycle show <id>", description: "View a cycle" }
+          ]
+      end
+    end
+  end
+end

data/lib/shapeup_cli/commands/setup.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Setup < Base
+      SKILL_SOURCE = File.expand_path("../../../skills/shapeup/SKILL.md", __dir__)
+
+      def self.metadata
+        {
+          command: "setup",
+          path: "shapeup setup",
+          short: "Install ShapeUp skills into an AI agent",
+          subcommands: [
+            { name: "claude", short: "Install skill into Claude Code (~/.claude/skills/)", path: "shapeup setup claude" },
+            { name: "cursor", short: "Install skill into Cursor (.cursor/skills/)", path: "shapeup setup cursor" },
+            { name: "project", short: "Install skill into current project (.claude/skills/)", path: "shapeup setup project" }
+          ],
+          flags: [],
+          examples: [
+            "shapeup setup claude",
+            "shapeup setup project",
+            "shapeup setup cursor"
+          ]
+        }
+      end
+
+      def execute
+        target = positional_arg(0)
+
+        case target
+        when "claude"  then install_global("claude")
+        when "cursor"  then install_global("cursor")
+        when "project" then install_project
+        else
+          puts <<~HELP
+            Usage: shapeup setup <target>
+
+            Targets:
+              claude    Install skill globally into ~/.claude/skills/
+              cursor    Install skill globally into ~/.cursor/skills/
+              project   Install skill into .claude/skills/ (current directory)
+
+            This copies the ShapeUp SKILL.md so your AI agent knows how to
+            use the ShapeUp CLI when triggered by relevant phrases.
+          HELP
+        end
+      end
+
+      private
+        def install_global(agent)
+          dir = File.join(Dir.home, ".#{agent}", "skills", "shapeup")
+          install_skill(dir, "~/.#{agent}/skills/shapeup/")
+        end
+
+        def install_project
+          dir = File.join(".claude", "skills", "shapeup")
+          install_skill(dir, ".claude/skills/shapeup/")
+        end
+
+        def install_skill(dir, display_path)
+          unless File.exist?(SKILL_SOURCE)
+            abort "SKILL.md not found at #{SKILL_SOURCE}. Is the CLI installed correctly?"
+          end
+
+          FileUtils.mkdir_p(dir)
+          dest = File.join(dir, "SKILL.md")
+
+          if File.exist?(dest)
+            puts "Updating #{display_path}SKILL.md"
+          else
+            puts "Installing #{display_path}SKILL.md"
+          end
+
+          FileUtils.cp(SKILL_SOURCE, dest)
+
+          puts "Done! Restart your agent session to pick up the skill."
+          puts
+          puts "The skill triggers on phrases like:"
+          puts "  'my tasks', 'list pitches', 'cycle progress', 'shapeup', etc."
+          puts
+          puts "Your agent will use the ShapeUp CLI to handle these requests."
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands/tasks.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Tasks < Base
+      def self.metadata
+        {
+          command: "tasks",
+          path: "shapeup tasks",
+          short: "Manage tasks within scopes and pitches",
+          aliases: { "todo" => "tasks create", "done" => "tasks complete" },
+          subcommands: [
+            { name: "list", short: "List tasks", path: "shapeup tasks list" },
+            { name: "create", short: "Create a task", path: "shapeup todo \"Description\" --pitch <id>" },
+            { name: "complete", short: "Mark task(s) as complete", path: "shapeup done <id> [<id>...]" }
+          ],
+          flags: [
+            { name: "pitch", type: "string", usage: "Pitch ID (required for create)" },
+            { name: "scope", type: "string", usage: "Scope ID (optional filter or target)" },
+            { name: "assignee", type: "string", usage: "User ID or 'me' (for list)" }
+          ],
+          examples: [
+            "shapeup tasks list --pitch 42",
+            "shapeup tasks list --assignee me",
+            "shapeup todo \"Fix login bug\" --pitch 42 --scope 7",
+            "shapeup done 123",
+            "shapeup done 123 124 125"
+          ]
+        }
+      end
+
+      def execute
+        subcommand = positional_arg(0)
+
+        case subcommand
+        when "create"   then create
+        when "complete" then complete
+        when "list", nil then list
+        else list
+        end
+      end
+
+      private
+        def list
+          scope_id = extract_option("--scope")
+          pitch_id = extract_option("--pitch")
+          assignee = extract_option("--assignee")
+
+          args = {}
+          args[:scope] = scope_id if scope_id
+          args[:package] = pitch_id if pitch_id
+          args[:assignee] = assignee if assignee
+
+          result = call_tool("list_tasks", **args)
+
+          render result,
+            summary: "Tasks",
+            breadcrumbs: [
+              { cmd: "shapeup todo \"Description\" --pitch <id>", description: "Create a task" },
+              { cmd: "shapeup done <id>", description: "Complete a task" }
+            ]
+        end
+
+        def create
+          pitch_id = extract_option("--pitch") || abort("Usage: shapeup todo \"Description\" --pitch <id> [--scope <id>]")
+          scope_id = extract_option("--scope")
+          description = positional_arg(1) || abort("Usage: shapeup todo \"Description\" --pitch <id>")
+
+          args = { package: pitch_id.to_s, description: description }
+          args[:scope] = scope_id if scope_id
+
+          result = call_tool("create_task", **args)
+
+          render result,
+            summary: "Task created",
+            breadcrumbs: [
+              { cmd: "shapeup done <id>", description: "Mark as complete" },
+              { cmd: "shapeup tasks list --pitch #{pitch_id}", description: "List all tasks" }
+            ]
+        end
+
+        def complete
+          ids = positional_args.drop(1) # drop "complete" subcommand
+          ids = positional_args if ids.empty? # handle shortcut: shapeup done <id>
+
+          abort("Usage: shapeup done <id> [<id>...]") if ids.empty?
+
+          ids.each do |id|
+            result = call_tool("complete_task", task: id.to_s)
+
+            render result,
+              summary: "Task ##{id} completed",
+              breadcrumbs: [
+                { cmd: "shapeup me", description: "Show remaining work" }
+              ]
+          end
+        end
+    end
+  end
+end