feat: add retry logic, concurrent fetching, and extended commands

Resilience:
- RetryTransport with circuit breaker for 429/5xx resilience
- Exponential backoff with jitter, respects Retry-After headers
- Circuit breaker auto-resets after 30s of successful requests

Performance:
- Concurrent gmail thread fetching (fixes N+1 query pattern)
- Bounded concurrency with semaphore (max 10 parallel)

New calendar commands:
- colors: list available event/calendar colors
- conflicts: check availability across calendars
- search: find events by text query
- time: show current time in multiple timezones

New gmail commands:
- autoforward: get/enable/disable auto-forwarding
- delegates: list/add/remove mail delegation
- filters: list/create/delete inbox filters
- forwarding: manage forwarding addresses
- sendas: manage send-as aliases
- vacation: get/enable/disable vacation responder
- batch: bulk operations (mark-read, archive, label, delete)
- watch: Pub/Sub push with webhook forwarding

New services:
- Sheets: read/write/append spreadsheet data
- Tasks: manage tasklists and tasks

Developer experience:
- Shell completion (bash, zsh, fish, powershell)
- version command with build info
- --debug flag for verbose logging
- lefthook for pre-commit hooks

Documentation:
- Expanded README with examples
- Gmail watch/Pub/Sub guide (docs/watch.md)
- Architecture spec (docs/spec.md)
- Release process (docs/RELEASING.md)

Author: salmonumbrella

.github/workflows/release.yml

@@ -4,6 +4,12 @@ on:
   push:
     tags:
       - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to (re)release (e.g. v0.1.0)"
+        required: true
+        type: string
 
 permissions:
   contents: write
@@ -12,21 +18,29 @@ jobs:
   goreleaser:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-go@v5
+      - name: Setup Go
+        uses: actions/setup-go@v5
         with:
           go-version-file: go.mod
           cache: true
 
-      - name: Run GoReleaser
+      - name: Stash GoReleaser config
+        run: cp .goreleaser.yaml /tmp/.goreleaser.yaml
+
+      - name: Checkout release tag
+        if: ${{ github.event_name == 'workflow_dispatch' }}
+        run: git checkout ${{ inputs.tag }}
+
+      - name: GoReleaser
         uses: goreleaser/goreleaser-action@v6
         with:
           distribution: goreleaser
-          version: "~> v2"
-          args: release --clean
+          version: latest
+          args: release --clean --config /tmp/.goreleaser.yaml
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}

.gitignore

@@ -36,6 +36,7 @@ go.work.sum
 
 # Local build output
 bin/
+/gog
 
 # Node (optional dev scripts)
 node_modules/

.goreleaser.yaml

@@ -1,11 +1,9 @@
-# yaml-language-server: $schema=https://goreleaser.com/static/schema.json
 version: 2
 
-project_name: gog-cli
+project_name: gogcli
 
-before:
-  hooks:
-    - go mod tidy
+changelog:
+  disable: true
 
 builds:
   - id: gog
@@ -14,55 +12,24 @@ builds:
     env:
       - CGO_ENABLED=0
     goos:
-      - linux
       - darwin
+      - linux
       - windows
     goarch:
       - amd64
       - arm64
-    ldflags:
-      - -s -w
-      - -X main.version={{.Version}}
-      - -X main.commit={{.ShortCommit}}
-      - -X main.date={{.Date}}
+    ignore:
+      - goos: windows
+        goarch: arm64
 
 archives:
-  - id: default
-    formats:
-      - tar.gz
+  - builds:
+      - gog
+    format: tar.gz
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
     format_overrides:
       - goos: windows
-        formats:
-          - zip
-    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
-    files:
-      - README.md
-      - LICENSE
+        format: zip
 
 checksum:
-  name_template: "checksums.txt"
-
-changelog:
-  sort: asc
-  filters:
-    exclude:
-      - "^docs:"
-      - "^test:"
-      - "^ci:"
-      - Merge pull request
-      - Merge branch
-
-brews:
-  - name: gog-cli
-    repository:
-      owner: salmonumbrella
-      name: homebrew-tap
-      token: "{{ .Env.HOMEBREW_TAP_TOKEN }}"
-    directory: Formula
-    homepage: "https://github.com/salmonumbrella/gog-cli"
-    description: "CLI for Google Workspace to manage Gmail, Calendar, and Drive"
-    license: "MIT"
-    install: |
-      bin.install "gog"
-    test: |
-      system "#{bin}/gog", "--help"
+  name_template: checksums.txt

CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+## 0.2.1 - Unreleased
+
+## 0.2.0 - 2025-12-24
+
+### Added
+
+- Gmail: watch + Pub/Sub push handler (`gog gmail watch start|status|renew|stop|serve`) with optional webhook forwarding, include-body, and max-bytes.
+- Gmail: history listing via `gog gmail history --since <historyId>`.
+- Gmail: HTML bodies for `gmail send` and `gmail drafts create` via `--body-html` (multipart/alternative when combined with `--body`, PR #16 — thanks @shanelindsay).
+- Gmail: `--reply-to-address` (sets `Reply-To` header, PR #16 — thanks @shanelindsay).
+- Tasks: manage tasklists and tasks (`lists`, `list`, `add`, `update`, `done`, `undo`, `delete`, `clear`, PR #10 — thanks @shanelindsay).
+### Changed
+
+- Build: `make` builds `./bin/gog` by default (adds `build` target, PR #12 — thanks @advait).
+- Docs: local build instructions now use `make` (PR #12 — thanks @advait).
+
+### Fixed
+
+- Secrets: keyring file-backend fallback now stores encrypted entries in `$(os.UserConfigDir())/gogcli/keyring/` and supports non-interactive via `GOG_KEYRING_PASSWORD` (PR #13 — thanks @advait).
+- Gmail: decode base64url attachment/message-part payloads (PR #15 — thanks @shanelindsay).
+- Auth: add `people` service (OIDC `profile` scope) so `gog people me` works with `gog auth add --services all`.
+
+## 0.1.1 - 2025-12-17
+
+### Added
+
+- Calendar: respond to invites via `gog calendar respond <calendarId> <eventId> --status accepted|declined|tentative` (optional `--send-updates`).
+- People: `gog people me` (quick “me card” / `people/me`).
+- Gmail: message get via `gog gmail get <messageId> [--format full|metadata|raw]`.
+- Gmail: download a single attachment via `gog gmail attachment <messageId> <attachmentId> [--out PATH]`.
+
+## 0.1.0 - 2025-12-12
+
+Initial public release of `gog`: a single Go CLI that unifies Gmail, Calendar, Drive, and Contacts (People API).
+
+### Added
+
+- Unified CLI (`gog`) with service subcommands: `gmail`, `calendar`, `drive`, `contacts`, plus `auth`.
+- OAuth setup and account management:
+  - Store OAuth client credentials: `gog auth credentials <credentials.json>`.
+  - Authorize accounts and store refresh tokens securely via OS keychain using `github.com/99designs/keyring`.
+  - List/remove accounts: `gog auth list`, `gog auth remove <email>`.
+  - Token management helpers: `gog auth tokens list|delete|export|import`.
+- Consistently parseable output:
+  - `--output=text` (tab-separated lists on stdout) and `--output=json` (JSON on stdout).
+  - Human hints/progress/errors go to stderr.
+- Colorized output in rich TTY (`--color=auto|always|never`), automatically disabled for JSON output.
+- Gmail features:
+  - Search threads, show thread, generate web URLs.
+  - Label listing/get (including counts) and thread label modify.
+  - Send mail (supports reply headers + attachments).
+  - Drafts: list/get/create/send/delete.
+- Calendar features:
+  - List calendars, list ACL rules.
+  - List/get/create/update/delete events and free/busy queries.
+- Drive features:
+  - List/search/get files, download (including Google Docs export), upload, mkdir, delete, move, rename.
+  - Sharing helpers: share/unshare/permissions, and web URL output.
+- Contacts / People API features:
+  - Contacts list/search/get/create/update/delete.
+  - “Other contacts” list/search.
+  - Workspace directory list/search (Workspace accounts only).
+- Developer experience:
+  - Formatting via `gofumpt` + `goimports` (and `gofmt` implicitly) using `make fmt` / `make fmt-check`.
+  - Linting via pinned `golangci-lint` with repo config.
+  - Tests using stdlib `testing` + `httptest`, with steadily increased unit coverage.
+  - GitHub Actions CI running format checks, tests, and lint.
+  - `pnpm gog` helper to build+run (`pnpm gog auth add you@gmail.com`).
+
+### Notes / Known Limitations
+
+- Importing tokens into macOS Keychain may require a local (GUI) session; headless/SSH sessions can fail due to Keychain user-interaction restrictions.
+- Workspace directory commands require a Google Workspace account; `@gmail.com` accounts will not work for directory endpoints.

Makefile

@@ -1,16 +1,23 @@
 SHELL := /bin/bash
 
-.PHONY: setup fmt fmt-check lint test ci tools
+# `make` should build the binary by default.
+.DEFAULT_GOAL := build
 
-setup:
-	@command -v lefthook >/dev/null || (echo "Install lefthook: brew install lefthook" && exit 1)
-	lefthook install
+.PHONY: build fmt fmt-check lint test ci tools
+
+BIN_DIR := $(CURDIR)/bin
+BIN := $(BIN_DIR)/gog
+CMD := ./cmd/gog
 
 TOOLS_DIR := $(CURDIR)/.tools
 GOFUMPT := $(TOOLS_DIR)/gofumpt
 GOIMPORTS := $(TOOLS_DIR)/goimports
 GOLANGCI_LINT := $(TOOLS_DIR)/golangci-lint
 
+build:
+	@mkdir -p $(BIN_DIR)
+	@go build -o $(BIN) $(CMD)
+
 tools:
 	@mkdir -p $(TOOLS_DIR)
 	@GOBIN=$(TOOLS_DIR) go install mvdan.cc/gofumpt@v0.9.2