fizzy-cli 0.1.0 → 0.2.0

package/go.mod

@@ -1,10 +1,31 @@
-module github.com/rogeriopvl/fizzy-cli
+module github.com/rogeriopvl/fizzy
 
 go 1.25.1
 
-require github.com/spf13/cobra v1.10.2
+require (
+	github.com/charmbracelet/bubbletea v1.3.10
+	github.com/spf13/cobra v1.10.2
+)
 
 require (
+	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
+	github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc // indirect
+	github.com/charmbracelet/lipgloss v1.1.0 // indirect
+	github.com/charmbracelet/x/ansi v0.10.1 // indirect
+	github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd // indirect
+	github.com/charmbracelet/x/term v0.2.1 // indirect
+	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
+	github.com/lucasb-eyer/go-colorful v1.2.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-localereader v0.0.1 // indirect
+	github.com/mattn/go-runewidth v0.0.16 // indirect
+	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
+	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/muesli/termenv v0.16.0 // indirect
+	github.com/rivo/uniseg v0.4.7 // indirect
 	github.com/spf13/pflag v1.0.9 // indirect
+	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
+	golang.org/x/sys v0.36.0 // indirect
+	golang.org/x/text v0.3.8 // indirect
 )

package/go.sum

@@ -1,10 +1,53 @@
+github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
+github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
+github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc h1:4pZI35227imm7yK2bGPcfpFEmuY1gc2YSTShr4iJBfs=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc/go.mod h1:X4/0JoqgTIPSFcRA/P6INZzIuyqdFY5rm8tb41s9okk=
+github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
+github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
+github.com/charmbracelet/x/ansi v0.10.1 h1:rL3Koar5XvX0pHGfovN03f5cxLbCF2YvLeyz7D2jVDQ=
+github.com/charmbracelet/x/ansi v0.10.1/go.mod h1:3RQDQ6lDnROptfpWuUVIUG64bD2g2BgntdxH0Ya5TeE=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd h1:vy0GVL4jeHEwG5YOXDmi86oYw2yuYUGqz6a8sLwg0X8=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd/go.mod h1:xe0nKWGd3eJgtqZRaN9RjMtK7xUYchjzPr7q6kcvCCs=
+github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ=
+github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg=
 github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
 github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
 github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
+github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY=
+github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
+github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
+github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
+github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
+github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
+github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
 github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU=
 github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4=
 github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
 github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
 go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561 h1:MDc5xs78ZrZr3HMQugiXOAkSZtfTpbJLDr/lwfgO53E=
+golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561/go.mod h1:cyybsKvd6eL0RnXn6p/Grxp8F5bW7iYuBgsNCOHpMYE=
+golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.36.0 h1:KVRy2GtZBrk1cBYA7MKu5bEZFxQk4NIDV6RLVcC8o0k=
+golang.org/x/sys v0.36.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.3.8 h1:nAL+RVCQ9uMn3vJZbV+MRnydTJFPf8qqY42YiA6MrqY=
+golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=

package/internal/api/client.go

@@ -0,0 +1,463 @@
+// Package api
+package api
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"os"
+	"time"
+
+	"github.com/rogeriopvl/fizzy/internal/colors"
+)
+
+type Client struct {
+	BaseURL        string
+	AccountBaseURL string
+	BoardBaseURL   string
+	AccessToken    string
+	HTTPClient     *http.Client
+}
+
+func NewClient(accountSlug string, boardID string) (*Client, error) {
+	baseURL := "https://app.fizzy.do"
+	accountBaseURL := baseURL + accountSlug
+
+	var boardBaseURL string
+	if boardID != "" {
+		boardBaseURL = accountBaseURL + "/boards" + "/" + boardID
+	}
+
+	token, isSet := os.LookupEnv("FIZZY_ACCESS_TOKEN")
+	if !isSet || token == "" {
+		return nil, fmt.Errorf("FIZZY_ACCESS_TOKEN environment variable is not set")
+	}
+
+	return &Client{
+		BaseURL:        baseURL,
+		AccountBaseURL: accountBaseURL,
+		BoardBaseURL:   boardBaseURL,
+		AccessToken:    token,
+		HTTPClient:     &http.Client{Timeout: 30 * time.Second},
+	}, nil
+}
+
+// newRequest makes an HTTP request with the required headers setup
+func (c *Client) newRequest(ctx context.Context, method, url string, body any) (*http.Request, error) {
+	var bodyReader io.Reader
+	if body != nil {
+		data, err := json.Marshal(body)
+		if err != nil {
+			return nil, fmt.Errorf("failed to marshal request body: %w", err)
+		}
+		bodyReader = bytes.NewReader(data)
+	}
+
+	req, err := http.NewRequestWithContext(ctx, method, url, bodyReader)
+	if err != nil {
+		return nil, err
+	}
+
+	req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", c.AccessToken))
+	req.Header.Set("Accept", "application/json")
+	req.Header.Set("Content-Type", "application/json")
+
+	return req, nil
+}
+
+// decodeResponse executes a request and decodes the JSON response into v
+// If expectedStatus is 0, it defaults to http.StatusOK
+// If v is nil, the response body is not decoded
+func (c *Client) decodeResponse(req *http.Request, v any, expectedStatus ...int) (int, error) {
+	expectedCode := http.StatusOK
+	if len(expectedStatus) > 0 {
+		expectedCode = expectedStatus[0]
+	}
+
+	res, err := c.HTTPClient.Do(req)
+	if err != nil {
+		return 0, fmt.Errorf("failed to make request: %w", err)
+	}
+	defer res.Body.Close()
+
+	if res.StatusCode != expectedCode {
+		body, _ := io.ReadAll(res.Body)
+		return 0, fmt.Errorf("unexpected status code %d: %s", res.StatusCode, string(body))
+	}
+
+	if v != nil {
+		if err := json.NewDecoder(res.Body).Decode(v); err != nil {
+			return 0, fmt.Errorf("failed to decode response: %w", err)
+		}
+	}
+
+	return res.StatusCode, nil
+}
+
+func (c *Client) GetBoards(ctx context.Context) ([]Board, error) {
+	endpointURL := c.AccountBaseURL + "/boards"
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create request: %w", err)
+	}
+
+	var response []Board
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return response, nil
+}
+
+func (c *Client) GetBoard(ctx context.Context, boardID string) (*Board, error) {
+	endpointURL := c.AccountBaseURL + "/boards/" + boardID
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create request: %w", err)
+	}
+
+	var response Board
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return &response, nil
+}
+
+func (c *Client) PostBoards(ctx context.Context, payload CreateBoardPayload) (bool, error) {
+	endpointURL := c.AccountBaseURL + "/boards"
+
+	body := map[string]CreateBoardPayload{"board": payload}
+
+	req, err := c.newRequest(ctx, http.MethodPost, endpointURL, body)
+	if err != nil {
+		return false, fmt.Errorf("failed to create board request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusCreated)
+	if err != nil {
+		return false, err
+	}
+
+	return true, nil
+}
+
+func (c *Client) GetColumns(ctx context.Context) ([]Column, error) {
+	if c.BoardBaseURL == "" {
+		return nil, fmt.Errorf("please select a board first with 'fizzy use --board <board_name>'")
+	}
+
+	endpointURL := c.BoardBaseURL + "/columns"
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create get columns request: %w", err)
+	}
+
+	var response []Column
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return response, nil
+}
+
+func (c *Client) PostColumns(ctx context.Context, payload CreateColumnPayload) (bool, error) {
+	if c.BoardBaseURL == "" {
+		return false, fmt.Errorf("please select a board first with 'fizzy use --board <board_name>'")
+	}
+
+	endpointURL := c.BoardBaseURL + "/columns"
+
+	body := map[string]CreateColumnPayload{"column": payload}
+
+	req, err := c.newRequest(ctx, http.MethodPost, endpointURL, body)
+	if err != nil {
+		return false, fmt.Errorf("failed to create column request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusCreated)
+	if err != nil {
+		return false, err
+	}
+
+	return true, nil
+}
+
+func (c *Client) GetCards(ctx context.Context, filters CardFilters) ([]Card, error) {
+	endpointURL := c.AccountBaseURL + "/cards"
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create get cards request: %w", err)
+	}
+
+	if len(filters.BoardIDs) > 0 {
+		q := req.URL.Query()
+		for _, boardID := range filters.BoardIDs {
+			q.Add("board_ids[]", boardID)
+		}
+		req.URL.RawQuery = q.Encode()
+	}
+
+	var response []Card
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return response, nil
+}
+
+func (c *Client) GetCard(ctx context.Context, cardNumber int) (*Card, error) {
+	endpointURL := fmt.Sprintf("%s/cards/%d", c.AccountBaseURL, cardNumber)
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create get card by id request: %w", err)
+	}
+
+	var response Card
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return &response, nil
+}
+
+func (c *Client) PostCards(ctx context.Context, payload CreateCardPayload) (bool, error) {
+	if c.BoardBaseURL == "" {
+		return false, fmt.Errorf("please select a board first with 'fizzy use --board <board_name>'")
+	}
+
+	endpointURL := c.BoardBaseURL + "/cards"
+
+	body := map[string]CreateCardPayload{"card": payload}
+
+	req, err := c.newRequest(ctx, http.MethodPost, endpointURL, body)
+	if err != nil {
+		return false, fmt.Errorf("failed to create card request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusCreated)
+	if err != nil {
+		return false, err
+	}
+
+	return true, nil
+}
+
+func (c *Client) PutCard(ctx context.Context, cardNumber int, payload UpdateCardPayload) (*Card, error) {
+	endpointURL := fmt.Sprintf("%s/cards/%d", c.AccountBaseURL, cardNumber)
+
+	body := map[string]UpdateCardPayload{"card": payload}
+
+	req, err := c.newRequest(ctx, http.MethodPut, endpointURL, body)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create update card request: %w", err)
+	}
+
+	var response Card
+	_, err = c.decodeResponse(req, &response, http.StatusOK)
+	if err != nil {
+		return nil, err
+	}
+
+	return &response, nil
+}
+
+func (c *Client) DeleteCard(ctx context.Context, cardNumber int) (bool, error) {
+	endpointURL := fmt.Sprintf("%s/cards/%d", c.AccountBaseURL, cardNumber)
+
+	req, err := c.newRequest(ctx, http.MethodDelete, endpointURL, nil)
+	if err != nil {
+		return false, fmt.Errorf("failed to create delete card request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return false, err
+	}
+
+	return true, nil
+}
+
+func (c *Client) PostCardsClosure(ctx context.Context, cardNumber int) (bool, error) {
+	endpointURL := fmt.Sprintf("%s/cards/%d/closure", c.AccountBaseURL, cardNumber)
+
+	req, err := c.newRequest(ctx, http.MethodPost, endpointURL, nil)
+	if err != nil {
+		return false, fmt.Errorf("failed to create closure card request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return false, err
+	}
+
+	return true, nil
+}
+
+func (c *Client) DeleteCardsClosure(ctx context.Context, cardNumber int) (bool, error) {
+	endpointURL := fmt.Sprintf("%s/cards/%d/closure", c.AccountBaseURL, cardNumber)
+
+	req, err := c.newRequest(ctx, http.MethodDelete, endpointURL, nil)
+	if err != nil {
+		return false, fmt.Errorf("failed to create delete closure card request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return false, err
+	}
+
+	return true, nil
+}
+
+func (c *Client) GetMyIdentity(ctx context.Context) (*GetMyIdentityResponse, error) {
+	endpointURL := c.BaseURL + "/my/identity"
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create request: %w", err)
+	}
+
+	var response GetMyIdentityResponse
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return &response, nil
+}
+
+type Board struct {
+	ID        string `json:"id"`
+	Name      string `json:"name"`
+	AllAccess bool   `json:"all_access"`
+	CreatedAt string `json:"created_at"`
+	URL       string `json:"url"`
+	Creator   User   `json:"creator"`
+}
+
+type CreateBoardPayload struct {
+	Name               string `json:"name"`
+	AllAccess          bool   `json:"all_access"`
+	AutoPostponePeriod int    `json:"auto_postpone_period"`
+	PublicDescription  string `json:"public_description"`
+}
+
+type Column struct {
+	ID        string      `json:"id"`
+	Name      string      `json:"name"`
+	Color     ColorObject `json:"color"`
+	CreatedAt string      `json:"created_at"`
+}
+
+type ColorObject struct {
+	Name  string `json:"name"`
+	Value Color  `json:"value"`
+}
+
+type CreateColumnPayload struct {
+	Name  string `json:"name"`
+	Color *Color `json:"color,omitempty"`
+}
+
+type Card struct {
+	ID              string   `json:"id"`
+	Number          int      `json:"number"`
+	Title           string   `json:"title"`
+	Status          string   `json:"status"`
+	Description     string   `json:"description"`
+	DescriptionHTML string   `json:"description_html"`
+	ImageURL        string   `json:"image_url"`
+	Tags            []string `json:"tags"`
+	Golden          bool     `json:"golden"`
+	LastActiveAt    string   `json:"last_active_at"`
+	CreatedAt       string   `json:"created_at"`
+	URL             string   `json:"url"`
+	Board           Board    `json:"board"`
+	Creator         User     `json:"creator"`
+	CommentsURL     string   `json:"comments_url"`
+}
+
+type CardFilters struct {
+	BoardIDs         []string
+	TagIDs           []string
+	AssigneeIDs      []string
+	CreatorIDs       []string
+	CloserIDs        []string
+	CardIDs          []string
+	IndexedBy        string
+	SortedBy         string
+	AssignmentStatus string
+	CreationStatus   string
+	ClosureStatus    string
+	Terms            []string
+}
+
+type CreateCardPayload struct {
+	Title        string   `json:"title"`
+	Description  string   `json:"description,omitempty"`
+	Status       string   `json:"status,omitempty"`
+	ImageURL     string   `json:"image_url,omitempty"`
+	TagIDS       []string `json:"tag_ids,omitempty"`
+	CreatedAt    string   `json:"created_at,omitempty"`
+	LastActiveAt string   `json:"last_active_at,omitempty"`
+}
+
+// UpdateCardPayload image not included because we don't support files yet
+type UpdateCardPayload struct {
+	Title        string   `json:"title,omitempty"`
+	Description  string   `json:"description,omitempty"`
+	Status       string   `json:"status,omitempty"`
+	TagIDS       []string `json:"tag_ids,omitempty"`
+	LastActiveAt string   `json:"last_active_at,omitempty"`
+}
+
+type GetMyIdentityResponse struct {
+	Accounts []Account `json:"accounts"`
+}
+
+type Account struct {
+	ID        string `json:"id"`
+	Name      string `json:"name"`
+	User      User   `json:"user"`
+	Slug      string `json:"slug"`
+	CreatedAt string `json:"created_at"`
+}
+
+type User struct {
+	ID        string `json:"id"`
+	Email     string `json:"email_address"`
+	Role      string `json:"role"`
+	Active    bool   `json:"active"`
+	Name      string `json:"name"`
+	CreatedAt string `json:"created_at"`
+	URL       string `json:"url"`
+}
+
+type Color string
+
+// Color constants using centralized definitions
+var (
+	Blue   Color = Color(colors.Blue.CSSValue)
+	Gray   Color = Color(colors.Gray.CSSValue)
+	Tan    Color = Color(colors.Tan.CSSValue)
+	Yellow Color = Color(colors.Yellow.CSSValue)
+	Lime   Color = Color(colors.Lime.CSSValue)
+	Aqua   Color = Color(colors.Aqua.CSSValue)
+	Violet Color = Color(colors.Violet.CSSValue)
+	Purple Color = Color(colors.Purple.CSSValue)
+	Pink   Color = Color(colors.Pink.CSSValue)
+)

package/internal/app/app.go

@@ -0,0 +1,49 @@
+// Package app
+package app
+
+import (
+	"context"
+	"fmt"
+	"os"
+
+	"github.com/rogeriopvl/fizzy/internal/api"
+	"github.com/rogeriopvl/fizzy/internal/config"
+)
+
+type App struct {
+	Client *api.Client
+	Config *config.Config
+}
+
+func New() (*App, error) {
+	cfg, err := config.Load()
+	if err != nil {
+		return nil, fmt.Errorf("loading config: %w", err)
+	}
+
+	token, isSet := os.LookupEnv("FIZZY_ACCESS_TOKEN")
+	if !isSet || token == "" {
+		return &App{Config: cfg}, nil // No token set, app will handle gracefully
+	}
+
+	client, err := api.NewClient(cfg.SelectedAccount, cfg.SelectedBoard)
+	if err != nil {
+		return nil, fmt.Errorf("creating API client: %w", err)
+	}
+
+	return &App{Client: client, Config: cfg}, nil
+}
+
+// contextKey is a type for context keys to avoid collisions.
+type contextKey string
+
+const appContextKey contextKey = "app"
+
+func FromContext(ctx context.Context) *App {
+	app, _ := ctx.Value(appContextKey).(*App)
+	return app
+}
+
+func (a *App) ToContext(ctx context.Context) context.Context {
+	return context.WithValue(ctx, appContextKey, a)
+}

package/internal/colors/colors.go

@@ -0,0 +1,32 @@
+package colors
+
+import "github.com/charmbracelet/lipgloss"
+
+type ColorDef struct {
+	Name      string
+	CSSValue  string
+	TermColor lipgloss.Color
+}
+
+var (
+	Blue   = ColorDef{"Blue", "var(--color-card-default)", lipgloss.Color("12")}
+	Gray   = ColorDef{"Gray", "var(--color-card-1)", lipgloss.Color("8")}
+	Tan    = ColorDef{"Tan", "var(--color-card-2)", lipgloss.Color("180")}
+	Yellow = ColorDef{"Yellow", "var(--color-card-3)", lipgloss.Color("11")}
+	Lime   = ColorDef{"Lime", "var(--color-card-4)", lipgloss.Color("10")}
+	Aqua   = ColorDef{"Aqua", "var(--color-card-5)", lipgloss.Color("14")}
+	Violet = ColorDef{"Violet", "var(--color-card-6)", lipgloss.Color("177")}
+	Purple = ColorDef{"Purple", "var(--color-card-7)", lipgloss.Color("135")}
+	Pink   = ColorDef{"Pink", "var(--color-card-8)", lipgloss.Color("205")}
+)
+
+var All = []ColorDef{Blue, Gray, Tan, Yellow, Lime, Aqua, Violet, Purple, Pink}
+
+func ByName(name string) *ColorDef {
+	for _, c := range All {
+		if c.Name == name {
+			return &c
+		}
+	}
+	return nil
+}

package/internal/config/config.go

@@ -0,0 +1,69 @@
+// Package config
+package config
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+	"path/filepath"
+)
+
+const (
+	configDir  = ".config/fizzy-cli"
+	configFile = "config.json"
+)
+
+type Config struct {
+	SelectedAccount string `json:"selected_account"`
+	SelectedBoard   string `json:"selected_board"`
+}
+
+// Load reads the config file from $HOME/.config/fizzy-cli/config.json.
+func Load() (*Config, error) {
+	homeDir, err := os.UserHomeDir()
+	if err != nil {
+		return nil, fmt.Errorf("getting home directory: %w", err)
+	}
+
+	configPath := filepath.Join(homeDir, configDir, configFile)
+
+	data, err := os.ReadFile(configPath)
+	if err != nil {
+		if os.IsNotExist(err) {
+			return &Config{}, nil
+		}
+		return nil, fmt.Errorf("reading config file: %w", err)
+	}
+
+	var config Config
+	if err := json.Unmarshal(data, &config); err != nil {
+		return nil, fmt.Errorf("parsing config file: %w", err)
+	}
+
+	return &config, nil
+}
+
+func (c *Config) Save() error {
+	homeDir, err := os.UserHomeDir()
+	if err != nil {
+		return fmt.Errorf("getting home directory: %w", err)
+	}
+
+	configDirPath := filepath.Join(homeDir, configDir)
+	if err := os.MkdirAll(configDirPath, 0o755); err != nil {
+		return fmt.Errorf("creating config directory: %w", err)
+	}
+
+	configPath := filepath.Join(configDirPath, configFile)
+
+	data, err := json.MarshalIndent(c, "", "  ")
+	if err != nil {
+		return fmt.Errorf("marshaling config: %w", err)
+	}
+
+	if err := os.WriteFile(configPath, data, 0o644); err != nil {
+		return fmt.Errorf("writing config file: %w", err)
+	}
+
+	return nil
+}