feat: `Troubleshooter` atom by Ryukemeister · Pull Request #27497 · calcom/cal.com

Ryukemeister · 2026-02-02T09:30:41Z

What does this PR do?

Adds a new Troubleshooter atom to inspect availability by event type, with a sidebar (event type selection, schedule info, connected calendars) and a large calendar view. Also exposes atoms APIs and hooks to power the experience in platform apps and the example site.

Visual Demo

troubleshooter.atom.mov

Changes made

New Features
- TroubleshooterPlatformWrapper with sidebar (EventTypeSelect, EventScheduleItem, CalendarToggleContainer) and LargeCalendar.
- New atoms endpoints: GET /atoms/event-types/list-with-team and GET /atoms/schedules/event-type/:eventSlug.
- New platform hooks: useEventTypesList and useScheduleByEventSlug.
- Exported TroubleShooter from @calcom/atoms and added /troubleshooter example page with navbar link.
- LargeCalendar supports event type views via teamId or username + eventSlug.
Refactors
- Componentized EventTypeSelect, EventScheduleItem, and CalendarToggleContainer for reuse; added prop-driven variants.
- Troubleshooter store now includes username on the selected event.
- Reorganized atoms index exports; CalendarToggleContainer supports optionally hiding the "Manage calendars" button.
- Exposed listWithTeamHandler and getScheduleByEventSlugHandler via platform libraries and narrowed TRPC handler ctx types.

Updates since last revision

Localized "Event Type" label with t("event_type") in EventTypeSelectComponent.tsx (addressing Cubic AI review feedback)

Mandatory Tasks (DO NOT REMOVE)

I have self-reviewed the code (A decent size PR without self-review might be rejected).
I have updated the developer docs in /docs if this PR makes changes that would require a documentation change. N/A - no documentation changes required.
I confirm automated tests are in place that prove my fix is effective or that my feature works.

How should this be tested?

Navigate to the /troubleshooter page in the platform examples app
Verify the Event Type dropdown displays with a localized label
Select different event types and verify the schedule and calendar information updates accordingly
Verify the LargeCalendar displays availability correctly

Human Review Checklist

Verify the localization change in EventTypeSelectComponent.tsx correctly uses the existing event_type translation key
Note: Type check CI failure is pre-existing (in BillingCredits.tsx) and unrelated to this PR's changes

Link to Devin run: https://app.devin.ai/sessions/01b6449f291a493cb845a288df90f11b
Requested by: unknown ()

cubic-dev-ai

3 issues found across 25 files

Prompt for AI agents (all issues)


Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="packages/platform/atoms/troubleshooter/wrappers/TroubleshooterPlatformWrapper.tsx">

<violation number="1" location="packages/platform/atoms/troubleshooter/wrappers/TroubleshooterPlatformWrapper.tsx:28">
P2: The mobile branch sets a misspelled CSS variable (--troublehooster-meta-width), but the grid reads --troubleshooter-meta-width. This prevents the mobile width override from taking effect, leading to an undefined column width on mobile.</violation>

<violation number="2" location="packages/platform/atoms/troubleshooter/wrappers/TroubleshooterPlatformWrapper.tsx:49">
P3: Tailwind negative margin utility is malformed (`ml[-1px]`), so the margin won’t apply. Use `ml-[-1px]` instead.</violation>
</file>

<file name="packages/platform/examples/base/src/pages/troubleshooter.tsx">

<violation number="1" location="packages/platform/examples/base/src/pages/troubleshooter.tsx:7">
P2: Rule violated: **Enforce Singular Naming for Single-Item Functions**

Rename the single-item function to a singular name to comply with the singular naming rule (e.g., "Calendar" or "Troubleshooter").</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

packages/platform/atoms/troubleshooter/wrappers/TroubleshooterPlatformWrapper.tsx

packages/platform/examples/base/src/pages/troubleshooter.tsx

packages/platform/atoms/troubleshooter/wrappers/TroubleshooterPlatformWrapper.tsx

github-actions · 2026-02-02T09:49:19Z

Devin AI is addressing Cubic AI's review feedback

A Devin session has been created to address the issues identified by Cubic AI.

View Devin Session

…convention Co-Authored-By: unknown <>

devin-ai-integration · 2026-02-02T09:52:48Z

I've reviewed the Cubic AI feedback and addressed the issues based on their confidence scores (only fixing issues with confidence 9/10 or higher):

Fixed (confidence 9/10):

Renamed the Calendars function to Troubleshooter in packages/platform/examples/base/src/pages/troubleshooter.tsx to comply with the singular naming convention. Also updated the data-testid from calendars-settings-atom to troubleshooter-atom for consistency, and removed the unused CalendarSettings import.

Skipped (confidence below 9/10):

CSS variable typo --troublehooster-meta-width (confidence 8/10)
Malformed Tailwind class ml[-1px] (confidence 7/10)

These lower-confidence issues may warrant manual review by the PR author to determine if they are valid concerns.

packages/platform/atoms/troubleshooter/sidebar/CalendarToggleContainer.tsx

packages/platform/atoms/troubleshooter/sidebar/EventScheduleItem.tsx

packages/platform/atoms/troubleshooter/sidebar/EventTypeSelect.tsx

cubic-dev-ai

3 issues found across 12 files (changes from recent commits).

Prompt for AI agents (all issues)


Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="packages/features/troubleshooter/components/EventTypeSelectComponent.tsx">

<violation number="1" location="packages/features/troubleshooter/components/EventTypeSelectComponent.tsx:91">
P3: Localize this label with t() instead of a hardcoded string so it participates in translations.</violation>
</file>

<file name="packages/features/troubleshooter/components/EventScheduleItemComponent.tsx">

<violation number="1" location="packages/features/troubleshooter/components/EventScheduleItemComponent.tsx:21">
P2: Localize the label text with `t()` instead of hardcoding English to comply with the localization requirement.</violation>
</file>

<file name="packages/features/troubleshooter/components/CalendarToggleContainerComponent.tsx">

<violation number="1" location="packages/features/troubleshooter/components/CalendarToggleContainerComponent.tsx:140">
P3: Localize the "Nameless Calendar" fallback with `t()` (add a translation key if one doesn’t already exist).</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

packages/features/troubleshooter/components/EventScheduleItemComponent.tsx

packages/features/troubleshooter/components/EventTypeSelectComponent.tsx

packages/features/troubleshooter/components/CalendarToggleContainerComponent.tsx

github-actions · 2026-02-03T11:51:25Z

Devin AI is addressing Cubic AI's review feedback

A Devin session has been created to address the issues identified by Cubic AI.

View Devin Session

Co-Authored-By: unknown <>

implemented feedback but I need to test this again, since atoms build is blocked we cant lets this go in now. need to wait now.

paragon-review · 2026-02-04T07:30:38Z

Paragon: tests updated

1 updated test generated for this PR.

Updated Tests

listWithTeamHandler - should return user's own event types and event types of teams they are a member of — Adding new test to existing file

Details

Updated Tests

listWithTeamHandler - should return user's own event types and event types of teams they are a member of (integration)

github-actions · 2026-02-04T14:04:02Z

E2E results are ready!

Workflow #102928.1 latest results

devin-ai-integration

Devin Review found 1 potential issue.

View 5 additional findings in Devin Review.

packages/platform/atoms/troubleshooter/large-calendar/LargeCalendar.tsx

packages/platform/examples/base/src/pages/troubleshooter.tsx

…manage calendars button

ThyMinimalDev

well done

keithwillcode · 2026-02-08T15:39:51Z

packages/trpc/server/routers/viewer/eventTypes/listWithTeam.handler.ts

    LEFT JOIN "public"."Team" AS "j1" ON ("j1"."id") = ("public"."EventType"."teamId")
-    WHERE "public"."EventType"."userId" = ${userId}
+    LEFT JOIN "public"."users" AS "u" ON ("u"."id") = ("public"."EventType"."userId")
+    WHERE "public"."EventType"."userId" = ${userId} AND "public"."EventType"."teamId" IS NULL


@Ryukemeister Why was this AND "public"."EventType"."teamId" IS NULL added? We are explicitly LEFT JOIN on the Team table and then filtering all records out with this WHERE clause. Or am I reading that wrong?

init: troubleshooter atom

05e062b

Ryukemeister requested review from a team as code owners February 2, 2026 09:30

pull-request-size bot added the size/XL label Feb 2, 2026

graphite-app bot added core area: core, team members only consumer labels Feb 2, 2026

Merge branch 'main' into troubleshooter-atom

127911b

Ryukemeister assigned ThyMinimalDev Feb 2, 2026

cubic-dev-ai bot reviewed Feb 2, 2026

View reviewed changes

PeerRich enabled auto-merge (squash) February 2, 2026 09:45

fix: rename Calendars function to Troubleshooter for singular naming …

ed021dc

…convention Co-Authored-By: unknown <>

ThyMinimalDev previously requested changes Feb 3, 2026

View reviewed changes

Ryukemeister mentioned this pull request Feb 3, 2026

Troubleshooter atom #27562

Closed

Ryukemeister and others added 3 commits February 3, 2026 15:59

fix: merge conflicts

1698b0c

Merge branch 'main' into troubleshooter-atom

b1a14f3

chore: implement feedback

7fd7cfe

pull-request-size bot added size/XXL and removed size/XL labels Feb 3, 2026

cubic-dev-ai bot reviewed Feb 3, 2026

View reviewed changes

devin-ai-integration bot and others added 4 commits February 3, 2026 11:55

fix: localize Event Type label with t() in EventTypeSelectComponent

d2caab6

Co-Authored-By: unknown <>

chore: address cubic feedback

9cc727d

chore: update locales

f495bce

Merge branch 'main' into troubleshooter-atom

077c8fc

Ryukemeister added 3 commits February 3, 2026 22:43

Merge branch 'main' into troubleshooter-atom

622a310

Merge branch 'main' into troubleshooter-atom

3a2d9a4

Merge branch 'main' into troubleshooter-atom

d51f06a

Ryukemeister and others added 4 commits February 4, 2026 17:23

Merge branch 'main' into troubleshooter-atom

daa0e7d

Merge branch 'main' into troubleshooter-atom

4a9b1bc

chore: remove duplicate imports

2566b5f

Merge branch 'main' into troubleshooter-atom

b85ee84

Ryukemeister added the ready-for-e2e label Feb 4, 2026

Ryukemeister requested a review from alishaz-polymath February 4, 2026 13:52

Ryukemeister and others added 3 commits February 5, 2026 13:41

Merge branch 'main' into troubleshooter-atom

c3fd74c

Merge branch 'main' into troubleshooter-atom

e609ced

fix: remove duplicate username in SQL query

56f8326

Ryukemeister removed the ready-for-e2e label Feb 5, 2026

Merge branch 'main' into troubleshooter-atom

b78114a

Ryukemeister added ready-for-e2e run-ci Approve CI to run for external contributors labels Feb 5, 2026

devin-ai-integration bot reviewed Feb 6, 2026

View reviewed changes

packages/platform/atoms/troubleshooter/large-calendar/LargeCalendar.tsx Show resolved Hide resolved

Ryukemeister and others added 4 commits February 6, 2026 11:05

fix: merge conflicts

45b5eb5

Merge branch 'main' into troubleshooter-atom

664ffd5

fixup

d548f3d

Merge branch 'main' into troubleshooter-atom

1a2b983

ThyMinimalDev reviewed Feb 6, 2026

View reviewed changes

packages/platform/examples/base/src/pages/troubleshooter.tsx Outdated Show resolved Hide resolved

Ryukemeister and others added 2 commits February 6, 2026 19:49

fixup: dont update query params for atoms, add props for install and …

768c9d8

…manage calendars button

Merge branch 'main' into troubleshooter-atom

a968e7f

ThyMinimalDev approved these changes Feb 6, 2026

View reviewed changes

PeerRich merged commit 8a17ebc into main Feb 6, 2026
51 of 52 checks passed

PeerRich deleted the troubleshooter-atom branch February 6, 2026 15:34

keithwillcode reviewed Feb 8, 2026

View reviewed changes

Ryukemeister mentioned this pull request Feb 8, 2026

fix: restore listWithTeam query to include team events with userId set and add comprehensive tests #27752

Merged

6 tasks

Conversation

Ryukemeister commented Feb 2, 2026 • edited by devin-ai-integration bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do?

Visual Demo

Changes made

Updates since last revision

Mandatory Tasks (DO NOT REMOVE)

How should this be tested?

Human Review Checklist

Uh oh!

cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Feb 2, 2026

Devin AI is addressing Cubic AI's review feedback

Uh oh!

devin-ai-integration bot commented Feb 2, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Feb 3, 2026

Devin AI is addressing Cubic AI's review feedback

Uh oh!

paragon-review bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Paragon: tests updated

Updated Tests

Uh oh!

github-actions bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

E2E results are ready!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

ThyMinimalDev left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

keithwillcode Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Ryukemeister commented Feb 2, 2026 •

edited by devin-ai-integration bot

Loading

paragon-review bot commented Feb 4, 2026 •

edited

Loading

github-actions bot commented Feb 4, 2026 •

edited

Loading