fizzy-cli 0.4.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb20ca66466e8b1749b5b02f88107fa31ca0a9cb4cffb51cfeca3e712eb6effa
-  data.tar.gz: 63b5c87f28cc3b915f77836f2147e8b1f747e6791c4f1918694df9290940ac16
+  metadata.gz: 1684a8ac9b61399c368c8ff3b5828f00f965d65cfedadaa03c23eefe002f4661
+  data.tar.gz: 31615887c4f1c5bbdc7b33c08e216690a1b440b8551e8328ecbefcb455e2fbe4
 SHA512:
-  metadata.gz: 99464b430132e9ea62b098fc031112b8a6cebd8cf2ee350693b67cd189c850ee6f7ad7e8cc2ae6b9898e7377b273cf77db3e64bac1de5e406da70e996a843986
-  data.tar.gz: ebf5fae49836fa68aac920a8e309dbf8731002d48fcbf8415fbbeabcf3a1e9be8fc586c4b09115a7f0772d064e4ce176fd92321d429d6a1f78c02da7d12b70fb
+  metadata.gz: 262b4e467ca32aaa6e202bb21358d0111870ca449983112abdd0d45cfe8e87229b904f0b28185c7ab4246848f69222d9e363aadae9bb49a25af4314a4e96bc5e
+  data.tar.gz: c6d180d3c263bbf9eefe2bcdd28de99809d825d8af974044e64a8d91c66ac45d7cd35ef07e5dad3204b59187fa6e1c62d4aed303655585ffe5693cd20b95268c

data/CHANGELOG.md

@@ -5,6 +5,26 @@ 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.6.0] - 2026-02-23
+
+### Added
+- Custom URL support for self-hosted Fizzy instances
+- `fizzy auth login --url URL` stores instance URL per-account in tokens.yml
+- `url` key in `.fizzy.yml` for per-project instance URL
+- `FIZZY_URL` environment variable for instance URL override
+- URL resolution priority: `FIZZY_URL` env > `.fizzy.yml` > tokens.yml per-account > default
+- URL validation in Client rejects non-http(s) URLs with clear error message
+- `auth status` displays URL when using a non-default instance
+- HTTP scheme detection for SSL (supports `http://` for local development)
+
+## [0.5.0] - 2026-02-22
+
+### Added
+- Cache boards in `.fizzy.yml` as `boards: { id: name }` hash for quick lookups without API calls
+- `fizzy boards sync` command to refresh the cached boards list from the API
+- `fizzy init` now automatically fetches and caches all boards during setup
+- `ProjectConfig#boards` accessor for reading cached board data
+
 ## [0.4.1] - 2026-02-22
 
 ### Fixed

data/README.md

@@ -43,7 +43,13 @@ fizzy skill uninstall                        # Remove skill file
 fizzy auth login --token YOUR_TOKEN
 ```
 
-Tokens are stored at `~/.config/fizzy-cli/tokens.yml`. You can also set `FIZZY_TOKEN` as an environment variable with `--account` to skip the file.
+For self-hosted Fizzy instances, pass `--url`:
+
+```sh
+fizzy auth login --token YOUR_TOKEN --url https://fizzy.mycompany.com
+```
+
+The URL is stored per-account in `~/.config/fizzy-cli/tokens.yml`. You can also set `FIZZY_TOKEN` as an environment variable with `--account` to skip the file.
 
 ```sh
 fizzy auth status     # Show current auth
@@ -66,6 +72,14 @@ account: acme
 board: b1
 ```
 
+For self-hosted instances, add a `url` key:
+
+```yaml
+account: acme
+board: b1
+url: https://fizzy.mycompany.com
+```
+
 **Resolution priority** (highest wins):
 1. CLI flag (`--account` / `--board`)
 2. `.fizzy.yml` (nearest ancestor directory)
@@ -210,9 +224,16 @@ end
 
 | Source | Purpose |
 |--------|---------|
-| `.fizzy.yml` | Per-project account and board defaults |
-| `~/.config/fizzy-cli/tokens.yml` | Stored auth tokens and default account |
+| `.fizzy.yml` | Per-project account, board, and URL defaults |
+| `~/.config/fizzy-cli/tokens.yml` | Stored auth tokens, default account, and per-account URL |
 | `FIZZY_TOKEN` env var | Token override (requires `--account`) |
+| `FIZZY_URL` env var | Instance URL override (default: `https://app.fizzy.do`) |
+
+**URL resolution priority** (highest wins):
+1. `FIZZY_URL` environment variable
+2. `url` in `.fizzy.yml`
+3. Per-account `url` from `tokens.yml` (set via `fizzy auth login --url`)
+4. Default: `https://app.fizzy.do`
 
 ## Development
 

data/lib/fizzy/cli/auth.rb

@@ -24,11 +24,15 @@ module Fizzy
 
       desc "login", "Authenticate with a Personal Access Token"
       option :token, required: true, desc: "Personal Access Token"
+      option :url, type: :string, desc: "Custom Fizzy instance URL (default: #{Client::DEFAULT_BASE_URL})"
       def login
         token = options[:token]
+        custom_url = options[:url]
 
         # Verify token by fetching identity
-        c = Client.new(token: token, account_slug: "")
+        client_opts = { token: token, account_slug: "" }
+        client_opts[:base_url] = custom_url if custom_url
+        c = Client.new(**client_opts)
         resp = c.get("/my/identity")
         accounts = resp.body["accounts"]
 
@@ -36,7 +40,7 @@ module Fizzy
 
         # Build tokens data
         token_accounts = accounts.map do |a|
-          {
+          acct = {
             "account_slug" => Auth.normalize_slug(a["slug"]),
             "account_name" => a["name"],
             "account_id" => a["id"],
@@ -49,6 +53,8 @@ module Fizzy
             },
             "created_at" => Time.now.utc.strftime("%Y-%m-%dT%H:%M:%S.%3NZ")
           }
+          acct["url"] = custom_url if custom_url
+          acct
         end
 
         data = {
@@ -69,13 +75,12 @@ module Fizzy
 
       desc "status", "Show current auth status"
       def status
-        acct = Auth.resolve
-        c = Client.new(token: acct["access_token"], account_slug: acct["account_slug"])
-        resp = c.get("/my/identity")
+        resp = client.get("/my/identity")
 
+        puts "URL: #{client.base_url}" unless base_url == Client::DEFAULT_BASE_URL
         puts "Token: #{Auth::TOKEN_FILE}"
-        puts "Account: #{acct["account_name"]} (#{acct["account_slug"]})"
-        puts "User: #{acct.dig("user", "name")} <#{acct.dig("user", "email_address")}>"
+        puts "Account: #{account["account_name"]} (#{account["account_slug"]})"
+        puts "User: #{account.dig("user", "name")} <#{account.dig("user", "email_address")}>"
 
         accounts_count = resp.body["accounts"].size
         puts "Accounts: #{accounts_count}" if accounts_count > 1

data/lib/fizzy/cli/base.rb

@@ -37,10 +37,15 @@ module Fizzy
                        "No value provided for option '--board'. Set via --board, .fizzy.yml, or: fizzy init")
       end
 
+      def base_url
+        ENV["FIZZY_URL"] || project_config.url || account["url"] || Client::DEFAULT_BASE_URL
+      end
+
       def client
         @client ||= Client.new(
           token: account["access_token"],
-          account_slug: account["account_slug"]
+          account_slug: account["account_slug"],
+          base_url: base_url
         )
       end
 

data/lib/fizzy/cli/boards.rb

@@ -56,6 +56,21 @@ module Fizzy
         client.delete("boards/#{board_id}")
         puts "Board #{board_id} deleted."
       end
+
+      desc "sync", "Refresh boards cache in .fizzy.yml"
+      def sync
+        raise Thor::Error, "No .fizzy.yml found. Run: fizzy init" unless project_config.found?
+
+        boards = paginator.all("boards")
+        boards_hash = boards.to_h { |b| [b["id"], b["name"]] }
+
+        config = YAML.safe_load_file(project_config.path)
+        config = {} unless config.is_a?(Hash)
+        config["boards"] = boards_hash
+
+        File.write(project_config.path, YAML.dump(config))
+        say "Synced #{boards_hash.size} board(s) to #{project_config.path}"
+      end
     end
   end
 end

data/lib/fizzy/cli.rb

@@ -32,7 +32,10 @@ module Fizzy
 
       selected = pick_account
       config = { "account" => selected["account_slug"] }
-      config["board"] = pick_board(selected) if yes?("Set a default board?")
+
+      boards = fetch_boards(selected)
+      config["boards"] = boards.to_h { |b| [b["id"], b["name"]] } if boards.any?
+      config["board"] = pick_board(boards) if boards.any? && yes?("Set a default board?")
 
       File.write(config_path, YAML.dump(config))
       say "Wrote #{config_path}"
@@ -97,15 +100,15 @@ module Fizzy
       accounts[idx]
     end
 
-    def pick_board(account)
-      c = Client.new(token: account["access_token"], account_slug: account["account_slug"])
+    def fetch_boards(account)
+      url = ENV["FIZZY_URL"] || account["url"] || Client::DEFAULT_BASE_URL
+      c = Client.new(token: account["access_token"], account_slug: account["account_slug"], base_url: url)
       boards = c.get("boards").body
+      say "No boards found." if boards.empty?
+      boards
+    end
 
-      if boards.empty?
-        say "No boards found."
-        return nil
-      end
-
+    def pick_board(boards)
       say "Boards:"
       boards.each_with_index do |b, i|
         say "  #{i + 1}. #{b["name"]} (#{b["id"]})"

data/lib/fizzy/client.rb

@@ -4,11 +4,15 @@ module Fizzy
   Response = Data.define(:body, :headers, :status)
 
   class Client
-    BASE_URL = "https://app.fizzy.do"
+    DEFAULT_BASE_URL = "https://app.fizzy.do"
 
-    def initialize(token:, account_slug:)
+    attr_reader :base_url
+
+    def initialize(token:, account_slug:, base_url: DEFAULT_BASE_URL)
       @token = token
       @account_slug = account_slug
+      @base_url = base_url.chomp("/")
+      raise ArgumentError, "Invalid URL (must be http or https): #{@base_url}" unless @base_url.match?(%r{\Ahttps?://})
     end
 
     def get(path, params: {})
@@ -31,9 +35,9 @@ module Fizzy
 
     def connection
       @connection ||= begin
-        uri = URI(BASE_URL)
+        uri = URI(@base_url)
         http = Net::HTTP.new(uri.host, uri.port)
-        http.use_ssl = true
+        http.use_ssl = uri.scheme == "https"
         http.open_timeout = 5
         http.read_timeout = 30
         http.start
@@ -48,7 +52,7 @@ module Fizzy
 
     def request(method, path, body: nil, params: {})
       full_path = path.start_with?("/") ? path : "/#{@account_slug}/#{path}"
-      uri = URI("#{BASE_URL}#{full_path}")
+      uri = URI("#{@base_url}#{full_path}")
       uri.query = URI.encode_www_form(params) unless params.empty?
 
       req = build_request(method, uri)

data/lib/fizzy/project_config.rb

@@ -20,6 +20,10 @@ module Fizzy
 
     def board = @data["board"]
 
+    def url = @data["url"]
+
+    def boards = @data["boards"] || {}
+
     private
 
     def find_config(dir)

data/lib/fizzy/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fizzy-cli
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.6.0
 platform: ruby
 authors:
 - David Paluy