Common Errors for Event History by Alex-Tideman · Pull Request #3306 · temporalio/ui

Alex-Tideman · 2026-04-14T18:24:11Z

Summary

Adds a common errors system that detects 35 workflow/activity misconfigurations and surfaces them as warnings, errors, and info messages on the Workflow Details page.
Detection covers workflow timeouts, retry policies, continue-as-new patterns, activity timeouts, heartbeat issues, local activities, delayed start, ID reuse policies, and more
Includes a standalone /common-errors reference page with tab-based severity filtering
Refactors workflow-run-layout to Svelte 5 and adds a headerSnippet slot for injecting the common errors component

For this initial release, the Common Errors are not included by default to the Workflow Header. We will opt in to internally test first by including in the headerSnippet:

<WorkflowRunLayout>
  {#snippet headerSnippet()}
    <WorkflowCommonErrors />
  {/snippet}
  {@render children()}
</WorkflowRunLayout>

Test plan

There are two significant changes outside of Common Errors to test:

Worklow Run Layout was converted to Svelte5, specifically with $effect and untrack to do data fetching. This is an important file that fetches our workflow data. High risk change.
Alert component was converted to Svelte5. Low risk change.

To test common errors, you can include the above snippet and run workflows with any of the 35 scenarios such as a short workflowExecutionTimeout to view the error.

…3262) Create a reusable common-error component system for displaying operational guidance about workflow misconfigurations. Includes typed data for 35 known issues with severity levels, documentation links, and a /common-errors route.

Add automatic detection of 21 workflow configuration issues and display them as warnings in the workflow header. Detection covers timeout misconfigurations, retry policy issues, heartbeat settings, and more. Also fixes raw code references in error titles.

- Raise #31 threshold from 4000 to 10000 to match "significant additional events" - Add null guards to all getCommonErrorById calls via addError helper - Detect #3 (short timeout) from workflowRunTimeout on first event, not just execution timeout - Fix #10 false positives for empty retry policy objects - Handle protobuf nanos field in durationToSeconds for sub-second durations

Implement Tier 1 detections from existing data (#9, #11, #13, #15, #19, #23, #35) and Tier 2 detections from event history scanning (#8, #12, #26, #27, #28, #29, #30). Adds detectEventHistoryErrors with single-pass scanning and updates getApplicableCommonErrors to accept optional event history. All 35 error definitions now have active detection logic.

…flow-run-layout to svelte5

Update detectFirstEventErrors test calls to match updated function signature that removed the workflow parameter. Add missing routeForCommonErrors test case to route-for-base-path tests.

Switch from VerticalNav sidebar to TabButtons for severity filtering. Remove layout reset (@) since the page no longer needs a custom layout. Add WorkflowCommonErrors snippet to workflow run layout.

Rename $$Props to Props in alert.svelte for Svelte 5 convention. Update stories to use module script and ComponentProps for proper type inference with Storybook.

vercel · 2026-04-14T18:24:16Z

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

Project	Deployment	Actions	Updated (UTC)
holocene	Ready	Preview, Comment	Apr 28, 2026 1:53pm

temporal-cicd · 2026-04-14T18:25:20Z

	Warnings
⚠️	📊 Strict Mode: 1 error in 1 file (0.1% of 1000 total) src/lib/utilities/common-error-detection.ts (1) L447:2: Type '(CommonError \| undefined)[]' is not assignable to type 'CommonError[]'.

Generated by 🚫 dangerJS against a581969

Co-authored-by: Laura Whitaker <[email protected]>

;5u

temporal-cicd · 2026-04-28T13:54:06Z

+  if (hasLocalActivityMarker && hasWftFailure) {
+    errorIds.add(30);
+  }
+


⚠️ Type '(CommonError | undefined)[]' is not assignable to type 'CommonError[]'.

Auto-generated version bump from 2.49.1 to 2.50.0 Bump type: minor Changes included: - [`29832bec`](29832be) Use initiatedEvent for startChildFailed event grouping (#3342) - [`91a01560`](91a0156) rm slash (#3343) - [`2e7b88d0`](2e7b88d) feat: Set Current Version action for worker deployment versions (#3319) - [`b2685f3b`](b2685f3) Add relative path prefix support to routeFor utilities (#3292) - [`9c888c0c`](9c888c0) fix: validate connection modal status, retry button, and copy nits (#3347) - [`38989c48`](38989c4) revert: restore original create worker deployment copy (#3348) - [`90e1fe58`](90e1fe5) Common Errors for Event History (#3306) - [`f479e4e2`](f479e4e) Show current duration for pending timeline events (#3346) - [`65a7ff0d`](65a7ff0) Add refresh button to workers list view (#3349) - [`219cfee4`](219cfee) Fix null conditionals in search attribute filter (#3351) - [`08bd2f01`](08bd2f0) Add support for adding caller Namespace even if it's not in list of allowed Namespace options for Nexus endpoint (#3167) - [`d424a78a`](d424a78) refactor(DT-3906): Add knip (#3350) - [`e828b14f`](e828b14) Remove icon (#3357) - [`252a755c`](252a755) Add Java to list of support versions for worker heartbeats (#3362) - [`0f446c7a`](0f446c7) refactor(DT-3906): Simple Svelte 5 migrations (#3359) - [`63db5b72`](63db5b7) feat(DT-3657): Support shift click for bulk selection in workflow table (#3344) - [`389d57bf`](389d57b) Enable Svelte 5 runes on files not using legacy features (#3363) - [`f4b87e1d`](f4b87e1) Update components/workflow to Svelte 5 syntax (#3361) - [`3e2cce43`](3e2cce4) refactor(DT-3906): More Svelte 5 Migrations (trivial ones) (#3364) - [`15adcd73`](15adcd7) refactor(DT-3906): UI svelte 5 migrate components/events (#3365) - [`031fb867`](031fb86) refactor(DT-3906): Migrate stories to Svelte 5 syntax (#3366) - [`4eac9d2a`](4eac9d2) Scope group hover to tooltip component only (#3379) - [`eeace5c3`](eeace5c) chore: upgrade TypeScript to v6.0.3 (#3371) - [`cb80efdd`](cb80efd) refactor(DT-3906): More trivial migrations (#3367) - [`6cc395bf`](6cc395b) refactor(DT-3906): migrate holocene primitives + layout components to Svelte 5 runes (#3377) - [`40a029ea`](40a029e) refactor(DT-3906): UI Svelte 5 Migrations medium (#3368) - [`7dc29ba6`](7dc29ba) refactor(DT-3906): Delete unused Svelte 4 scaffolding (carved from #3370 - Part 1) (#3372) - [`34a8547e`](34a8547) refactor(DT-3906): Migrate workflow client-action modals to runes (carved from #3370 - Part 4) (#3375) - [`61090d7e`](61090d7) refactor(DT-3906): Migrate schedule view components to runes (carved from #3370 - Part 2) (#3373) - [`988e0479`](988e047) refactor(DT-3906): Migrate filter and input components to runes (carved from #3370 - Part 3) (#3374) - [`d8b78496`](d8b7849) refactor(DT-3906): Migrate workflows-summary table + relationships to runes (carved from #3370 - Part 5) (#3376) - [`ff86c004`](ff86c00) fix(DT-3968): Make Workflow Table Tooltips render in portal (#3383) - [`5e02642a`](5e02642) fix(DT-3967): Visibly toggle the view children button even with a parent has 0 (#3382) - [`1f2b1031`](1f2b103) Remove capability guard from Set Current Version menu item (#3386) - [`0d54dcb4`](0d54dcb) fix: portal maximizable to body to escape stacking context (#3385) - [`abf45438`](abf4543) chore(security): patch Dependabot alerts for axios, protobufjs, fast-uri, uuid, postcss, gomarkdown (#3388) - [`4500f5ea`](4500f5e) Upgrade GitHub actions (#3389) - [`4a8c0c5b`](4a8c0c5) fix(timeline): stabilize child workflow timeline width with scrollbar-gutter (#3329) - [`ead14c61`](ead14c6) Move Create Schedule button to header row (#3390) - [`e8638a2b`](e8638a2) Add top margin (#3392) - [`ef03dfce`](ef03dfc) refactor: replace PayloadDecoder and MetadataDecoder with unified Payload component (#3299) - [`89b9eafa`](89b9eaf) add loading state to payload code block (#3397) - [`ee3ae138`](ee3ae13) Update Schedules search attributes filter (#3396) - [`41fd4f1f`](41fd4f1) DT-3751 - download external payloads (#3345) - [`e4fee0b6`](e4fee0b) Fix codec server request URL (#3400) - [`966b3d0a`](966b3d0) Make input from schedule result actually a string and update tests (#3403) - [`48a014db`](48a014d) feat(history): show Nexus operation name in compact view (#3394) - [`9127c768`](9127c76) Refactor status counts and refresh button (#3402) - [`747ec109`](747ec10) Fix double loader button (#3407) - [`6ae961fc`](6ae961f) Payload rendering and error optimizations (#3401) - [`32c74a48`](32c74a4) add codec server error banner back to workflow layout (#3408) - [`f73c7ec9`](f73c7ec) Nxs operation/kt (#3406) - [`672bb04a`](672bb04) Bump Go 1.26.2→1.26.3, x/net v0.54.0, remove curl from runtime image (#3409) - [`1ee09fe3`](1ee09fe) chore(deps-dev): bump svelte from 5.55.1 to 5.55.7 (#3395) - [`565bb071`](565bb07) VLN-1352: remediate missing-dependency-cooldown (#3398) - [`25794ed8`](25794ed) Bump devalue to 5.8.1 (#3410) - [`b18d0060`](b18d006) Set color-scheme explicitly (#3358) - [`e7995b81`](e7995b8) chore: ensure the empty app.html respects the user's ligh/dark settings (#3353) - [`01d64038`](01d6403) fix: enable external payload download button with namespace level codec endpoint (#3420) - [`4cc44311`](4cc4431) Fix publicPath URL duplication when prefix appears as substring (#3393) Co-authored-by: laurakwhit <[email protected]>

Alex-Tideman added 14 commits April 1, 2026 15:08

Merge branch 'main' into common-errors

d29621c

Add snippet to pass in headerSnippet for common errors. Refactor work…

40c6198

…flow-run-layout to svelte5

Add back common errors page

fb8c0d3

Remove common errors from snippet

c466cc5

Revert alert to current styles

5148d67

Fix test failures for detectFirstEventErrors and routeForCommonErrors

d981f64

Update detectFirstEventErrors test calls to match updated function signature that removed the workflow parameter. Add missing routeForCommonErrors test case to route-for-base-path tests.

Replace VerticalNav with tab group on common errors page

9a969ba

Switch from VerticalNav sidebar to TabButtons for severity filtering. Remove layout reset (@) since the page no longer needs a custom layout. Add WorkflowCommonErrors snippet to workflow run layout.

Remove common errors from header snippet

96f6fd2

Fix type errors in alert component and stories

37aa592

Rename $$Props to Props in alert.svelte for Svelte 5 convention. Update stories to use module script and ComponentProps for proper type inference with Storybook.

Fix merge conflicts

ea31e70

Alex-Tideman requested a review from a team as a code owner April 14, 2026 18:24

vercel Bot deployed to Preview April 14, 2026 18:24 View deployment

Alex-Tideman requested review from andrewzamojc, laurakwhit and rossnelson April 14, 2026 18:29

laurakwhit reviewed Apr 15, 2026

View reviewed changes

Update src/lib/components/common-errors/common-error.svelte

e791ed6

Co-authored-by: Laura Whitaker <[email protected]>

vercel Bot deployed to Preview April 15, 2026 20:01 View deployment

Update src/lib/components/common-errors/common-errors-data.ts

773bd97

Co-authored-by: Laura Whitaker <[email protected]>

vercel Bot deployed to Preview April 15, 2026 20:02 View deployment

Update src/lib/utilities/common-error-detection.ts

834f5d9

Co-authored-by: Laura Whitaker <[email protected]>

vercel Bot deployed to Preview April 15, 2026 20:04 View deployment

Alex-Tideman added 2 commits April 15, 2026 15:05

Remove workflow-common-errors.svelte

05688ed

Remove getCommonErrorsByCategory

95a0067

Update src/lib/components/common-errors/common-error-list.svelte

35d15bd

Co-authored-by: Laura Whitaker <[email protected]>

vercel Bot deployed to Preview April 15, 2026 20:28 View deployment

Fix naming

84bd926

vercel Bot deployed to Preview April 15, 2026 21:16 View deployment

Add back workflow-common-errors.svelte

987cec3

;5u

vercel Bot deployed to Preview April 15, 2026 21:20 View deployment

Fix merge conflict

95f9e64

vercel Bot deployed to Preview April 28, 2026 13:28 View deployment

Formatting

ade8436

vercel Bot deployed to Preview April 28, 2026 13:45 View deployment

Add type predicate filter

a581969

vercel Bot deployed to Preview April 28, 2026 13:53 View deployment

temporal-cicd Bot reviewed Apr 28, 2026

View reviewed changes

Alex-Tideman requested a review from laurakwhit April 28, 2026 18:15

laurakwhit approved these changes Apr 28, 2026

View reviewed changes

Alex-Tideman merged commit 90e1fe5 into main Apr 28, 2026
28 checks passed

Alex-Tideman deleted the common-errors branch April 28, 2026 18:46

temporal-cicd Bot mentioned this pull request May 21, 2026

chore: bump version to 2.50.0 #3421

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Common Errors for Event History#3306

Common Errors for Event History#3306
Alex-Tideman merged 25 commits into
mainfrom
common-errors

Alex-Tideman commented Apr 14, 2026

Uh oh!

vercel Bot commented Apr 14, 2026 •

edited

Loading

Uh oh!

temporal-cicd Bot commented Apr 14, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

temporal-cicd Bot Apr 28, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

Alex-Tideman commented Apr 14, 2026

Summary

Uh oh!

vercel Bot commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

temporal-cicd Bot commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

temporal-cicd Bot Apr 28, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

vercel Bot commented Apr 14, 2026 •

edited

Loading

temporal-cicd Bot commented Apr 14, 2026 •

edited

Loading