fizzy-cli 0.1.0

data/lib/fizzy/cli/cards.rb

@@ -0,0 +1,178 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Cards < Thor
+      include Base
+
+      desc "list", "List cards"
+      option :board, desc: "Board ID (filter)"
+      option :column, desc: "Column ID (filter)"
+      option :status, desc: "Filter: open, closed, all", default: "open"
+      option :assignee, desc: "Assignee user ID (filter)"
+      option :tag, desc: "Tag ID (filter, repeatable)", type: :array
+      def list
+        params = {}
+        params[:status] = options[:status] if options[:status]
+        params[:board_id] = options[:board] if options[:board]
+        params[:column_id] = options[:column] if options[:column]
+        params[:assignee_id] = options[:assignee] if options[:assignee]
+        options[:tag]&.each { |t| (params[:"tag_ids[]"] ||= []) << t }
+
+        data = paginator.all("#{slug}/cards", params: params)
+        output_list(data, headers: %w[# Title Board Status Column]) do |c|
+          [
+            c["number"],
+            Formatter.truncate(c["title"], 50),
+            c.dig("board", "name") || "",
+            c["status"],
+            c.dig("column", "name") || ""
+          ]
+        end
+      end
+
+      desc "get NUMBER", "Show a card"
+      def get(number)
+        resp = client.get("#{slug}/cards/#{number}")
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["Number", "##{c["number"]}"],
+                        ["Title", c["title"]],
+                        ["Board", c.dig("board", "name")],
+                        ["Column", c.dig("column", "name")],
+                        ["Status", c["status"]],
+                        ["Creator", c.dig("creator", "name")],
+                        ["Assignees", format_assignees(c["assignees"])],
+                        ["Tags", format_tags(c["tags"])],
+                        ["Steps", format_steps(c["steps"])],
+                        ["Created", c["created_at"]],
+                        ["URL", c["url"]]
+                      ])
+      end
+
+      desc "create TITLE", "Create a card"
+      option :board, required: true, desc: "Board ID"
+      option :body, desc: "Card body (HTML)"
+      option :column, desc: "Column ID"
+      def create(title)
+        body = { title: title }
+        body[:body] = options[:body] if options[:body]
+        body[:column_id] = options[:column] if options[:column]
+        resp = client.post("#{slug}/boards/#{options[:board]}/cards", body: body)
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["Number", "##{c["number"]}"],
+                        ["Title", c["title"]],
+                        ["URL", c["url"]]
+                      ])
+      end
+
+      desc "update NUMBER", "Update a card"
+      option :title, desc: "New title"
+      option :body, desc: "New body (HTML)"
+      def update(number)
+        resp = client.put("#{slug}/cards/#{number}", body: build_body(:title, :body))
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["Number", "##{c["number"]}"],
+                        ["Title", c["title"]]
+                      ])
+      end
+
+      desc "delete NUMBER", "Delete a card"
+      def delete(number)
+        client.delete("#{slug}/cards/#{number}")
+        puts "Card ##{number} deleted."
+      end
+
+      desc "close NUMBER", "Close a card"
+      def close(number)
+        client.post("#{slug}/cards/#{number}/closure")
+        puts "Card ##{number} closed."
+      end
+
+      desc "reopen NUMBER", "Reopen a closed card"
+      def reopen(number)
+        client.delete("#{slug}/cards/#{number}/closure")
+        puts "Card ##{number} reopened."
+      end
+
+      desc "not-now NUMBER", "Mark a card as not-now"
+      map "not-now" => :not_now
+      def not_now(number)
+        client.post("#{slug}/cards/#{number}/not_now")
+        puts "Card ##{number} marked not-now."
+      end
+
+      desc "triage NUMBER", "Triage a card into a column"
+      option :column, required: true, desc: "Column ID"
+      def triage(number)
+        client.post("#{slug}/cards/#{number}/triage", body: { column_id: options[:column] })
+        puts "Card ##{number} triaged."
+      end
+
+      desc "untriage NUMBER", "Remove a card from triage"
+      def untriage(number)
+        client.delete("#{slug}/cards/#{number}/triage")
+        puts "Card ##{number} untriaged."
+      end
+
+      desc "tag NUMBER TAG_TITLE", "Add a tag to a card"
+      def tag(number, tag_title)
+        client.post("#{slug}/cards/#{number}/taggings", body: { tag_title: tag_title })
+        puts "Tag '#{tag_title}' added to card ##{number}."
+      end
+
+      desc "assign NUMBER ASSIGNEE_ID", "Toggle assignment on a card"
+      def assign(number, assignee_id)
+        client.post("#{slug}/cards/#{number}/assignments", body: { assignee_id: assignee_id })
+        puts "Assignment toggled for card ##{number}."
+      end
+
+      desc "watch NUMBER", "Watch a card"
+      def watch(number)
+        client.post("#{slug}/cards/#{number}/watch")
+        puts "Watching card ##{number}."
+      end
+
+      desc "unwatch NUMBER", "Unwatch a card"
+      def unwatch(number)
+        client.delete("#{slug}/cards/#{number}/watch")
+        puts "Unwatched card ##{number}."
+      end
+
+      desc "golden NUMBER", "Mark a card as golden"
+      def golden(number)
+        client.post("#{slug}/cards/#{number}/goldness")
+        puts "Card ##{number} marked golden."
+      end
+
+      desc "ungolden NUMBER", "Remove golden from a card"
+      def ungolden(number)
+        client.delete("#{slug}/cards/#{number}/goldness")
+        puts "Card ##{number} ungolden."
+      end
+
+      private
+
+      def format_assignees(assignees)
+        return "" unless assignees&.any?
+
+        assignees.map { |a| a["name"] }.join(", ")
+      end
+
+      def format_tags(tags)
+        return "" unless tags&.any?
+
+        tags.map { |t| t["title"] || t["name"] }.join(", ")
+      end
+
+      def format_steps(steps)
+        return "" unless steps&.any?
+
+        done = steps.count { |s| s["completed"] }
+        "#{done}/#{steps.size}"
+      end
+    end
+  end
+end

data/lib/fizzy/cli/columns.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Columns < Thor
+      include Base
+
+      desc "list", "List columns for a board"
+      option :board, required: true, desc: "Board ID"
+      def list
+        data = paginator.all("#{slug}/boards/#{options[:board]}/columns")
+        output_list(data, headers: %w[ID Name Position]) do |c|
+          [c["id"], c["name"], c["position"]]
+        end
+      end
+
+      desc "get COLUMN_ID", "Show a column"
+      option :board, required: true, desc: "Board ID"
+      def get(column_id)
+        resp = client.get("#{slug}/boards/#{options[:board]}/columns/#{column_id}")
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["ID", c["id"]],
+                        ["Name", c["name"]],
+                        ["Position", c["position"]],
+                        ["Created", c["created_at"]]
+                      ])
+      end
+
+      desc "create NAME", "Create a column"
+      option :board, required: true, desc: "Board ID"
+      def create(name)
+        resp = client.post("#{slug}/boards/#{options[:board]}/columns", body: { name: name })
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["ID", c["id"]],
+                        ["Name", c["name"]]
+                      ])
+      end
+
+      desc "update COLUMN_ID", "Update a column"
+      option :board, required: true, desc: "Board ID"
+      option :name, required: true, desc: "New column name"
+      def update(column_id)
+        resp = client.put("#{slug}/boards/#{options[:board]}/columns/#{column_id}", body: { name: options[:name] })
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["ID", c["id"]],
+                        ["Name", c["name"]]
+                      ])
+      end
+
+      desc "delete COLUMN_ID", "Delete a column"
+      option :board, required: true, desc: "Board ID"
+      def delete(column_id)
+        client.delete("#{slug}/boards/#{options[:board]}/columns/#{column_id}")
+        puts "Column #{column_id} deleted."
+      end
+    end
+  end
+end

data/lib/fizzy/cli/comments.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Comments < Thor
+      include Base
+
+      desc "list", "List comments on a card"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      def list
+        data = paginator.all("#{slug}/cards/#{options[:card]}/comments")
+        output_list(data, headers: %w[ID Author Created]) do |c|
+          [c["id"], c.dig("creator", "name"), c["created_at"]]
+        end
+      end
+
+      desc "get COMMENT_ID", "Show a comment"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      def get(comment_id)
+        resp = client.get("#{slug}/cards/#{options[:card]}/comments/#{comment_id}")
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["ID", c["id"]],
+                        ["Author", c.dig("creator", "name")],
+                        ["Body", c["body"]],
+                        ["Created", c["created_at"]]
+                      ])
+      end
+
+      desc "create BODY", "Add a comment to a card"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      def create(body_text)
+        resp = client.post("#{slug}/cards/#{options[:card]}/comments", body: { body: body_text })
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["ID", c["id"]],
+                        ["Body", c["body"]]
+                      ])
+      end
+
+      desc "update COMMENT_ID", "Update a comment"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      option :body, required: true, desc: "New body"
+      def update(comment_id)
+        resp = client.put("#{slug}/cards/#{options[:card]}/comments/#{comment_id}", body: build_body(:body))
+        c = resp.body
+        output_detail(c, pairs: [
+                        ["ID", c["id"]],
+                        ["Body", c["body"]]
+                      ])
+      end
+
+      desc "delete COMMENT_ID", "Delete a comment"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      def delete(comment_id)
+        client.delete("#{slug}/cards/#{options[:card]}/comments/#{comment_id}")
+        puts "Comment #{comment_id} deleted."
+      end
+    end
+  end
+end

data/lib/fizzy/cli/notifications.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Notifications < Thor
+      include Base
+
+      desc "list", "List notifications"
+      def list
+        data = paginator.all("#{slug}/notifications")
+        output_list(data, headers: %w[ID Type Card Read Created]) do |n|
+          [
+            n["id"],
+            n["event_type"],
+            n.dig("card", "title") || "",
+            n["read_at"] ? "yes" : "no",
+            n["created_at"]
+          ]
+        end
+      end
+
+      desc "read ID", "Mark notification as read"
+      def read(id)
+        client.post("#{slug}/notifications/#{id}/reading")
+        puts "Notification #{id} marked read."
+      end
+
+      desc "unread ID", "Mark notification as unread"
+      def unread(id)
+        client.delete("#{slug}/notifications/#{id}/reading")
+        puts "Notification #{id} marked unread."
+      end
+
+      desc "mark-all-read", "Mark all notifications as read"
+      map "mark-all-read" => :mark_all_read
+      def mark_all_read
+        client.post("#{slug}/notifications/bulk_reading")
+        puts "All notifications marked read."
+      end
+    end
+  end
+end

data/lib/fizzy/cli/pins.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Pins < Thor
+      include Base
+
+      desc "list", "List pinned cards"
+      def list
+        data = paginator.all("/my/pins")
+        output_list(data, headers: %w[# Title Board]) do |p|
+          card = p["card"] || p
+          [card["number"], card["title"], card.dig("board", "name") || ""]
+        end
+      end
+
+      desc "pin NUMBER", "Pin a card"
+      def pin(number)
+        client.post("#{slug}/cards/#{number}/pin")
+        puts "Card ##{number} pinned."
+      end
+
+      desc "unpin NUMBER", "Unpin a card"
+      def unpin(number)
+        client.delete("#{slug}/cards/#{number}/pin")
+        puts "Card ##{number} unpinned."
+      end
+    end
+  end
+end

data/lib/fizzy/cli/reactions.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Reactions < Thor
+      include Base
+
+      desc "list", "List reactions on a card"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      option :comment, desc: "Comment ID (for comment reactions)"
+      def list
+        path = reaction_path(options[:card], options[:comment])
+        data = paginator.all(path)
+        output_list(data, headers: %w[ID Content User]) do |r|
+          [r["id"], r["content"], r.dig("creator", "name")]
+        end
+      end
+
+      desc "create CONTENT", "Add a reaction"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      option :comment, desc: "Comment ID (for comment reactions)"
+      def create(content)
+        path = reaction_path(options[:card], options[:comment])
+        resp = client.post(path, body: { content: content })
+        r = resp.body
+        output_detail(r, pairs: [
+                        ["ID", r["id"]],
+                        ["Content", r["content"]]
+                      ])
+      end
+
+      desc "delete REACTION_ID", "Remove a reaction"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      option :comment, desc: "Comment ID (for comment reactions)"
+      def delete(reaction_id)
+        path = "#{reaction_path(options[:card], options[:comment])}/#{reaction_id}"
+        client.delete(path)
+        puts "Reaction #{reaction_id} deleted."
+      end
+
+      private
+
+      def reaction_path(card_number, comment_id = nil)
+        base = "#{slug}/cards/#{card_number}"
+        comment_id ? "#{base}/comments/#{comment_id}/reactions" : "#{base}/reactions"
+      end
+    end
+  end
+end

data/lib/fizzy/cli/steps.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Steps < Thor
+      include Base
+
+      desc "get STEP_ID", "Show a step"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      def get(step_id)
+        resp = client.get("#{slug}/cards/#{options[:card]}/steps/#{step_id}")
+        s = resp.body
+        output_detail(s, pairs: [
+                        ["ID", s["id"]],
+                        ["Description", s["description"]],
+                        ["Completed", s["completed"]],
+                        ["Position", s["position"]]
+                      ])
+      end
+
+      desc "create DESCRIPTION", "Add a step to a card"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      def create(description)
+        resp = client.post("#{slug}/cards/#{options[:card]}/steps", body: { description: description })
+        s = resp.body
+        output_detail(s, pairs: [
+                        ["ID", s["id"]],
+                        ["Description", s["description"]]
+                      ])
+      end
+
+      desc "update STEP_ID", "Update a step"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      option :description, desc: "New description"
+      option :completed, type: :boolean, desc: "Mark completed"
+      def update(step_id)
+        path = "#{slug}/cards/#{options[:card]}/steps/#{step_id}"
+        resp = client.put(path, body: build_body(:description, :completed))
+        s = resp.body
+        output_detail(s, pairs: [
+                        ["ID", s["id"]],
+                        ["Description", s["description"]],
+                        ["Completed", s["completed"]]
+                      ])
+      end
+
+      desc "delete STEP_ID", "Delete a step"
+      option :card, required: true, type: :numeric, desc: "Card number"
+      def delete(step_id)
+        client.delete("#{slug}/cards/#{options[:card]}/steps/#{step_id}")
+        puts "Step #{step_id} deleted."
+      end
+    end
+  end
+end

data/lib/fizzy/cli/tags.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Tags < Thor
+      include Base
+
+      desc "list", "List all tags"
+      def list
+        data = paginator.all("#{slug}/tags")
+        output_list(data, headers: %w[ID Title Color]) do |t|
+          [t["id"], t["title"] || t["name"], t["color"]]
+        end
+      end
+    end
+  end
+end

data/lib/fizzy/cli/users.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class CLI < Thor
+    class Users < Thor
+      include Base
+
+      desc "list", "List users"
+      def list
+        data = paginator.all("#{slug}/users")
+        output_list(data, headers: %w[ID Name Email Role Active]) do |u|
+          [u["id"], u["name"], u["email_address"], u["role"], u["active"]]
+        end
+      end
+
+      desc "get USER_ID", "Show a user"
+      def get(user_id)
+        resp = client.get("#{slug}/users/#{user_id}")
+        u = resp.body
+        output_detail(u, pairs: [
+                        ["ID", u["id"]],
+                        ["Name", u["name"]],
+                        ["Email", u["email_address"]],
+                        ["Role", u["role"]],
+                        ["Active", u["active"]],
+                        ["Created", u["created_at"]]
+                      ])
+      end
+
+      desc "update USER_ID", "Update a user"
+      option :name, desc: "New name"
+      option :role, desc: "New role"
+      def update(user_id)
+        resp = client.put("#{slug}/users/#{user_id}", body: build_body(:name, :role))
+        u = resp.body
+        output_detail(u, pairs: [
+                        ["ID", u["id"]],
+                        ["Name", u["name"]],
+                        ["Role", u["role"]]
+                      ])
+      end
+
+      desc "deactivate USER_ID", "Deactivate a user"
+      def deactivate(user_id)
+        client.delete("#{slug}/users/#{user_id}")
+        puts "User #{user_id} deactivated."
+      end
+    end
+  end
+end

data/lib/fizzy/cli.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require "thor"
+require_relative "cli/base"
+require_relative "cli/boards"
+require_relative "cli/cards"
+require_relative "cli/columns"
+require_relative "cli/steps"
+require_relative "cli/comments"
+require_relative "cli/reactions"
+require_relative "cli/tags"
+require_relative "cli/users"
+require_relative "cli/notifications"
+require_relative "cli/pins"
+require_relative "cli/auth"
+
+module Fizzy
+  class CLI < Thor
+    class_option :json, type: :boolean, desc: "Output as JSON"
+    class_option :account, type: :string, desc: "Account slug override"
+
+    desc "version", "Print version"
+    def version
+      puts "fizzy-cli #{VERSION}"
+    end
+
+    desc "boards SUBCOMMAND ...ARGS", "Manage boards"
+    subcommand "boards", CLI::Boards
+
+    desc "cards SUBCOMMAND ...ARGS", "Manage cards"
+    subcommand "cards", CLI::Cards
+
+    desc "columns SUBCOMMAND ...ARGS", "Manage columns"
+    subcommand "columns", CLI::Columns
+
+    desc "steps SUBCOMMAND ...ARGS", "Manage card steps"
+    subcommand "steps", CLI::Steps
+
+    desc "comments SUBCOMMAND ...ARGS", "Manage card comments"
+    subcommand "comments", CLI::Comments
+
+    desc "reactions SUBCOMMAND ...ARGS", "Manage reactions"
+    subcommand "reactions", CLI::Reactions
+
+    desc "tags SUBCOMMAND ...ARGS", "List tags"
+    subcommand "tags", CLI::Tags
+
+    desc "users SUBCOMMAND ...ARGS", "Manage users"
+    subcommand "users", CLI::Users
+
+    desc "notifications SUBCOMMAND ...ARGS", "Manage notifications"
+    subcommand "notifications", CLI::Notifications
+
+    desc "pins SUBCOMMAND ...ARGS", "Manage pinned cards"
+    subcommand "pins", CLI::Pins
+
+    desc "auth SUBCOMMAND ...ARGS", "Authentication commands"
+    subcommand "auth", CLI::AuthCommands
+
+    def self.exit_on_failure? = true
+  end
+end