shapeup-cli 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3f4bd862f49cc66a46223d4c0f5749a92150d3b2a9fa3a6164933a6bf3970f7
-  data.tar.gz: 2a018829f56a8cbd42679fef24e16a7e8645c22ddeb7b4be2ca6b7b6c3c88211
+  metadata.gz: b3d008bb8caee611f3a41ac593cef3deed395c5057701a8e7a32b57aba6f58c6
+  data.tar.gz: ff36d3e5ccff60c016c9e48d055ef4e47821214da3d190c3b3a0cb082fc61f3c
 SHA512:
-  metadata.gz: 5857b6c507783ce2dadaaf2fbd6c4df72defe1ea46c09e93e91cec3f9bb74b2e1bfc5dcd4d1a10eddd4b92eece7cb1b6f597e0bd0599841d1947e1682494589b
-  data.tar.gz: d1bfc879a720dd2a486e5a754cecbdb958a8a2bdefe930b9d1a86d34841c625d201ffdf8e151005423cd9813b9533d54db953fbaf59f5877a8874040e6543582
+  metadata.gz: 6adc9b1b1748d3bdfd398ec4a2e617d1d530d1c18f52ba91db6fe7e2d2db51219c7730e3642023b73139861508e66ac6009d18461a767f5835ca4f89d33282fc
+  data.tar.gz: afbee4b1da2544c0846ccafc864fb42db1a67ce1d50ff99509a420a5b02517253b895d7f1f8e5a175f60102d464c8e04ac9cd7908adfd1baa882618b12b7db7d

data/lib/shapeup_cli/client.rb

@@ -7,6 +7,7 @@ module ShapeupCli
     class NotFoundError < ApiError; end
     class PermissionError < ApiError; end
     class RateLimitError < ApiError; end
+    class NetworkError < ApiError; end
 
     MCP_PROTOCOL_VERSION = "2025-06-18"
 
@@ -66,9 +67,9 @@ module ShapeupCli
       def with_network_error_handling
         yield
       rescue Net::OpenTimeout, Net::ReadTimeout
-        raise ApiError, "The server took too long to respond. Please try again."
+        raise NetworkError, "The server took too long to respond."
       rescue SocketError, Errno::ECONNREFUSED, Errno::EHOSTUNREACH, Errno::ETIMEDOUT => e
-        raise ApiError, "Couldn't reach #{@host} (#{e.class}). Check your connection and 'shapeup config show'."
+        raise NetworkError, "Couldn't reach #{@host} (#{e.class})."
       end
 
       def handle_response(response)

data/lib/shapeup_cli/commands/config_cmd.rb

@@ -10,6 +10,7 @@ module ShapeupCli
           short: "Show and manage CLI configuration",
           subcommands: [
             { name: "show", short: "Show current config (default)", path: "shapeup config show" },
+            { name: "explain", short: "Trace where each setting's value comes from", path: "shapeup config explain" },
             { 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>" }
           ],
@@ -30,9 +31,10 @@ module ShapeupCli
         subcommand = positional_arg(0)
 
         case subcommand
-        when "set"  then set
-        when "show" then show
-        when "init" then init_project
+        when "set"     then set
+        when "show"    then show
+        when "explain" then explain
+        when "init"    then init_project
         else show
         end
       end
@@ -96,6 +98,81 @@ module ShapeupCli
           end
         end
 
+        # Trace every setting through its full precedence chain, showing each
+        # candidate and which one won. Token values are never printed.
+        def explain
+          settings = {
+            "profile" => profile_candidates,
+            "org" => org_candidates,
+            "host" => host_candidates,
+            "token" => token_candidates
+          }
+
+          if @mode == :styled || @mode == :markdown
+            settings.each { |name, candidates| print_setting(name, candidates) }
+          else
+            data = settings.transform_values do |candidates|
+              selected = candidates.find { |c| c[:selected] }
+              { value: selected&.dig(:value), source: selected&.dig(:source), candidates: candidates }
+            end
+            render data
+          end
+        end
+
+        def profile_candidates
+          select_first [
+            { source: "SHAPEUP_PROFILE env", value: ENV["SHAPEUP_PROFILE"] },
+            { source: "profiles.json default", value: Config.saved_default_profile }
+          ]
+        end
+
+        def org_candidates
+          select_first [
+            { source: "--org flag", value: @org_id },
+            { source: "SHAPEUP_ORG env", value: ENV["SHAPEUP_ORG"] },
+            { source: project_config_source, value: Config.project_config["organisation_id"] },
+            { source: "~/.config/shapeup/config.json", value: Config.global_config["organisation_id"] },
+            { source: "profile '#{Config.current_profile_name}'", value: Config.current_profile&.dig("organisation_id") }
+          ]
+        end
+
+        def host_candidates
+          select_first [
+            { source: "SHAPEUP_HOST env", value: ENV["SHAPEUP_HOST"] },
+            { source: project_config_source, value: Config.project_config["host"] },
+            { source: "~/.config/shapeup/config.json", value: Config.global_config["host"] },
+            { source: "profile '#{Config.current_profile_name}'", value: Config.current_profile&.dig("host") },
+            { source: "built-in default", value: ShapeupCli::DEFAULT_HOST }
+          ]
+        end
+
+        def token_candidates
+          select_first [
+            { source: "SHAPEUP_TOKEN env", value: ENV["SHAPEUP_TOKEN"] && "configured in environment" },
+            { source: "profile '#{Config.current_profile_name}'", value: Config.current_profile&.dig("token") && "configured in profile" }
+          ]
+        end
+
+        def project_config_source
+          Config.project_config_path || Config::PROJECT_CONFIG_NAME
+        end
+
+        def select_first(candidates)
+          winner = candidates.find { |c| !c[:value].nil? && c[:value] != "" }
+          candidates.each { |c| c[:selected] = c.equal?(winner) }
+        end
+
+        def print_setting(name, candidates)
+          puts name
+          width = candidates.map { |c| c[:source].length }.max
+          candidates.each do |c|
+            marker = c[:selected] ? "  <- selected" : ""
+            value = c[:value].nil? ? "(unset)" : c[:value]
+            puts "  #{c[:source].ljust(width)}  #{value}#{marker}"
+          end
+          puts
+        end
+
         def find_project_display
           dir = Dir.pwd
           loop do

data/lib/shapeup_cli/commands/doctor.rb

@@ -0,0 +1,196 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  module Commands
+    class Doctor < Base
+      Check = Struct.new(:name, :status, :message, :hint, keyword_init: true)
+
+      def self.metadata
+        {
+          command: "doctor",
+          path: "shapeup doctor",
+          short: "Diagnose CLI setup: config, auth, connectivity, and agent skills",
+          subcommands: [],
+          flags: [],
+          notes: [
+            "Each check reports pass, warn, fail, or skip with a fix hint",
+            "Exits 0 when nothing failed, 1 otherwise"
+          ],
+          examples: [ "shapeup doctor", "shapeup doctor --json" ]
+        }
+      end
+
+      def execute
+        checks = [
+          check_cli_version,
+          check_ruby_version,
+          check_config_dir,
+          check_profiles_file,
+          check_config_file,
+          check_project_config,
+          check_token,
+          check_host_url,
+          check_api_reachable,
+          check_auth,
+          check_org_access,
+          check_claude_skill
+        ]
+
+        report(checks)
+        exit 1 if checks.any? { |c| c.status == :fail }
+      end
+
+      private
+        def check_cli_version
+          pass "cli", "shapeup #{VERSION}"
+        end
+
+        def check_ruby_version
+          pass "ruby", RUBY_VERSION
+        end
+
+        def check_config_dir
+          if File.directory?(Config::CONFIG_DIR)
+            File.writable?(Config::CONFIG_DIR) ?
+              pass("config dir", Config::CONFIG_DIR) :
+              fail!("config dir", "#{Config::CONFIG_DIR} is not writable")
+          else
+            warn! "config dir", "#{Config::CONFIG_DIR} does not exist yet", hint: "shapeup login"
+          end
+        end
+
+        def check_profiles_file
+          return warn!("profiles", "no profiles saved", hint: "shapeup login") unless File.exist?(Config::PROFILES_FILE)
+
+          data = JSON.parse(File.read(Config::PROFILES_FILE))
+          names = (data["profiles"] || {}).keys
+          pass "profiles", "#{names.length} saved (default: #{data["default"] || "none"})"
+        rescue JSON::ParserError
+          fail! "profiles", "#{Config::PROFILES_FILE} is not valid JSON", hint: "shapeup logout"
+        end
+
+        def check_config_file
+          return pass("global config", "(none)") unless File.exist?(Config::CONFIG_FILE)
+
+          JSON.parse(File.read(Config::CONFIG_FILE))
+          pass "global config", Config::CONFIG_FILE
+        rescue JSON::ParserError
+          fail! "global config", "#{Config::CONFIG_FILE} is not valid JSON"
+        end
+
+        def check_project_config
+          path = Config.project_config_path
+          return skip("project config", "none found") unless path
+
+          JSON.parse(File.read(path))
+          pass "project config", path
+        rescue JSON::ParserError
+          fail! "project config", "#{path} is not valid JSON"
+        end
+
+        def check_token
+          if ENV["SHAPEUP_TOKEN"]
+            pass "token", "from SHAPEUP_TOKEN"
+          elsif Config.current_profile&.dig("token")
+            pass "token", "from profile '#{Config.current_profile_name}'"
+          else
+            fail! "token", "no credentials found", hint: "shapeup login"
+          end
+        end
+
+        def check_host_url
+          uri = URI.parse(Config.host)
+          if uri.is_a?(URI::HTTP) && uri.host
+            pass "host", Config.host
+          else
+            fail! "host", "#{Config.host.inspect} is not a valid URL", hint: "shapeup config set host <url>"
+          end
+        rescue URI::InvalidURIError
+          fail! "host", "#{Config.host.inspect} is not a valid URL", hint: "shapeup config set host <url>"
+        end
+
+        def check_api_reachable
+          uri = URI.parse("#{Config.host}/up")
+          http = Net::HTTP.new(uri.host, uri.port)
+          http.use_ssl = uri.scheme == "https"
+          http.open_timeout = 5
+          http.read_timeout = 5
+          response = http.get(uri.path)
+
+          response.code.to_i < 500 ?
+            pass("server", "#{Config.host} reachable") :
+            fail!("server", "#{Config.host} responded with HTTP #{response.code}")
+        rescue StandardError => e
+          fail! "server", "couldn't reach #{Config.host} (#{e.class})", hint: "shapeup config explain"
+        end
+
+        def check_auth
+          return skip("auth", "no token to test") unless Config.token
+
+          result = Output.extract_data(Client.new.call_tool("list_organisations"))
+          @organisations = result.is_a?(Hash) ? (result["organisations"] || []) : Array(result)
+          pass "auth", "signed in, #{@organisations.length} organisation(s)"
+        rescue Client::AuthError
+          fail! "auth", "token was rejected", hint: "shapeup login"
+        rescue Client::ApiError => e
+          fail! "auth", e.message
+        end
+
+        def check_org_access
+          return skip("org", "auth not verified") unless @organisations
+
+          org = Config.organisation_id
+          return warn!("org", "no default organisation set", hint: "shapeup config set org <name>") unless org
+
+          if @organisations.any? { |o| o["id"].to_s == org.to_s }
+            pass "org", "##{org} accessible"
+          else
+            fail! "org", "##{org} is not among your organisations", hint: "shapeup orgs"
+          end
+        end
+
+        def check_claude_skill
+          installed = File.join(Dir.home, ".claude", "skills", "shapeup", "SKILL.md")
+          return warn!("claude skill", "not installed", hint: "shapeup setup claude") unless File.exist?(installed)
+
+          if File.read(installed) == File.read(Setup::SKILL_SOURCE)
+            pass "claude skill", "installed and current"
+          else
+            warn! "claude skill", "installed but stale", hint: "shapeup setup claude"
+          end
+        end
+
+        def pass(name, message) = Check.new(name: name, status: :pass, message: message)
+        def warn!(name, message, hint: nil) = Check.new(name: name, status: :warn, message: message, hint: hint)
+        def fail!(name, message, hint: nil) = Check.new(name: name, status: :fail, message: message, hint: hint)
+        def skip(name, message) = Check.new(name: name, status: :skip, message: message)
+
+        STATUS_MARKS = { pass: "ok", warn: "!!", fail: "XX", skip: "--" }.freeze
+
+        def report(checks)
+          counts = checks.group_by(&:status).transform_values(&:length)
+          summary = "#{counts.fetch(:pass, 0)} passed, #{counts.fetch(:warn, 0)} warnings, #{counts.fetch(:fail, 0)} failed, #{counts.fetch(:skip, 0)} skipped"
+          breadcrumbs = checks.select { |c| c.hint }.map { |c| { cmd: c.hint, description: "fix: #{c.name}" } }
+
+          if @mode == :styled
+            width = checks.map { |c| c.name.length }.max
+            checks.each do |c|
+              line = "  #{STATUS_MARKS[c.status]}  #{c.name.ljust(width)}  #{c.message}"
+              line += "  (#{c.hint})" if c.hint
+              puts line
+            end
+            puts
+            puts summary
+            if breadcrumbs.any?
+              puts
+              puts "Next:"
+              breadcrumbs.each { |b| puts "  #{b[:cmd]}  # #{b[:description]}" }
+            end
+          else
+            render({ "checks" => checks.map { |c| c.to_h.compact }, "summary" => counts },
+              breadcrumbs: breadcrumbs, summary: summary)
+          end
+        end
+    end
+  end
+end

data/lib/shapeup_cli/commands.rb

@@ -113,10 +113,14 @@ module ShapeupCli
 
         Config:
           config show               Show current config
+          config explain            Trace where each setting's value comes from
           config set org "Name"     Set default organisation (name or ID)
           config set host <url>     Set ShapeUp host
           config init "Name"        Create .shapeup/config.json for this directory
 
+        Doctor:
+          doctor                    Diagnose setup: config, auth, connectivity, skills
+
         Setup:
           setup claude              Install skill into Claude Code
           setup cursor              Install skill into Cursor
@@ -176,7 +180,8 @@ module ShapeupCli
         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)
+        config         Show/set config (set, show, explain, init)
+        doctor         Diagnose setup (config, auth, connectivity, skills)
         setup          Install agent skills (claude, cursor, project)
         commands       This list
         help           Usage guide
@@ -200,6 +205,7 @@ require_relative "commands/my_work"
 require_relative "commands/search"
 require_relative "commands/auth"
 require_relative "commands/config_cmd"
+require_relative "commands/doctor"
 require_relative "commands/setup"
 require_relative "commands/comments"
 require_relative "commands/checklist"

data/lib/shapeup_cli/config.rb

@@ -113,6 +113,26 @@ module ShapeupCli
       ENV["SHAPEUP_TOKEN"] || current_profile&.dig("token")
     end
 
+    # --- Introspection (for `config explain` and `doctor`) ---
+
+    def self.saved_default_profile
+      load_profiles_raw["default"]
+    end
+
+    def self.global_config
+      load_config_raw
+    end
+
+    def self.project_config_path
+      find_project_config
+    end
+
+    def self.project_config
+      path = find_project_config
+      return {} unless path
+      JSON.parse(File.read(path)) rescue {}
+    end
+
     # --- Pipe detection ---
 
     def self.piped?

data/lib/shapeup_cli/surface.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module ShapeupCli
+  # Serializes the entire CLI surface — commands, subcommands, flags — into
+  # sorted lines, snapshotted in SURFACE.txt and gated by surface_test.rb so
+  # no command or flag appears or disappears without a reviewed diff.
+  module Surface
+    TOP_LEVEL_COMMANDS = %w[ login logout commands help version ].freeze
+
+    def self.lines
+      lines = []
+
+      TOP_LEVEL_COMMANDS.each { |name| lines << "CMD shapeup #{name}" }
+
+      ShapeupCli.top_level_metadata[:shortcuts].each_key do |shortcut|
+        lines << "CMD shapeup #{shortcut.split.first}"
+      end
+
+      ShapeupCli.top_level_metadata[:inherited_flags].each do |flag|
+        lines << "FLAG shapeup --#{flag[:name]} #{flag[:type]}"
+      end
+
+      ShapeupCli::COMMAND_MAP.each do |name, klass|
+        lines << "CMD shapeup #{name}"
+        metadata = klass.metadata
+        (metadata[:subcommands] || []).each do |sub|
+          lines << "SUB shapeup #{name} #{sub[:name]}"
+        end
+        (metadata[:flags] || []).each do |flag|
+          lines << "FLAG shapeup #{name} --#{flag[:name]} #{flag[:type]}"
+        end
+      end
+
+      lines.uniq.sort
+    end
+
+    def self.render
+      lines.join("\n") + "\n"
+    end
+  end
+end

data/lib/shapeup_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ShapeupCli
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

data/lib/shapeup_cli.rb

@@ -19,14 +19,17 @@ require_relative "shapeup_cli/commands"
 module ShapeupCli
   DEFAULT_HOST = "https://shapeup.cc"
 
-  # Exit codes
+  # Exit codes, matching the rubric shared by the Basecamp-family CLIs so
+  # agents that know one CLI can read all of them.
   EXIT_OK          = 0
   EXIT_USAGE       = 1
   EXIT_NOT_FOUND   = 2
-  EXIT_AUTH         = 3
+  EXIT_AUTH        = 3
   EXIT_PERMISSION  = 4
-  EXIT_API_ERROR   = 5
-  EXIT_RATE_LIMIT  = 6
+  EXIT_RATE_LIMIT  = 5
+  EXIT_NETWORK     = 6
+  EXIT_API_ERROR   = 7
+  EXIT_AMBIGUOUS   = 8
   EXIT_INTERRUPTED = 130
 
   COMMAND_MAP = {
@@ -41,6 +44,7 @@ module ShapeupCli
     "search"    => Commands::Search,
     "auth"      => Commands::Auth,
     "config"    => Commands::ConfigCmd,
+    "doctor"    => Commands::Doctor,
     "setup"     => Commands::Setup,
     "comments"  => Commands::Comments,
     "checklist" => Commands::Checklist,
@@ -49,6 +53,7 @@ module ShapeupCli
 
   def self.run(argv)
     args = argv.dup
+    @machine_output = args.intersect?(%w[ --json --agent --quiet -q ]) || !$stdout.tty?
 
     # Top-level: shapeup --agent --help
     if args.include?("--agent") && args.include?("--help")
@@ -87,6 +92,7 @@ module ShapeupCli
     when "my-work", "me"  then Commands::MyWork.run(args)
     when "search"         then Commands::Search.run(args)
     when "config"         then Commands::ConfigCmd.run(args)
+    when "doctor"         then Commands::Doctor.run(args)
     when "setup"          then Commands::Setup.run(args)
     when "commands"       then Commands.list_commands
     when "version", "-v", "--version"
@@ -96,28 +102,43 @@ module ShapeupCli
     else
       $stderr.puts "Unknown command: #{command}"
       $stderr.puts "Run 'shapeup help' for usage"
-      exit 1
+      exit EXIT_USAGE
     end
-  rescue Client::AuthError => e
-    $stderr.puts "Not authenticated. Run 'shapeup login' first."
-    exit EXIT_AUTH
+  rescue Client::AuthError
+    fail_with "Not authenticated.", code: "auth_required", exit_code: EXIT_AUTH,
+      retryable: false, hint: "Run 'shapeup login' or set SHAPEUP_TOKEN"
   rescue Client::NotFoundError => e
-    $stderr.puts "Not found: #{e.message}"
-    exit EXIT_NOT_FOUND
+    fail_with "Not found: #{e.message}", code: "not_found", exit_code: EXIT_NOT_FOUND, retryable: false
   rescue Client::PermissionError => e
-    $stderr.puts "Access denied: #{e.message}"
-    exit EXIT_PERMISSION
-  rescue Client::RateLimitError => e
-    $stderr.puts "Rate limited — please wait and try again."
-    exit EXIT_RATE_LIMIT
+    fail_with "Access denied: #{e.message}", code: "forbidden", exit_code: EXIT_PERMISSION, retryable: false
+  rescue Client::RateLimitError
+    fail_with "Rate limited.", code: "rate_limit", exit_code: EXIT_RATE_LIMIT,
+      retryable: true, hint: "Wait a moment and retry"
+  rescue Client::NetworkError => e
+    fail_with e.message, code: "network", exit_code: EXIT_NETWORK,
+      retryable: true, hint: "Check your connection and 'shapeup config show'"
   rescue Client::ApiError => e
-    $stderr.puts "Error: #{e.message}"
-    exit EXIT_API_ERROR
+    fail_with "Error: #{e.message}", code: "api_error", exit_code: EXIT_API_ERROR, retryable: false
   rescue Interrupt
     $stderr.puts "\nAborted."
     exit EXIT_INTERRUPTED
   end
 
+  # Errors reach machine consumers as a JSON envelope on stdout with a
+  # `retryable` verdict, and humans as plain text on stderr. `retryable: false`
+  # means "no known reason a retry helps", not proof of permanence.
+  def self.fail_with(message, code:, exit_code:, retryable:, hint: nil)
+    if @machine_output
+      envelope = { ok: false, error: message, code: code, retryable: retryable }
+      envelope[:hint] = hint if hint
+      puts JSON.generate(envelope)
+    else
+      $stderr.puts message
+      $stderr.puts hint if hint
+    end
+    exit exit_code
+  end
+
   def self.top_level_metadata
     {
       command: "shapeup",

data/skills/shapeup/SKILL.md

@@ -77,7 +77,7 @@ Manage pitches, scopes, tasks, issues, and cycles via the ShapeUp CLI. Columns a
 4. **Follow breadcrumbs** — JSON responses include a `breadcrumbs` array with suggested next commands. Use these to chain workflows.
 5. **"Pitch" = "Package" in code** — users say "pitch", the API uses "package". The CLI uses "pitch" everywhere.
 6. **Use 'me' and 'none'** — `--assignee me` for current user, `--assignee none` for unassigned items.
-7. **Check exit codes** — 0=OK, 2=not found, 3=auth error, 4=permission denied, 5=API error. Branch on exit code without parsing error text.
+7. **Check exit codes** — 0=OK, 2=not found, 3=auth, 4=forbidden, 5=rate limit, 6=network, 7=API error. Branch on the exit code or the JSON envelope's `retryable` field without parsing error text.
 8. **Deletes need confirmation** — `delete`/`remove` commands (pitches, scopes, tasks, issues, comments) prompt `[y/N]` interactively and **refuse when run non-interactively** unless you pass `--yes` (or `-y`). As an agent you have no TTY, so add `--yes` only after you have confirmed the deletion is intended.
 
 ### Output Modes
@@ -99,10 +99,16 @@ Manage pitches, scopes, tasks, issues, and cycles via the ShapeUp CLI. Columns a
 | 2 | Not found |
 | 3 | Auth error |
 | 4 | Permission denied |
-| 5 | API error |
-| 6 | Rate limited |
+| 5 | Rate limited (retryable) |
+| 6 | Network error (retryable) |
+| 7 | API error |
+| 8 | Ambiguous selector |
 | 130 | Interrupted (Ctrl-C) |
 
+With `--json`, `--agent`, or piped output, errors arrive as a JSON envelope on stdout:
+`{"ok": false, "error": "...", "code": "rate_limit", "retryable": true, "hint": "..."}`.
+Branch on `retryable` to decide retry-vs-abandon; `false` means "no known reason a retry helps".
+
 ## Quick Reference
 
 | Task | Command |
@@ -112,6 +118,8 @@ Manage pitches, scopes, tasks, issues, and cycles via the ShapeUp CLI. Columns a
 | Auth status | `shapeup auth status` |
 | List orgs | `shapeup orgs --json` |
 | Show current org | `shapeup config show` |
+| Trace config precedence | `shapeup config explain` |
+| Diagnose setup problems | `shapeup doctor` |
 | Set default org | `shapeup config set org "Compass Labs"` |
 | Per-directory config | `shapeup config init "Compass Labs"` |
 | Install skill | `shapeup setup claude` |
@@ -366,6 +374,8 @@ Creates `.shapeup/config.json` in the current directory. All commands in this di
 ```bash
 shapeup config set org "Compass Labs"
 shapeup config set host https://shapeup.cc
+shapeup doctor            # full setup diagnosis with fix hints
+shapeup config explain    # why is the CLI using this org/host/token?
 ```
 
 ### Environment Variables

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shapeup-cli
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - ShapeUp
@@ -31,6 +31,7 @@ files:
 - lib/shapeup_cli/commands/comments.rb
 - lib/shapeup_cli/commands/config_cmd.rb
 - lib/shapeup_cli/commands/cycle.rb
+- lib/shapeup_cli/commands/doctor.rb
 - lib/shapeup_cli/commands/issues.rb
 - lib/shapeup_cli/commands/login.rb
 - lib/shapeup_cli/commands/logout.rb
@@ -45,6 +46,7 @@ files:
 - lib/shapeup_cli/commands/tasks.rb
 - lib/shapeup_cli/config.rb
 - lib/shapeup_cli/output.rb
+- lib/shapeup_cli/surface.rb
 - lib/shapeup_cli/version.rb
 - skills/shapeup/SKILL.md
 homepage: https://github.com/shapeupcc/shapeup-cli