fizzy-cli 0.3.2 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e138fc3dd09193bc96ddc984ec1a4c68c5d425ab1522f90633cb8013741dcab2
-  data.tar.gz: ad8e75db7233f1fb6fb6aed72713c0a7876bc5cc94f0e39644b18562e02f3c97
+  metadata.gz: eb20ca66466e8b1749b5b02f88107fa31ca0a9cb4cffb51cfeca3e712eb6effa
+  data.tar.gz: 63b5c87f28cc3b915f77836f2147e8b1f747e6791c4f1918694df9290940ac16
 SHA512:
-  metadata.gz: f9fc0ed67b2f598b0959ba808b1b0b992430f2aba7c1e98f5b29aeb757351575e3700da8864943f385f2ffcd9be3795229cfdbb57a4bea963768559eacd1aac7
-  data.tar.gz: 4e3d6af1559e5994c1431b1a5681c806c8a3661cf8de8d0e84dbca5f44c7f1df598a4bac10238dada7f05267f48bfbc264ff6f526a8ac2eb4c0f49a5eed514d9
+  metadata.gz: 99464b430132e9ea62b098fc031112b8a6cebd8cf2ee350693b67cd189c850ee6f7ad7e8cc2ae6b9898e7377b273cf77db3e64bac1de5e406da70e996a843986
+  data.tar.gz: ebf5fae49836fa68aac920a8e309dbf8731002d48fcbf8415fbbeabcf3a1e9be8fc586c4b09115a7f0772d064e4ce176fd92321d429d6a1f78c02da7d12b70fb

data/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.4.1] - 2026-02-22
+
+### Fixed
+- Card create and update sent `body` instead of `description`, causing API 400 errors (field silently dropped by Rails strong params)
+- Card create with `--column` now triages via separate API call instead of sending unpermitted `column_id` param
+- HTTP 400 responses now get parsed error messages (like 422) instead of raw JSON dump
+- Cards, steps, and users update commands validate at least one option is provided before sending empty request
+
+### Added
+- `BadRequestError` class for explicit HTTP 400 handling
+
+## [0.4.0] - 2026-02-22
+
+### Added
+- Per-project `.fizzy.yml` config file for account and board defaults
+- `fizzy init` interactive command to create `.fizzy.yml`
+- `ProjectConfig` class that walks up directories to find nearest `.fizzy.yml`
+- Resolution priority: CLI flag > `.fizzy.yml` > global tokens.yml default
+- `Auth.token_data` class method to centralize token file reading
+- `--board` is now optional for columns and card create when set in `.fizzy.yml`
+
+### Fixed
+- Client follows Location header on any 2xx with empty body, not just 201
+- All update commands handle nil response body instead of crashing with NoMethodError
+- Skill file incorrectly documented `fizzy identity` instead of `fizzy auth identity`
+- Guard against empty string in `--board` and `--account` flag values
+- `ProjectConfig` rescues `Psych::SyntaxError` with user-friendly error message
+- Blank or non-hash `.fizzy.yml` files treated as empty config instead of crashing
+
 ## [0.3.2] - 2026-02-22
 
 ### Changed

data/README.md

@@ -51,6 +51,26 @@ fizzy auth accounts   # List available accounts
 fizzy auth switch SLUG  # Change default account
 ```
 
+## Project Configuration
+
+Set project-level defaults so you don't need `--account` and `--board` on every command:
+
+```sh
+fizzy init
+```
+
+This creates a `.fizzy.yml` in the current directory:
+
+```yaml
+account: acme
+board: b1
+```
+
+**Resolution priority** (highest wins):
+1. CLI flag (`--account` / `--board`)
+2. `.fizzy.yml` (nearest ancestor directory)
+3. Global `default_account` from `~/.config/fizzy-cli/tokens.yml`
+
 ## Usage
 
 All commands support `--json` for JSON output and `--account SLUG` to override the default account.
@@ -190,6 +210,7 @@ end
 
 | Source | Purpose |
 |--------|---------|
+| `.fizzy.yml` | Per-project account and board defaults |
 | `~/.config/fizzy-cli/tokens.yml` | Stored auth tokens and default account |
 | `FIZZY_TOKEN` env var | Token override (requires `--account`) |
 

data/lib/fizzy/auth.rb

@@ -19,13 +19,17 @@ module Fizzy
       slug&.delete_prefix("/")
     end
 
-    def self.resolve_from_file(account_slug)
+    def self.token_data
       unless File.exist?(TOKEN_FILE)
         raise AuthError,
               "No tokens file at #{TOKEN_FILE}. Run: fizzy auth login --token TOKEN"
       end
 
-      data = YAML.safe_load_file(TOKEN_FILE, permitted_classes: [Time])
+      YAML.safe_load_file(TOKEN_FILE, permitted_classes: [Time])
+    end
+
+    def self.resolve_from_file(account_slug)
+      data = token_data
       slug = normalize_slug(account_slug || data["default_account"])
       account = data["accounts"]&.find { |a| normalize_slug(a["account_slug"]) == slug }
       raise AuthError, "No account found for #{slug}" unless account

data/lib/fizzy/cli/base.rb

@@ -17,8 +17,24 @@ module Fizzy
         parent_options || options
       end
 
+      def project_config
+        @project_config ||= ProjectConfig.new
+      end
+
       def account
-        @account ||= Auth.resolve(global_options[:account])
+        slug = global_options[:account]
+        slug = nil if slug&.empty?
+        @account ||= Auth.resolve(slug || project_config.account)
+      end
+
+      def board
+        b = options[:board]
+        b && !b.empty? ? b : project_config.board
+      end
+
+      def require_board!
+        board || raise(Thor::Error,
+                       "No value provided for option '--board'. Set via --board, .fizzy.yml, or: fizzy init")
       end
 
       def client

data/lib/fizzy/cli/boards.rb

@@ -41,10 +41,14 @@ module Fizzy
       def update(board_id)
         resp = client.put("boards/#{board_id}", body: { name: options[:name] })
         b = resp.body
-        output_detail(b, pairs: [
-                        ["ID", b["id"]],
-                        ["Name", b["name"]]
-                      ])
+        if b
+          output_detail(b, pairs: [
+                          ["ID", b["id"]],
+                          ["Name", b["name"]]
+                        ])
+        else
+          puts "Board #{board_id} updated."
+        end
       end
 
       desc "delete BOARD_ID", "Delete a board"

data/lib/fizzy/cli/cards.rb

@@ -51,15 +51,15 @@ module Fizzy
       end
 
       desc "create TITLE", "Create a card"
-      option :board, required: true, desc: "Board ID"
+      option :board, 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("boards/#{options[:board]}/cards", body: body)
+        payload = { title: title }
+        payload[:description] = options[:body] if options[:body]
+        resp = client.post("boards/#{require_board!}/cards", body: payload)
         c = resp.body
+        client.post("cards/#{c["number"]}/triage", body: { column_id: options[:column] }) if options[:column]
         output_detail(c, pairs: [
                         ["Number", "##{c["number"]}"],
                         ["Title", c["title"]],
@@ -71,12 +71,21 @@ module Fizzy
       option :title, desc: "New title"
       option :body, desc: "New body (HTML)"
       def update(number)
-        resp = client.put("cards/#{number}", body: build_body(:title, :body))
+        payload = {}
+        payload[:title] = options[:title] if options[:title]
+        payload[:description] = options[:body] if options[:body]
+        raise Thor::Error, "Nothing to update. Provide --title or --body" if payload.empty?
+
+        resp = client.put("cards/#{number}", body: payload)
         c = resp.body
-        output_detail(c, pairs: [
-                        ["Number", "##{c["number"]}"],
-                        ["Title", c["title"]]
-                      ])
+        if c
+          output_detail(c, pairs: [
+                          ["Number", "##{c["number"]}"],
+                          ["Title", c["title"]]
+                        ])
+        else
+          puts "Card ##{number} updated."
+        end
       end
 
       desc "delete NUMBER", "Delete a card"

data/lib/fizzy/cli/columns.rb

@@ -6,18 +6,18 @@ module Fizzy
       include Base
 
       desc "list", "List columns for a board"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       def list
-        data = paginator.all("boards/#{options[:board]}/columns")
+        data = paginator.all("boards/#{require_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"
+      option :board, desc: "Board ID"
       def get(column_id)
-        resp = client.get("boards/#{options[:board]}/columns/#{column_id}")
+        resp = client.get("boards/#{require_board!}/columns/#{column_id}")
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -28,9 +28,9 @@ module Fizzy
       end
 
       desc "create NAME", "Create a column"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       def create(name)
-        resp = client.post("boards/#{options[:board]}/columns", body: { name: name })
+        resp = client.post("boards/#{require_board!}/columns", body: { name: name })
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -39,21 +39,25 @@ module Fizzy
       end
 
       desc "update COLUMN_ID", "Update a column"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       option :name, required: true, desc: "New column name"
       def update(column_id)
-        resp = client.put("boards/#{options[:board]}/columns/#{column_id}", body: { name: options[:name] })
+        resp = client.put("boards/#{require_board!}/columns/#{column_id}", body: { name: options[:name] })
         c = resp.body
-        output_detail(c, pairs: [
-                        ["ID", c["id"]],
-                        ["Name", c["name"]]
-                      ])
+        if c
+          output_detail(c, pairs: [
+                          ["ID", c["id"]],
+                          ["Name", c["name"]]
+                        ])
+        else
+          puts "Column #{column_id} updated."
+        end
       end
 
       desc "delete COLUMN_ID", "Delete a column"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       def delete(column_id)
-        client.delete("boards/#{options[:board]}/columns/#{column_id}")
+        client.delete("boards/#{require_board!}/columns/#{column_id}")
         puts "Column #{column_id} deleted."
       end
     end

data/lib/fizzy/cli/comments.rb

@@ -44,10 +44,14 @@ module Fizzy
       def update(comment_id)
         resp = client.put("cards/#{options[:card]}/comments/#{comment_id}", body: build_body(:body))
         c = resp.body
-        output_detail(c, pairs: [
-                        ["ID", c["id"]],
-                        ["Body", c["body"]]
-                      ])
+        if c
+          output_detail(c, pairs: [
+                          ["ID", c["id"]],
+                          ["Body", c["body"]]
+                        ])
+        else
+          puts "Comment #{comment_id} updated."
+        end
       end
 
       desc "delete COMMENT_ID", "Delete a comment"

data/lib/fizzy/cli/steps.rb

@@ -34,14 +34,21 @@ module Fizzy
       option :description, desc: "New description"
       option :completed, type: :boolean, desc: "Mark completed"
       def update(step_id)
+        body = build_body(:description, :completed)
+        raise Thor::Error, "Nothing to update. Provide --description or --completed" if body.empty?
+
         path = "cards/#{options[:card]}/steps/#{step_id}"
-        resp = client.put(path, body: build_body(:description, :completed))
+        resp = client.put(path, body: body)
         s = resp.body
-        output_detail(s, pairs: [
-                        ["ID", s["id"]],
-                        ["Description", s["description"]],
-                        ["Completed", s["completed"]]
-                      ])
+        if s
+          output_detail(s, pairs: [
+                          ["ID", s["id"]],
+                          ["Description", s["description"]],
+                          ["Completed", s["completed"]]
+                        ])
+        else
+          puts "Step #{step_id} updated."
+        end
       end
 
       desc "delete STEP_ID", "Delete a step"

data/lib/fizzy/cli/users.rb

@@ -31,13 +31,20 @@ module Fizzy
       option :name, desc: "New name"
       option :role, desc: "New role"
       def update(user_id)
-        resp = client.put("users/#{user_id}", body: build_body(:name, :role))
+        body = build_body(:name, :role)
+        raise Thor::Error, "Nothing to update. Provide --name or --role" if body.empty?
+
+        resp = client.put("users/#{user_id}", body: body)
         u = resp.body
-        output_detail(u, pairs: [
-                        ["ID", u["id"]],
-                        ["Name", u["name"]],
-                        ["Role", u["role"]]
-                      ])
+        if u
+          output_detail(u, pairs: [
+                          ["ID", u["id"]],
+                          ["Name", u["name"]],
+                          ["Role", u["role"]]
+                        ])
+        else
+          puts "User #{user_id} updated."
+        end
       end
 
       desc "deactivate USER_ID", "Deactivate a user"

data/lib/fizzy/cli.rb

@@ -25,6 +25,19 @@ module Fizzy
       puts "fizzy-cli #{VERSION}"
     end
 
+    desc "init", "Create .fizzy.yml in current directory"
+    def init
+      config_path = File.join(Dir.pwd, ProjectConfig::FILENAME)
+      return if File.exist?(config_path) && !yes?("#{config_path} already exists. Overwrite?")
+
+      selected = pick_account
+      config = { "account" => selected["account_slug"] }
+      config["board"] = pick_board(selected) if yes?("Set a default board?")
+
+      File.write(config_path, YAML.dump(config))
+      say "Wrote #{config_path}"
+    end
+
     desc "boards SUBCOMMAND ...ARGS", "Manage boards"
     subcommand "boards", CLI::Boards
 
@@ -62,5 +75,47 @@ module Fizzy
     subcommand "skill", CLI::Skill
 
     def self.exit_on_failure? = true
+
+    private
+
+    def pick_account
+      data = Auth.token_data
+      accounts = Array(data["accounts"])
+      raise AuthError, "No accounts found. Run: fizzy auth login --token TOKEN" if accounts.empty?
+
+      say "Available accounts:"
+      accounts.each_with_index do |a, i|
+        marker = a["account_slug"] == data["default_account"] ? " (default)" : ""
+        say "  #{i + 1}. #{a["account_name"]} (#{a["account_slug"]})#{marker}"
+      end
+
+      choice = ask("Select account number [1]:").strip
+      choice = "1" if choice.empty?
+      idx = choice.to_i - 1
+      raise Thor::Error, "Invalid selection" unless idx >= 0 && idx < accounts.size
+
+      accounts[idx]
+    end
+
+    def pick_board(account)
+      c = Client.new(token: account["access_token"], account_slug: account["account_slug"])
+      boards = c.get("boards").body
+
+      if boards.empty?
+        say "No boards found."
+        return nil
+      end
+
+      say "Boards:"
+      boards.each_with_index do |b, i|
+        say "  #{i + 1}. #{b["name"]} (#{b["id"]})"
+      end
+
+      board_idx = ask("Select board number:").strip.to_i - 1
+      return boards[board_idx]["id"] if board_idx >= 0 && board_idx < boards.size
+
+      say "Invalid selection, skipping board."
+      nil
+    end
   end
 end

data/lib/fizzy/client.rb

@@ -81,13 +81,15 @@ module Fizzy
 
       case status
       when 200..299
-        # Follow Location header on 201 to fetch the created resource
-        if status == 201 && parsed_body.nil? && response["location"]
+        # Follow Location header to fetch the resource when body is empty
+        if parsed_body.nil? && response["location"]
           location = response["location"].sub(/\.json$/, "")
           return get(location)
         end
 
         Response.new(body: parsed_body, headers: response.to_hash, status: status)
+      when 400
+        raise BadRequestError.new(parse_error(response), status: 400, body: parsed_body)
       when 301, 302
         raise AuthError.new("Redirected to #{response["location"]} — endpoint may require session auth",
                             status: status, body: parsed_body)

data/lib/fizzy/errors.rb

@@ -11,6 +11,7 @@ module Fizzy
     end
   end
 
+  class BadRequestError < Error; end
   class AuthError < Error; end
   class NotFoundError < Error; end
   class ValidationError < Error; end

data/lib/fizzy/project_config.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class ProjectConfig
+    FILENAME = ".fizzy.yml"
+
+    attr_reader :path
+
+    def initialize(start_dir = Dir.pwd)
+      @path = find_config(start_dir)
+      data = @path ? YAML.safe_load_file(@path) : {}
+      @data = data.is_a?(Hash) ? data : {}
+    rescue Psych::SyntaxError => e
+      raise Thor::Error, "Bad .fizzy.yml at #{@path}: #{e.message}"
+    end
+
+    def found? = !@path.nil?
+
+    def account = @data["account"]
+
+    def board = @data["board"]
+
+    private
+
+    def find_config(dir)
+      candidate = File.join(dir, FILENAME)
+      return candidate if File.exist?(candidate)
+
+      parent = File.dirname(dir)
+      return nil if parent == dir
+
+      find_config(parent)
+    end
+  end
+end

data/lib/fizzy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fizzy
-  VERSION = "0.3.2"
+  VERSION = "0.4.1"
 end

data/lib/fizzy.rb

@@ -8,6 +8,7 @@ require "yaml"
 require_relative "fizzy/version"
 require_relative "fizzy/errors"
 require_relative "fizzy/auth"
+require_relative "fizzy/project_config"
 require_relative "fizzy/client"
 require_relative "fizzy/paginator"
 require_relative "fizzy/formatter"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fizzy-cli
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.1
 platform: ruby
 authors:
 - David Paluy
@@ -59,6 +59,7 @@ files:
 - lib/fizzy/errors.rb
 - lib/fizzy/formatter.rb
 - lib/fizzy/paginator.rb
+- lib/fizzy/project_config.rb
 - lib/fizzy/version.rb
 homepage: https://github.com/dpaluy/fizzy-cli
 licenses: