fizzy-cli 0.7.0 → 0.9.0

package/docs/API.md

@@ -553,7 +553,8 @@ __Response:__
       "created_at": "2025-12-05T19:36:35.401Z",
       "url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7"
     },
-    "comments_url": "http://fizzy.localhost:3006/897362094/cards/4/comments"
+    "comments_url": "http://fizzy.localhost:3006/897362094/cards/4/comments",
+    "reactions_url": "http://fizzy.localhost:3006/897362094/cards/4/reactions"
   },
 ]
 ```
@@ -614,6 +615,7 @@ __Response:__
     "url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7"
   },
   "comments_url": "http://fizzy.localhost:3006/897362094/cards/4/comments",
+  "reactions_url": "http://fizzy.localhost:3006/897362094/cards/4/reactions",
   "steps": [
     {
       "id": "03f8huu0sog76g3s975963b5e",
@@ -928,7 +930,66 @@ __Response:__
 
 Returns `204 No Content` on success.
 
-## Reactions
+## Card Reactions (Boosts)
+
+Card reactions (also called "boosts") let users add short responses directly to cards. These are limited to 16 characters.
+
+### `GET /:account_slug/cards/:card_number/reactions`
+
+Returns a list of reactions on a card.
+
+__Response:__
+
+```json
+[
+  {
+    "id": "03f5v9zo9qlcwwpyc0ascnikz",
+    "content": "👍",
+    "reacter": {
+      "id": "03f5v9zjw7pz8717a4no1h8a7",
+      "name": "David Heinemeier Hansson",
+      "role": "owner",
+      "active": true,
+      "email_address": "david@example.com",
+      "created_at": "2025-12-05T19:36:35.401Z",
+      "url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7"
+    },
+    "url": "http://fizzy.localhost:3006/897362094/cards/3/reactions/03f5v9zo9qlcwwpyc0ascnikz"
+  }
+]
+```
+
+### `POST /:account_slug/cards/:card_number/reactions`
+
+Adds a reaction (boost) to a card.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `content` | string | Yes | The reaction text (max 16 characters) |
+
+__Request:__
+
+```json
+{
+  "reaction": {
+    "content": "Great 👍"
+  }
+}
+```
+
+__Response:__
+
+Returns `201 Created` on success.
+
+### `DELETE /:account_slug/cards/:card_number/reactions/:reaction_id`
+
+Removes your reaction from a card. Only the reaction creator can remove their own reactions.
+
+__Response:__
+
+Returns `204 No Content` on success.
+
+## Comment Reactions
 
 Reactions are short (16-character max) responses to comments.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fizzy-cli",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "CLI for https://fizzy.do",
   "main": "bin/fizzy",
   "type": "module",
@@ -9,6 +9,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
+    "prepack": "rm -f bin/fizzy bin/fizzy.exe",
     "build": "make build-all"
   },
   "repository": {

package/.github/workflows/release.yml

@@ -1,29 +0,0 @@
-name: Release
-
-on:
-  release:
-    types: [created]
-
-permissions:
-  contents: write
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Go
-        uses: actions/setup-go@v4
-        with:
-          go-version: "1.25"
-
-      - name: Build binaries
-        run: make build-all
-
-      - name: Upload Release Assets
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          gh release upload ${{ github.event.release.tag_name }} bin/fizzy-* --clobber

package/.github/workflows/tests.yml

@@ -1,24 +0,0 @@
-name: Tests
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-go@v4
-        with:
-          go-version: "1.25"
-
-      - name: Install gotestsum
-        run: go install gotest.tools/gotestsum@latest
-
-      - name: Run tests
-        run: make test

package/AGENTS.md

@@ -1,33 +0,0 @@
-# AGENTS.md
-
-## About
-
-fizzy-cli is a CLI application built in Go that provides an interface to the
-[Fizzy](https://fizzy.do) API. Fizzy is a kanban-style project management SaaS.
-
-## Dev instructions
-
-All the commands for development are available through Makefile, just read that
-file whenever you need to run something because chances are that you will find
-you answer there.
-
-You can find the Fizzy API specification at @docs/API.md
-
-## Testing
-
-Automated testing is done via `make test`.
-
-For manual testing/debugging, you should run `make install` first to install the
-binary and then run the `fizzy` command normally.
-
-## Code quality, standards and style
-
-This project is being built in Go because it's supposed to have a strong focus
-on performance. Always prefer performant code and solutions and low memory
-footprint.
-
-Don't write obvious code comments. Only use code comments when the code itself
-requires some clarification to be understood.
-
-When in doubt, always check similar files or features and reuse the patterns and
-style applied.

package/CHANGELOG.md

@@ -1,168 +0,0 @@
-# Changelog
-
-## 0.7.0 - 2026-01-26
-
-### Features
-
-#### Board Management
-
-- `fizzy board show <board_id>` - Display details for a specific board
-- `fizzy board update <board_id>` - Update board properties (name, access, auto-postpone period)
-- `fizzy board delete <board_id>` - Delete a board
-
-#### Column Management
-
-- `fizzy column show <column_id>` - Display details for a specific column
-- `fizzy column update <column_id>` - Update column properties (name, color)
-- `fizzy column delete <column_id>` - Delete a column
-
-### Improvements
-
-- Improved command output testability by using consistent output writers
-
-## 0.6.1 - 2026-01-26
-
-### Fixes
-
-- Fixed API client to not parse empty responses from POST endpoints, this was
-  causing the create sub-command of comment, reaction and step to show an error
-  message, even though the resource was actually created on the API.
-
-## 0.6.0 - 2026-01-25
-
-### Features
-
-#### Reaction Management
-
-- `fizzy reaction list <card_number> <comment_id>` - List all reactions on a comment
-- `fizzy reaction add <card_number> <comment_id> <emoji>` - Add a reaction to a comment
-- `fizzy reaction remove <card_number> <comment_id> <reaction_id>` - Remove a reaction from a comment
-
-#### Step Management
-
-- `fizzy step create <card_number> --content <text> [--completed]` - Create a new step on a card
-- `fizzy step update <card_number> <step_id> [--content <text>] [--completed]` - Update a step
-- `fizzy step delete <card_number> <step_id>` - Delete a step from a card
-
-#### Comment Management
-
-- `fizzy comment delete <card_number> <comment_id>` - Delete a comment from a card
-- `fizzy comment update <card_number> <comment_id> --body <text>` - Update a comment on a card
-
-### Improvements
-
-- Refactored API client logic into separate files for better organization
-- Enhanced card update command to use `Flags().Changed()` for better flag handling
-- Comprehensive test coverage for all new commands (168 tests total)
-
-## 0.5.0 - 2026-01-25
-
-### Features
-
-#### Comment Management
-
-- `fizzy comment list <card_number>` - List all comments on a card
-- `fizzy comment show <card_number> <comment_id>` - Display a specific comment
-- `fizzy comment add <card_number> <body>` - Create a new comment on a card
-
-### Fixes
-
-- Fixed error handling in notification read-all command
-- Removed global flag usage in some commands
-
-## 0.4.0 - 2026-01-19
-
-### Features
-
-#### Card Management
-
-- `fizzy card not-now <card_number>` - Move a card to "Not Now" status
-- `fizzy card untriage <card_number>` - Send a card back to triage
-- `fizzy card watch <card_number>` - Subscribe to card notifications
-- `fizzy card unwatch <card_number>` - Unsubscribe from card notifications
-- `fizzy card golden <card_number>` - Mark a card as golden
-- `fizzy card ungolden <card_number>` - Remove golden status from a card
-
-## 0.3.0 - 2026-01-11
-
-### Features
-
-#### Notification Management
-
-- `fizzy notification list` - List all notifications with optional filtering
-- `fizzy notification read <notification_id>` - Mark a notification as read and display it
-- `fizzy notification unread <notification_id>` - Mark a notification as unread
-- `fizzy notification read-all` - Mark all unread notifications as read
-
-#### Card Management
-
-- `fizzy card assign <card_number> <user_id>` - Assign or unassign a user to/from a card
-- `fizzy card triage <card_number> <column_id>` - Move a card from triage into a column
-
-## [0.2.1] - 2025-12-20
-
-### Fixes
-
-- NPM package publishing script
-
-## [0.2.0] - 2025-12-20
-
-### Features
-
-#### Card Management
-
-- `fizzy card update <card_number>` - Update card properties (title, description, status, tags)
-- `fizzy card delete <card_number>` - Delete a card permanently
-- `fizzy card close <card_number>` - Close an existing card (already existed, now documented)
-- `fizzy card reopen <card_number>` - Reopen a closed card (already existed, now documented)
-
-#### Account Management
-
-- `fizzy account list` - List all accounts you have access to
-
-#### Improvements
-
-- `fizzy board` without arguments now displays the currently selected board
-- Added `--version` flag to display CLI version
-- Fixed HTTP client leak in API requests
-- Updated API specification to latest version
-
-## [0.1.0] - 2025-12-16
-
-### Initial Release
-
-The first stable release of Fizzy CLI with core functionality for managing
-boards, cards, and columns.
-
-### Features
-
-#### Authentication
-
-- `fizzy login` - Authenticate with Fizzy API using access tokens
-
-#### Board Management
-
-- `fizzy board list` - List all boards
-- `fizzy board create` - Create a new board
-
-#### Card Management
-
-- `fizzy card list` - List all cards in the selected board
-- `fizzy card create` - Create a new card
-- `fizzy card show <card_id>` - Display details for a specific card
-
-#### Column Management
-
-- `fizzy column list` - List all columns in the selected board
-- `fizzy column create` - Create a new column
-
-#### Configuration
-
-- `fizzy use --board <name>` - Set the active board for subsequent commands
-- `fizzy use --account <slug>` - Set the active account for subsequent commands
-
-### Distribution
-
-- Multi-platform support (macOS, Linux, Windows)
-- Multi-architecture binaries (x64, arm64)
-- Distributed via NPM with automatic binary download on install

package/Makefile

@@ -1,43 +0,0 @@
-.PHONY: help dev-tools run build build-all clean test install sync-api-spec
-
-VERSION := $(shell grep '"version"' package.json | sed 's/.*"version": "\([^"]*\)".*/\1/')
-LDFLAGS := -ldflags="-X 'github.com/rogeriopvl/fizzy/cmd.Version=$(VERSION)'"
-
-help:
-	@echo 'Usage: make [target]'
-	@echo ''
-	@echo 'Available targets:'
-	@grep -E '^[a-zA-Z_-]+:' Makefile | sed 's/:.*//g' | sed 's/^/  /'
-
-dev-tools:
-	@echo "Installing development tools..."
-	go install gotest.tools/gotestsum@latest
-
-run:
-	go run .
-
-install:
-	go install $(LDFLAGS) .
-
-build:
-	go build $(LDFLAGS) -o bin/fizzy .
-
-build-all: clean
-	mkdir -p bin
-	GOOS=darwin GOARCH=amd64 go build $(LDFLAGS) -o bin/fizzy-darwin-amd64 .
-	GOOS=darwin GOARCH=arm64 go build $(LDFLAGS) -o bin/fizzy-darwin-arm64 .
-	GOOS=linux GOARCH=amd64 go build $(LDFLAGS) -o bin/fizzy-linux-amd64 .
-	GOOS=linux GOARCH=arm64 go build $(LDFLAGS) -o bin/fizzy-linux-arm64 .
-	GOOS=windows GOARCH=amd64 go build $(LDFLAGS) -o bin/fizzy-windows-amd64.exe .
-	@echo "Binaries built successfully in bin/"
-
-clean:
-	rm -rf bin/
-
-test:
-	gotestsum -- -v ./...
-
-sync-api-spec:
-	@mkdir -p docs
-	@curl -s https://raw.githubusercontent.com/basecamp/fizzy/main/docs/API.md -o docs/API.md
-	@echo "API spec synced to docs/API.md"

package/cmd/account.go

@@ -1,14 +0,0 @@
-// Package cmd
-package cmd
-
-import "github.com/spf13/cobra"
-
-var accountCmd = &cobra.Command{
-	Use:   "account",
-	Short: "Manage accounts",
-	Long:  `Manage accounts in Fizzy`,
-}
-
-func init() {
-	rootCmd.AddCommand(accountCmd)
-}

package/cmd/account_list.go

@@ -1,44 +0,0 @@
-package cmd
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/rogeriopvl/fizzy/internal/app"
-	"github.com/rogeriopvl/fizzy/internal/ui"
-	"github.com/spf13/cobra"
-)
-
-var accountListCmd = &cobra.Command{
-	Use:   "list",
-	Short: "List all accounts",
-	Long:  `Retrieve and display all accounts from Fizzy`,
-	Run: func(cmd *cobra.Command, args []string) {
-		if err := handleListAccounts(cmd); err != nil {
-			fmt.Fprintf(cmd.OutOrStderr(), "Error: %v\n", err)
-		}
-	},
-}
-
-func handleListAccounts(cmd *cobra.Command) error {
-	a := app.FromContext(cmd.Context())
-	if a == nil || a.Client == nil {
-		return fmt.Errorf("API client not available")
-	}
-
-	identity, err := a.Client.GetMyIdentity(context.Background())
-	if err != nil {
-		return fmt.Errorf("fetching accounts: %w", err)
-	}
-
-	if len(identity.Accounts) == 0 {
-		fmt.Println("No accounts found")
-		return nil
-	}
-
-	return ui.DisplayAccounts(identity.Accounts)
-}
-
-func init() {
-	accountCmd.AddCommand(accountListCmd)
-}

package/cmd/account_list_test.go

@@ -1,118 +0,0 @@
-package cmd
-
-import (
-	"context"
-	"encoding/json"
-	"net/http"
-	"net/http/httptest"
-	"testing"
-
-	"github.com/rogeriopvl/fizzy/internal/api"
-	"github.com/rogeriopvl/fizzy/internal/app"
-	"github.com/rogeriopvl/fizzy/internal/testutil"
-)
-
-func TestAccountListCommand(t *testing.T) {
-	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		if r.URL.Path != "/my/identity" {
-			t.Errorf("expected /my/identity, got %s", r.URL.Path)
-		}
-		if r.Method != http.MethodGet {
-			t.Errorf("expected GET, got %s", r.Method)
-		}
-
-		auth := r.Header.Get("Authorization")
-		if auth == "" {
-			t.Error("missing Authorization header")
-		}
-		if auth != "Bearer test-token" {
-			t.Errorf("expected Bearer test-token, got %s", auth)
-		}
-
-		w.Header().Set("Content-Type", "application/json")
-		response := api.GetMyIdentityResponse{
-			Accounts: []api.Account{
-				{
-					ID:        "account-123",
-					Name:      "Personal",
-					Slug:      "personal",
-					CreatedAt: "2025-01-01T00:00:00Z",
-				},
-				{
-					ID:        "account-456",
-					Name:      "Work",
-					Slug:      "work",
-					CreatedAt: "2025-01-02T00:00:00Z",
-				},
-			},
-		}
-		json.NewEncoder(w).Encode(response)
-	}))
-	defer server.Close()
-
-	client := testutil.NewTestClient(server.URL, "", "", "test-token")
-	testApp := &app.App{Client: client}
-
-	cmd := accountListCmd
-	cmd.SetContext(testApp.ToContext(context.Background()))
-
-	if err := handleListAccounts(cmd); err != nil {
-		t.Fatalf("handleListAccounts failed: %v", err)
-	}
-}
-
-func TestAccountListCommandNoAccounts(t *testing.T) {
-	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.Header().Set("Content-Type", "application/json")
-		response := api.GetMyIdentityResponse{Accounts: []api.Account{}}
-		json.NewEncoder(w).Encode(response)
-	}))
-	defer server.Close()
-
-	client := testutil.NewTestClient(server.URL, "", "", "test-token")
-	testApp := &app.App{Client: client}
-
-	cmd := accountListCmd
-	cmd.SetContext(testApp.ToContext(context.Background()))
-
-	if err := handleListAccounts(cmd); err != nil {
-		t.Fatalf("handleListAccounts failed: %v", err)
-	}
-}
-
-func TestAccountListCommandAPIError(t *testing.T) {
-	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(http.StatusInternalServerError)
-		w.Write([]byte("Internal Server Error"))
-	}))
-	defer server.Close()
-
-	client := testutil.NewTestClient(server.URL, "", "", "test-token")
-	testApp := &app.App{Client: client}
-
-	cmd := accountListCmd
-	cmd.SetContext(testApp.ToContext(context.Background()))
-
-	err := handleListAccounts(cmd)
-	if err == nil {
-		t.Errorf("expected error for API failure")
-	}
-	if err.Error() != "fetching accounts: unexpected status code 500: Internal Server Error" {
-		t.Errorf("expected API error, got %v", err)
-	}
-}
-
-func TestAccountListCommandNoClient(t *testing.T) {
-	testApp := &app.App{}
-
-	cmd := accountListCmd
-	cmd.SetContext(testApp.ToContext(context.Background()))
-
-	err := handleListAccounts(cmd)
-	if err == nil {
-		t.Errorf("expected error when client not available")
-	}
-	if err.Error() != "API client not available" {
-		t.Errorf("expected 'client not available' error, got %v", err)
-	}
-}

package/cmd/board.go

@@ -1,49 +0,0 @@
-// Package cmd
-package cmd
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/rogeriopvl/fizzy/internal/app"
-	"github.com/rogeriopvl/fizzy/internal/ui"
-	"github.com/spf13/cobra"
-)
-
-var boardCmd = &cobra.Command{
-	Use:   "board",
-	Short: "Show the currently selected board",
-	Long: `Display the name and ID of the currently selected board.
-
-Use subcommands to list, create, or manage boards:
-  fizzy board list      List all boards
-  fizzy board create    Create a new board`,
-	Run: func(cmd *cobra.Command, args []string) {
-		if err := handleShowBoard(cmd); err != nil {
-			fmt.Fprintf(cmd.OutOrStderr(), "Error: %v\n", err)
-		}
-	},
-}
-
-func handleShowBoard(cmd *cobra.Command) error {
-	a := app.FromContext(cmd.Context())
-	if a == nil || a.Client == nil {
-		return fmt.Errorf("API client not available")
-	}
-
-	if a.Config.SelectedBoard == "" {
-		return fmt.Errorf("no board selected")
-	}
-
-	board, err := a.Client.GetBoard(context.Background(), a.Config.SelectedBoard)
-	if err != nil {
-		return fmt.Errorf("fetching board: %w", err)
-	}
-
-	fmt.Fprintf(cmd.OutOrStdout(), "%s (%s)\n", board.Name, ui.DisplayID(board.ID))
-	return nil
-}
-
-func init() {
-	rootCmd.AddCommand(boardCmd)
-}

package/cmd/board_create.go

@@ -1,59 +0,0 @@
-package cmd
-
-import (
-	"context"
-	"fmt"
-
-	"github.com/rogeriopvl/fizzy/internal/api"
-	"github.com/rogeriopvl/fizzy/internal/app"
-	"github.com/spf13/cobra"
-)
-
-var boardCreateCmd = &cobra.Command{
-	Use:   "create",
-	Short: "Create a new board",
-	Long:  `Create a new board in Fizzy`,
-	Run: func(cmd *cobra.Command, args []string) {
-		if err := handleCreateBoard(cmd); err != nil {
-			fmt.Fprintf(cmd.OutOrStderr(), "Error: %v\n", err)
-		}
-	},
-}
-
-func handleCreateBoard(cmd *cobra.Command) error {
-	a := app.FromContext(cmd.Context())
-	if a == nil || a.Client == nil {
-		return fmt.Errorf("API client not available")
-	}
-
-	// Read flag values directly from command
-	name, _ := cmd.Flags().GetString("name")
-	allAccess, _ := cmd.Flags().GetBool("all-access")
-	autoPostponePeriod, _ := cmd.Flags().GetInt("auto-postpone-period")
-	publicDescription, _ := cmd.Flags().GetString("description")
-
-	payload := api.CreateBoardPayload{
-		Name:               name,
-		AllAccess:          allAccess,
-		AutoPostponePeriod: autoPostponePeriod,
-		PublicDescription:  publicDescription,
-	}
-
-	_, err := a.Client.PostBoards(context.Background(), payload)
-	if err != nil {
-		return fmt.Errorf("creating board: %w", err)
-	}
-
-	fmt.Fprintf(cmd.OutOrStdout(), "✓ Board '%s' created successfully\n", name)
-	return nil
-}
-
-func init() {
-	boardCreateCmd.Flags().StringP("name", "n", "", "Board name (required)")
-	boardCreateCmd.MarkFlagRequired("name")
-	boardCreateCmd.Flags().Bool("all-access", false, "Allow all access to the board")
-	boardCreateCmd.Flags().Int("auto-postpone-period", 0, "Auto postpone period in days")
-	boardCreateCmd.Flags().String("description", "", "Public description of the board")
-
-	boardCmd.AddCommand(boardCreateCmd)
-}