Feature: Support for event availability (free/busy)

[Aurelian-Shuttleworth]

Summary

Add a new --availability flag to the add command in gcalcli. This flag allows users to explicitly set an event as "Free" or "Busy" during creation.

Why

Currently, gcalcli does not expose the "transparency" (free/busy) field of Google Calendar events. This prevents users from creating "Ghost Blocks" — events that appear on their calendar for planning purposes but do not block their availability for scheduling tools.

Proposed Solution

• Flag: --availability
• Options: free, busy (Default: busy)
• Behavior:
  • free maps to API transparency='transparent'
  • busy maps to API transparency='opaque'
• CLI Standard: Use UI-friendly terms ("availability", "free", "busy") rather than API jargon ("transparency", "opaque"), consistent with other gcalcli arguments like --title and --where.

Verification

• Users should be able to run gcalcli add --availability free and see the event as "Free" in the Google Calendar UI.

Related Issues

• Relates to Set availability when creating an event #619