Skip to content

Align HEY integration with hey-cli v1.0 / hey-sdk 0.21 - #60

Closed
is2b007 wants to merge 1 commit into
mainfrom
cursor/align-hey-api-16e1
Closed

Align HEY integration with hey-cli v1.0 / hey-sdk 0.21#60
is2b007 wants to merge 1 commit into
mainfrom
cursor/align-hey-api-16e1

Conversation

@is2b007

@is2b007 is2b007 commented Aug 25, 2026

Copy link
Copy Markdown
Owner

Align Daybreak’s HEY client with the current hey-cli v1.0 / hey-sdk 0.21 API so existing features use the official paths and payloads instead of form/JSON fallbacks.

What changed

Calendar events. Writes now go to POST/PATCH /calendar/events.json as form data, with calendar_event[set_time_zone]=1 so zone names are not dropped (times were landing as UTC). Responses accept a JSON recording body or a redirect id. Recurring occurrences use /calendar/events/:id/occurrences/:date.json. Timeboxes PATCH an existing HEY event instead of delete-and-recreate.

Week timeline. Sync reads GET /calendar/weeks/:date.json first so recurring events expand into the week, then still supplements with per-calendar recordings.json for calendars the user has switched off in HEY. Occurrences are stored as {series_id}:{YYYY-MM-DD}.

Todos. Create sends a bare YYYY-MM-DD. Delete uses /calendar/todos/:id.json. New update_todo is used when a sometime task already has a mirrored id.

Time tracking. Start sends no body and treats 409 as “already running” (adopts GET /calendar/ongoing_time_track.json). Stop wraps { calendar_time_track: { ends_at, category_title } }.

Email boxes. Canonical paths: /laterbox.json, /asidebox.json, /trailbox.json. Pagination follows next_history_url or a same-origin Link: rel=next header. Email triage stays local.

Connect page. Official installer (curl -fsSL https://hey.com/install-cli | bash) and brew install --cask basecamp/tap/hey.

Out of scope

Remote email writes, ActionCable change feeds, habits/contacts/screener/compose.

Tests

Full suite: 146 runs, 0 failures.

Open in Web Open in Cursor 

Use the official calendar event form API (including set_time_zone),
week-period reads for expanded recurrences, date-only todo writes,
canonical email box paths, and time-track start/stop payloads.
Timeboxes now PATCH an existing HEY event instead of delete-and-recreate.

Co-authored-by: is2b007 <is2b007@users.noreply.github.com>
@vercel

vercel Bot commented Aug 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
daybreak Ready Ready Preview Aug 25, 2026 1:21am

@is2b007

is2b007 commented Aug 25, 2026

Copy link
Copy Markdown
Owner Author

Landed on main via #61, which already contained this HEY alignment plus the Basecamp review fixes. Closing instead of merging again so the same HEY commit is not replayed on top of the squash.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants