fizzy-cli 0.8.0 → 1.0.0

package/.golangci.yml

@@ -0,0 +1,56 @@
+version: "2"
+linters:
+  enable:
+    - errorlint
+    - gocritic
+    - gosec
+    - misspell
+    - nilerr
+  settings:
+    errcheck:
+      check-type-assertions: false
+      exclude-functions:
+        - fmt.Fprintf
+        - fmt.Printf
+        - fmt.Print
+        - fmt.Fprintln
+        - fmt.Println
+        - (io.Writer).Write
+        - (*github.com/spf13/cobra.Command).MarkFlagRequired
+        - (*github.com/spf13/cobra.Command).ParseFlags
+        - (*encoding/json.Encoder).Encode
+        - encoding/json.Unmarshal
+    gocritic:
+      disabled-checks:
+        - singleCaseSwitch
+        - rangeValCopy
+        - commentedOutCode
+      enabled-tags:
+        - diagnostic
+        - performance
+    gosec:
+      excludes:
+        - G104
+        - G301
+        - G304
+  exclusions:
+    generated: lax
+    rules:
+      - linters:
+          - errcheck
+        source: defer.*Close\(\)
+    paths:
+      - .*_test\.go$
+      - third_party$
+      - builtin$
+      - examples$
+issues:
+  max-issues-per-linter: 0
+  max-same-issues: 0
+formatters:
+  exclusions:
+    generated: lax
+    paths:
+      - third_party$
+      - builtin$
+      - examples$

package/IMPLEMENTATION_PLAN.md

@@ -0,0 +1,58 @@
+# Fizzy CLI - Remaining Implementation Plan
+
+This document tracks features that are **not yet implemented**.
+
+---
+
+## 📋 Missing Features
+
+### Pins Management
+
+Card pinning for quick access:
+
+- [ ] `fizzy card pin <number>` - `POST /cards/:number/pin`
+- [ ] `fizzy card unpin <number>` - `DELETE /cards/:number/pin`
+- [ ] `fizzy pin list` - `GET /my/pins` - List all pinned cards
+
+### Advanced Features
+
+- [ ] **File uploads** - Support for card image uploads
+- [ ] **Rich text support** - HTML validation for description fields
+- [ ] **ETag caching** - `ETag`/`Cache-Control` header support for bandwidth optimization
+
+---
+
+## 📝 API Client Work Required
+
+### Pin Operations
+
+```go
+func (c *Client) PostCardPin(ctx context.Context, cardNumber int) (bool, error)
+func (c *Client) DeleteCardPin(ctx context.Context, cardNumber int) (bool, error)
+func (c *Client) GetMyPins(ctx context.Context) ([]Card, error)
+```
+
+---
+
+## 📊 Completion Status
+
+| Feature | Status |
+|---------|--------|
+| Authentication & Setup | ✅ Complete |
+| Accounts | ✅ Complete |
+| Boards (CRUD) | ✅ Complete |
+| Cards (CRUD + operations) | ✅ Complete |
+| Columns (CRUD) | ✅ Complete |
+| Tags | ✅ Complete |
+| Notifications | ✅ Complete |
+| Steps | ✅ Complete |
+| Comments | ✅ Complete |
+| Reactions (Comment & Card) | ✅ Complete |
+| Users | ✅ Complete |
+| Identity (whoami) | ✅ Complete |
+| Card Filtering & Search | ✅ Complete |
+| Pagination | ✅ Complete |
+| **Pins** | ⏳ Pending |
+| **File Uploads** | ⏳ Pending |
+| **Rich Text** | ⏳ Pending |
+| **ETag Caching** | ⏳ Pending |

package/docs/API.md

@@ -118,6 +118,22 @@ __Error responses:__
 | `401 Unauthorized` | Invalid `pending_authentication_token` or `code` |
 | `429 Too Many Requests` | Rate limit exceeded |
 
+
+#### Delete server-side session (_log out_)
+
+To log out and destroy the server-side session:
+
+```bash
+curl -X DELETE \
+  -H "Accept: application/json" \
+  -H "Cookie: session_token=eyJfcmFpbHMi..." \
+  https://app.fizzy.do/session
+```
+
+__Response:__
+
+Returns `204 No Content` on success.
+
 ## Caching
 
 Most endpoints return [ETag](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/ETag) and [Cache-Control](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control) headers. You can use these to avoid re-downloading unchanged data.
@@ -805,6 +821,79 @@ __Response:__
 
 Returns `204 No Content` on success.
 
+## Pins
+
+Pins let users keep quick access to important cards.
+
+### `POST /:account_slug/cards/:card_number/pin`
+
+Pins a card for the current user.
+
+__Response:__
+
+Returns `204 No Content` on success.
+
+### `DELETE /:account_slug/cards/:card_number/pin`
+
+Unpins a card for the current user.
+
+__Response:__
+
+Returns `204 No Content` on success.
+
+### `GET /my/pins`
+
+Returns the current user's pinned cards. This endpoint is not paginated and returns up to 100 cards.
+
+__Response:__
+
+```json
+[
+  {
+    "id": "03f5vaeq985jlvwv3arl4srq2",
+    "number": 1,
+    "title": "First!",
+    "status": "published",
+    "description": "Hello, World!",
+    "description_html": "<div class=\"action-text-content\"><p>Hello, World!</p></div>",
+    "image_url": null,
+    "tags": ["programming"],
+    "golden": false,
+    "last_active_at": "2025-12-05T19:38:48.553Z",
+    "created_at": "2025-12-05T19:38:48.540Z",
+    "url": "http://fizzy.localhost:3006/897362094/cards/4",
+    "board": {
+      "id": "03f5v9zkft4hj9qq0lsn9ohcm",
+      "name": "Fizzy",
+      "all_access": true,
+      "created_at": "2025-12-05T19:36:35.534Z",
+      "url": "http://fizzy.localhost:3006/897362094/boards/03f5v9zkft4hj9qq0lsn9ohcm",
+      "creator": {
+        "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",
+        "avatar_url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7/avatar"
+      }
+    },
+    "creator": {
+      "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",
+      "avatar_url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7/avatar"
+    },
+    "comments_url": "http://fizzy.localhost:3006/897362094/cards/4/comments"
+  }
+]
+```
+
 ## Comments
 
 Comments are attached to cards and support rich text.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fizzy-cli",
-  "version": "0.8.0",
+  "version": "1.0.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/.env

@@ -1 +0,0 @@
-FIZZY_ACCESS_TOKEN=S7FiVcT1K3WgwXc7uzBdQRim

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,194 +0,0 @@
-# Changelog
-
-## 0.8.0 - 2026-02-11
-
-### Features
-
-#### Card Management
-
-- `fizzy card list` now supports filtering by board, tags, assignees, creators, and closure status
-- Enhanced card listing with additional query parameters for better filtering capabilities
-
-#### Reaction Management
-
-- `fizzy reaction list <card_number>` - List all reactions on a card
-- `fizzy reaction create <card_number> <emoji>` - Add a reaction to a card
-- `fizzy reaction delete <card_number> <reaction_id>` - Remove a reaction from a card
-
-#### User Management
-
-- `fizzy user list` - List all users in the account
-- `fizzy user show <user_id>` - Display details for a specific user
-- `fizzy user update <user_id>` - Update user properties (name, avatar)
-- `fizzy user deactivate <user_id>` - Deactivate a user account
-
-### Improvements
-
-- Updated API specification to latest version
-
-## 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)
-}