Skip to content

feat(bubble-up): add bubble-up add/remove commands #677

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jeremy merged 11 commits into from
Sep 2, 2026
Merged

feat(bubble-up): add bubble-up add/remove commands #677

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
0b3060c
feat(bubble-up): add bubble-up add/remove commands
jeremy Sep 2, 2026
a6b181f
Refresh SDK pin to bubble-up head and clear dependency advisories
jeremy Sep 2, 2026
66a3cc1
Sync vendored MCP model provenance to the pinned SDK head
jeremy Sep 2, 2026
096058c
bubble-up: validate --at, fix immediate-vs-scheduled reporting, docs
jeremy Sep 2, 2026
cf5cfdb
bubble-up: pin --at to calendar-date granularity; coverage/skill tidy…
jeremy Sep 2, 2026
6bc6000
Bump basecamp-sdk to the merged bubble-up support (#839)
jeremy Sep 2, 2026
59f46a0
Sync SDK provenance and Nix vendorHash to the pinned bubble-up head
jeremy Sep 2, 2026
ba6ee1a
bubble-up: report the requested action; project star toggle tracks St…
jeremy Sep 2, 2026
b6de9db
Star-labeled project surfaces track Starred, not Bookmarked
jeremy Sep 2, 2026
afae178
bubble-up docs: name the accepted --at date form; keep bookmark copy …
jeremy Sep 2, 2026
b8d69c0
Test the project star toggle exercises the star field and /star.json
jeremy Sep 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 72 additions & 0 deletions .surface
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,8 @@ ARG basecamp boosts create 01 <content>
ARG basecamp boosts delete 00 <boost-id|url>
ARG basecamp boosts list 00 <id|url>
ARG basecamp boosts show 00 <boost-id|url>
ARG basecamp bubble-up add 00 <id|url>
ARG basecamp bubble-up remove 00 <id|url>
ARG basecamp calendars show 00 <id|url>
ARG basecamp calendars update 00 <id|url>
ARG basecamp calendars update 01 <color>
Expand Down Expand Up @@ -536,6 +538,9 @@ CMD basecamp boosts create
CMD basecamp boosts delete
CMD basecamp boosts list
CMD basecamp boosts show
CMD basecamp bubble-up
CMD basecamp bubble-up add
CMD basecamp bubble-up remove
CMD basecamp calendars
CMD basecamp calendars show
CMD basecamp calendars update
Expand Down Expand Up @@ -2483,6 +2488,70 @@ FLAG basecamp boosts show --stats type=bool
FLAG basecamp boosts show --styled type=bool
FLAG basecamp boosts show --todolist type=string
FLAG basecamp boosts show --verbose type=count
FLAG basecamp bubble-up --account type=string
FLAG basecamp bubble-up --agent type=bool
FLAG basecamp bubble-up --cache-dir type=string
FLAG basecamp bubble-up --count type=bool
FLAG basecamp bubble-up --help type=bool
FLAG basecamp bubble-up --hints type=bool
FLAG basecamp bubble-up --ids-only type=bool
FLAG basecamp bubble-up --in type=string
FLAG basecamp bubble-up --jq type=string
FLAG basecamp bubble-up --json type=bool
FLAG basecamp bubble-up --markdown type=bool
FLAG basecamp bubble-up --md type=bool
FLAG basecamp bubble-up --no-hints type=bool
FLAG basecamp bubble-up --no-stats type=bool
FLAG basecamp bubble-up --profile type=string
FLAG basecamp bubble-up --project type=string
FLAG basecamp bubble-up --quiet type=bool
FLAG basecamp bubble-up --stats type=bool
FLAG basecamp bubble-up --styled type=bool
FLAG basecamp bubble-up --todolist type=string
FLAG basecamp bubble-up --verbose type=count
FLAG basecamp bubble-up add --account type=string
FLAG basecamp bubble-up add --agent type=bool
FLAG basecamp bubble-up add --at type=string
FLAG basecamp bubble-up add --cache-dir type=string
FLAG basecamp bubble-up add --count type=bool
FLAG basecamp bubble-up add --help type=bool
FLAG basecamp bubble-up add --hints type=bool
FLAG basecamp bubble-up add --ids-only type=bool
FLAG basecamp bubble-up add --in type=string
FLAG basecamp bubble-up add --jq type=string
FLAG basecamp bubble-up add --json type=bool
FLAG basecamp bubble-up add --markdown type=bool
FLAG basecamp bubble-up add --md type=bool
FLAG basecamp bubble-up add --no-hints type=bool
FLAG basecamp bubble-up add --no-stats type=bool
FLAG basecamp bubble-up add --profile type=string
FLAG basecamp bubble-up add --project type=string
FLAG basecamp bubble-up add --quiet type=bool
FLAG basecamp bubble-up add --stats type=bool
FLAG basecamp bubble-up add --styled type=bool
FLAG basecamp bubble-up add --todolist type=string
FLAG basecamp bubble-up add --verbose type=count
FLAG basecamp bubble-up remove --account type=string
FLAG basecamp bubble-up remove --agent type=bool
FLAG basecamp bubble-up remove --cache-dir type=string
FLAG basecamp bubble-up remove --count type=bool
FLAG basecamp bubble-up remove --help type=bool
FLAG basecamp bubble-up remove --hints type=bool
FLAG basecamp bubble-up remove --ids-only type=bool
FLAG basecamp bubble-up remove --in type=string
FLAG basecamp bubble-up remove --jq type=string
FLAG basecamp bubble-up remove --json type=bool
FLAG basecamp bubble-up remove --markdown type=bool
FLAG basecamp bubble-up remove --md type=bool
FLAG basecamp bubble-up remove --no-hints type=bool
FLAG basecamp bubble-up remove --no-stats type=bool
FLAG basecamp bubble-up remove --profile type=string
FLAG basecamp bubble-up remove --project type=string
FLAG basecamp bubble-up remove --quiet type=bool
FLAG basecamp bubble-up remove --stats type=bool
FLAG basecamp bubble-up remove --styled type=bool
FLAG basecamp bubble-up remove --todolist type=string
FLAG basecamp bubble-up remove --verbose type=count
FLAG basecamp calendars --account type=string
FLAG basecamp calendars --agent type=bool
FLAG basecamp calendars --cache-dir type=string
Expand Down Expand Up @@ -17826,6 +17895,9 @@ SUB basecamp boosts create
SUB basecamp boosts delete
SUB basecamp boosts list
SUB basecamp boosts show
SUB basecamp bubble-up
SUB basecamp bubble-up add
SUB basecamp bubble-up remove
SUB basecamp calendars
SUB basecamp calendars show
SUB basecamp calendars update
Expand Down
13 changes: 7 additions & 6 deletions API-COVERAGE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,12 @@ Coverage of Basecamp 3 API endpoints. Source: [bc3-api/sections](https://github.

| Status | Sections | Endpoints |
|--------|----------|-----------|
| ✅ Implemented | 50 | 184 |
| ✅ Implemented | 50 | 186 |
| ⚠️ Blocked | 0 | 0 |
| ⏭️ Out of scope | 4 | 12 |
| **Total tracked** | **54** | **196** |
| **Total tracked** | **54** | **198** |

**184 of 184 tracked in-scope endpoints.** The last gap — `GET
**186 of 186 tracked in-scope endpoints.** The last gap — `GET
/uploads/:id/versions.json` — closed with the v0.14.0 SDK bump. The command
(`files versions`) was written earlier but held: the SDK's
`UploadsService.ListVersions` decoded the response as `[]Upload` when the API
Expand Down Expand Up @@ -43,8 +43,9 @@ Out-of-scope sections are excluded from parity totals and scripts: chatbots (dif

> Note: the per-row `Endpoints` column in the Coverage by Section table sums higher than the Summary totals above. The discrepancy predates the BC5 baseline; the row count (48 sections) is authoritative for the `Since` column. Reconciling endpoint counts is pre-existing maintenance, tracked separately.

**SDK version:** v0.15.0 (`internal/version/sdk-provenance.json` is
authoritative). The command surface below largely dates to the v0.12.0 bump,
**SDK version:** v0.15.1 (adds Bubble Up write support; pinned to the
Comment thread
cubic-dev-ai[bot] marked this conversation as resolved.
pre-release bubble-up SDK head until the v0.15.1 tag —
`internal/version/sdk-provenance.json` is authoritative). The command surface below largely dates to the v0.12.0 bump,
Comment thread
Copilot marked this conversation as resolved.
which added 20 exported Go methods over 13 new backend operations; the extra
seven wrapped endpoints that already existed but were reachable only through
the raw generated client, which the andon-cord rule forbids the CLI from
Expand Down Expand Up @@ -197,7 +198,7 @@ cannot faithfully cover at least one endpoint for a reason outside the CLI. A
| comments | 8 | `comment`, `comments` | ✅ | BC4 | - | list, show, thread, create, update. @mentions in content. `show` surfaces `reply_target` + paste-ready `mention` from its single Get (no new calls). `thread` composes Get + parent recording (via type endpoint) + List into a deterministic reply-ready context (no new endpoints) |
| boosts | 6 | `boost`, `react` | ✅ | BC4 | - | list (recording + event), show, create (recording + event), delete. No account-wide listing — BC5 withdrew `/boosts.json` (basecamp/bc3#12464); temporary, returns via basecamp/bc3#12463 |
| notifications | 2 | `notifications` | ✅ | BC4 | - | list, mark as read (BC5: `bubble_ups`/`scheduled_bubble_ups` sections; `memories` is BC4-only) |
| bubble_ups | 1 | `notifications bubbleups` | ✅ | BC5 | - | Dedicated Bubble Ups list (`GET /my/readings/bubble_ups.json`, paginated) plus the `limit_bubble_ups` variant behind `notifications list --limit-bubble-ups` |
| bubble_ups | 3 | `bubble-up`, `notifications bubbleups` | ✅ | BC5 | - | `bubble-up add`/`remove` create and delete a per-recording bubble-up (`POST`/`DELETE /recordings/{id}/bubble_up.json`); `add --at` schedules. Dedicated list is `notifications bubbleups` (`GET /my/readings/bubble_ups.json`, paginated) plus the `limit_bubble_ups` variant behind `notifications list --limit-bubble-ups`. Per-recording GET is an unrenderable API gap, so there is no `check`. |
Comment thread
jeremy marked this conversation as resolved.
Comment thread
jeremy marked this conversation as resolved.
| **Cards (Kanban)** |
| card_tables | 3 | `cards` | ✅ | BC4 | - | Accessed via project dock |
| card_table_cards | 9 | `cards` | ✅ | BC4 | - | list, show, create, update, move |
Expand Down
10 changes: 5 additions & 5 deletions go.mod
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ require (
charm.land/bubbles/v2 v2.2.1
charm.land/bubbletea/v2 v2.0.9
charm.land/lipgloss/v2 v2.0.6
github.com/basecamp/basecamp-sdk/go v0.15.0
github.com/basecamp/basecamp-sdk/go v0.15.1-0.20260902205921-f439f493caf2
Comment thread
jeremy marked this conversation as resolved.
github.com/basecamp/cli v0.2.2-0.20260828230226-767413fc712d
github.com/basecamp/mcp v0.0.0-20260828100356-2d6f44b51e9d
github.com/basecamp/surfguard/go v0.1.0
Expand Down Expand Up @@ -108,7 +108,7 @@ require (
github.com/muesli/cancelreader v0.2.2 // indirect
github.com/muesli/reflow v0.3.0 // indirect
github.com/muesli/termenv v0.16.0 // indirect
github.com/oapi-codegen/runtime v1.6.0 // indirect
github.com/oapi-codegen/runtime v1.7.0 // indirect
github.com/oklog/ulid/v2 v2.1.1 // indirect
github.com/opencontainers/go-digest v1.0.0 // indirect
github.com/pkg/errors v0.9.1 // indirect
Expand All @@ -130,9 +130,9 @@ require (
github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 // indirect
github.com/yuin/goldmark-emoji v1.0.6 // indirect
go.opentelemetry.io/auto/sdk v1.2.1 // indirect
go.opentelemetry.io/otel v1.45.0 // indirect
go.opentelemetry.io/otel/metric v1.45.0 // indirect
go.opentelemetry.io/otel/trace v1.45.0 // indirect
go.opentelemetry.io/otel v1.46.0 // indirect
go.opentelemetry.io/otel/metric v1.46.0 // indirect
go.opentelemetry.io/otel/trace v1.46.0 // indirect
go.yaml.in/yaml/v3 v3.0.5 // indirect
golang.org/x/crypto v0.55.0 // indirect
golang.org/x/oauth2 v0.36.0 // indirect
Expand Down
24 changes: 12 additions & 12 deletions go.sum
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -87,8 +87,8 @@ github.com/aymanbagabas/go-udiff v0.4.1 h1:OEIrQ8maEeDBXQDoGCbbTTXYJMYRCRO1fnodZ
github.com/aymanbagabas/go-udiff v0.4.1/go.mod h1:0L9PGwj20lrtmEMeyw4WKJ/TMyDtvAoK9bf2u/mNo3w=
github.com/aymerick/douceur v0.2.0 h1:Mv+mAeH1Q+n9Fr+oyamOlAkUNPWPlA8PPGR0QAaYuPk=
github.com/aymerick/douceur v0.2.0/go.mod h1:wlT5vV2O3h55X9m7iVYN0TBM0NH/MmbLnd30/FjWUq4=
github.com/basecamp/basecamp-sdk/go v0.15.0 h1:Yxp3WM7rZ7PDcXrOTc4dI9EFOqwHojpqVJ/zbdXnoVg=
github.com/basecamp/basecamp-sdk/go v0.15.0/go.mod h1:00mgcmi89PlnHnLJNwcJjwryo4W5bYJtA2FoqVgHP54=
github.com/basecamp/basecamp-sdk/go v0.15.1-0.20260902205921-f439f493caf2 h1:bIaTwvIoWTNirPigLsXsC912abkIYDTFHuOrkSyB96U=
github.com/basecamp/basecamp-sdk/go v0.15.1-0.20260902205921-f439f493caf2/go.mod h1:Cs9DV8iRJaVT4+IQXGZTeyG2nQAV2kQda7GHuBOeonY=
github.com/basecamp/cli v0.2.2-0.20260828230226-767413fc712d h1:jAzDrCCzDpIwhbFT1xVVs0z2xpXoDEkomHfKB2bUUp8=
github.com/basecamp/cli v0.2.2-0.20260828230226-767413fc712d/go.mod h1:iTBTaWvsPEFIcZfkxQHEfISyJ6sZ7036K6bNx0RY3EE=
github.com/basecamp/mcp v0.0.0-20260828100356-2d6f44b51e9d h1:zEQVGq1x1nhKMZ2TudFAcSJ32CHT8richI1vQakIKz4=
Expand Down Expand Up @@ -348,8 +348,8 @@ github.com/natefinch/atomic v1.0.1 h1:ZPYKxkqQOx3KZ+RsbnP/YsgvxWQPGxjC0oBt2AhwV0
github.com/natefinch/atomic v1.0.1/go.mod h1:N/D/ELrljoqDyT3rZrsUmtsuzvHkeB/wWjHV22AZRbM=
github.com/oapi-codegen/nullable v1.1.0 h1:eAh8JVc5430VtYVnq00Hrbpag9PFRGWLjxR1/3KntMs=
github.com/oapi-codegen/nullable v1.1.0/go.mod h1:KUZ3vUzkmEKY90ksAmit2+5juDIhIZhfDl+0PwOQlFY=
github.com/oapi-codegen/runtime v1.6.0 h1:7Xx+GlueD6nRuyKoCPzL434Jfi3BetbiJOrzCHp/VPU=
github.com/oapi-codegen/runtime v1.6.0/go.mod h1:GwV7hC2hviaMzj+ITfHVRESK5J2W/GefVwIND/bMGvU=
github.com/oapi-codegen/runtime v1.7.0 h1:t7358VYPvNbWJ9gdAkIK/smVeHpBf6yp8VTsaZsb/7k=
github.com/oapi-codegen/runtime v1.7.0/go.mod h1:GwV7hC2hviaMzj+ITfHVRESK5J2W/GefVwIND/bMGvU=
github.com/oklog/ulid/v2 v2.1.1 h1:suPZ4ARWLOJLegGFiZZ1dFAkqzhMjL3J1TzI+5wHz8s=
github.com/oklog/ulid/v2 v2.1.1/go.mod h1:rcEKHmBBKfef9DhnvX7y1HZBYxjXb0cP5ExxNsTT1QQ=
github.com/opencontainers/go-digest v1.0.0 h1:apOUWs51W5PlhuyGyz9FCeeBIOUDA/6nW8Oi/yOhh5U=
Expand Down Expand Up @@ -451,16 +451,16 @@ go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.6
go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.67.0/go.mod h1:NoUCKYWK+3ecatC4HjkRktREheMeEtrXoQxrqYFeHSc=
go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0 h1:OyrsyzuttWTSur2qN/Lm0m2a8yqyIjUVBZcxFPuXq2o=
go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0/go.mod h1:C2NGBr+kAB4bk3xtMXfZ94gqFDtg/GkI7e9zqGh5Beg=
go.opentelemetry.io/otel v1.45.0 h1:pdrWmLHofpubmArBv1LgFSv1Z0Ie/ppdZzu+kUN5EeU=
go.opentelemetry.io/otel v1.45.0/go.mod h1:XZxIqPapzEYnhNSScF5DIqXhm/rYi0FzCe2XddAwZfQ=
go.opentelemetry.io/otel/metric v1.45.0 h1:7Eg1uH7CJ5cXv9is6tnBe1FI6rj1nwUdbFypRm3br/M=
go.opentelemetry.io/otel/metric v1.45.0/go.mod h1:HAPbm1nd3p1PmFH7v2dR+6BjXxw+Lq4a2+pndMAm08s=
go.opentelemetry.io/otel/sdk v1.45.0 h1:4VVSMgQ83dUgW2aoX5f6JgLvHwIvzcuLnF9lUdCSpCw=
go.opentelemetry.io/otel/sdk v1.45.0/go.mod h1:Sr40LgXV7DsKMMJMKOhUWOgMWTfAaqvm2kF0g7ilwuA=
go.opentelemetry.io/otel v1.46.0 h1:FHt5/CDyVxi/8IM1CH7VE/rRgq3kLHa2mSTVMO8AWyc=
go.opentelemetry.io/otel v1.46.0/go.mod h1:Gj3SEScelsNC45tp4nSxRYlS+f5iez7W8XPMCt905kE=
go.opentelemetry.io/otel/metric v1.46.0 h1:yBnkXvgV7AXFILZc5K6IZe/CBFF3OS7BJ8ov6/lj0K8=
go.opentelemetry.io/otel/metric v1.46.0/go.mod h1:iPmdWqifKUdzziPkvvzIJXITl56fQx2mGM/DHLB3/2o=
go.opentelemetry.io/otel/sdk v1.46.0 h1:h5CNQQjEbuQXY/JfZtgt3i7HVFV3aHPO2OAwO2eTYPI=
go.opentelemetry.io/otel/sdk v1.46.0/go.mod h1:GAERFXFt5SYCEB+YiKUbMBeza6UaDH7GmGOZEfh2gSM=
go.opentelemetry.io/otel/sdk/metric v1.44.0 h1:3LlKgI+VjbVsjNRFZJZAJ30WjXC5VkNRks6si09iEfI=
go.opentelemetry.io/otel/sdk/metric v1.44.0/go.mod h1:5B5pMARnXxKhltooO4xUuCBorl65a4EpnTalObqOigA=
go.opentelemetry.io/otel/trace v1.45.0 h1:l/mP6Uv7oNO7/TblbhpbgMidxhq1uO/rPsikOyVhxag=
go.opentelemetry.io/otel/trace v1.45.0/go.mod h1:qoJJA2xNMnxRrdISU/kLtfUH2wNeQbiv+jhs/CxI8bc=
go.opentelemetry.io/otel/trace v1.46.0 h1:OULy7ccdJnZtJ0UDYFOIGaCmiWzJ8Vi2G/Rsu60qs1c=
go.opentelemetry.io/otel/trace v1.46.0/go.mod h1:J7GAXweO77XSFkB/rmAqk9D6ihszhFjLU+d9WuUxDLI=
go.step.sm/crypto v0.77.7 h1:6azC+pD678Vjju8yXnMDHCZJ+HzFaEmL3sCryiezTIA=
go.step.sm/crypto v0.77.7/go.mod h1:OW/2sEHwTtDKq70PvSQ5B0JGy/CrLyDKOiVy3YvZMTQ=
go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
Expand Down
1 change: 1 addition & 0 deletions internal/cli/root.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -355,6 +355,7 @@ func Execute() {
cmd.AddCommand(commands.NewGaugesCmd())
cmd.AddCommand(commands.NewAssignmentsCmd())
cmd.AddCommand(commands.NewBookmarksCmd())
cmd.AddCommand(commands.NewBubbleUpCmd())
Comment thread
jeremy marked this conversation as resolved.
cmd.AddCommand(commands.NewDraftsCmd())
cmd.AddCommand(commands.NewNotesCmd())
cmd.AddCommand(commands.NewCalendarsCmd())
Expand Down
Loading
Loading