automatic time-skipping (don't merge, will split into smaller prs) by feiyang3cat · Pull Request #9617 · temporalio/temporal

feiyang3cat · 2026-03-23T05:22:56Z

What changed?

add automatic time-skipping with fine-grained control, i.e. all features, unit-tests, feature tests are in this pr.
manual skipping, chasm related not yet included.

1. full control plane related:
- dc flag for the feature in a namespace
- opt-in to enable time-skipping when starting a workflow
- disable/enable time-skipping with workflowUpdateOptions
- API related:

1. ExecuteMultiOperationRequest
2. StartWorkflowExecution
3. SignalWithStartWorkflowExecution
4. UpdateWorkflowExecutionOption
5. BatchOperationUpdateWorkflowExecutionOptions
6. PostResetOperation
7. ExecuteMultiOperationRequest

2. data plane:
- on mutation/snapshot a timeskipping transfer task is created with the transaction
- handling of time-skipping transfer-task: transaction (calculate time to be skipped, update virtual time of the ms, generate new timertasks with new virtual time)
- timeSkippingTimeSourceImpl and mutableState vitualTime
- mutableState rebuild

How did you test it?

feiyang3cat · 2026-03-23T05:27:16Z

todo found: rebuild ms

feiyang3cat · 2026-03-23T06:12:43Z

currently, ts transfer task is using timer-task (setting time = now), can migrate to immediate transfer task.

feiyang3cat · 2026-03-24T06:32:01Z

service/history/workflow/mutable_state_impl.go

 	mutableState.approximateSize += dbRecord.ExecutionInfo.Size() - mutableState.executionInfo.Size()
 	mutableState.executionInfo = dbRecord.ExecutionInfo

+	if mutableState.executionInfo.GetTimeSkippingInfo().GetEnabled() {


feiyang3cat · 2026-03-24T06:35:03Z

service/history/workflow/task_refresher.go

+	}
+	for _, task := range ms.InsertTasks[tasks.CategoryTimer] {
+		if userTimerTask, ok := task.(*tasks.UserTimerTask); ok {
+			userTimerTask.VisibilityTimestamp = userTimerTask.VisibilityTimestamp.Add(-skippedDuration)


Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…art workflows data plane: rename persistencespb.TimeSkippedDetails

feiyang3cat · 2026-03-24T07:15:15Z

should merge API first and change api-go commitID
temporalio/api#740

feiyang3cat · 2026-03-24T07:18:13Z

service/history/interfaces/mutable_state.go

+		AddWorkflowExecutionTimeSkippedEvent(ctx context.Context, advanceToTimePoint time.Time) (*historypb.HistoryEvent, error)
+		ApplyWorkflowExecutionTimeSkippedEvent(ctx context.Context, event *historypb.HistoryEvent) error
+		IsAutoTimeSkippable() bool
+		VirtualTimeNow() time.Time


can consider just call it now, if there is no timeskipping ever happened, return shard.Now()

@yycptt may need a closer look here

feiyang3cat · 2026-03-24T07:20:43Z

service/history/workflow/task_refresher.go

+	"go.temporal.io/server/service/history/tasks"
 )

 type (


@yux0 this time-skipping feature is almost completed in this pr, and I think replication will naturally be covered by this change? (I haven't add feature testing for replication yet, will need to read a bit on how to do that

should support both partialRefresh vs Refresh

feiyang3cat · 2026-03-24T07:22:01Z

need to add more in-repo feature testing (now the basic uses cases are contained, edgy cases are needed)

add timeSkippingEvent to workflow rebuilder fix bugs of taskRefersher, and mutable virtual time The proto source had the api-linter suppression comment for to_time but the generated .pb.go was not updated to reflect it. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feiyang3cat · 2026-03-24T22:59:13Z

common/clock/time_skipping_time_source.go

+
+// AfterFunc schedules f to run after duration d on the real wall clock.
+// TODO(@feiyang): explore if this method needs to respect virtual time — currently it delegates
+// to the base clock so f fires after d of wall time, not virtual time.


@yycptt may need a closer look

feiyang3cat · 2026-03-24T23:32:17Z

service/history/timer_queue_active_task_executor.go

 }

+func (t *timerQueueActiveTaskExecutor) executeTimeSkippingTimerTask(
+	ctx context.Context,


todo, @feiyang3cat
if we still keep this in transferTask, need to check and test idempotency and granular error handling

feiyang3cat requested review from a team as code owners March 23, 2026 05:22

feiyang3cat changed the title ~~[server-poc] automatic time-skipping~~ [server-poc] automatic time-skipping (don't merge) Mar 23, 2026

feiyang3cat force-pushed the server-time-skipping-v2 branch from 1e69592 to 8f8fae8 Compare March 23, 2026 05:48

feiyang3cat force-pushed the server-time-skipping-v2 branch from 8f8fae8 to 6eacb02 Compare March 24, 2026 00:05

feiyang3cat requested a review from a team as a code owner March 24, 2026 00:05

feiyang3cat force-pushed the server-time-skipping-v2 branch 8 times, most recently from 2463097 to 39ac713 Compare March 24, 2026 06:23

feiyang3cat commented Mar 24, 2026

View reviewed changes

feiyang3cat force-pushed the server-time-skipping-v2 branch from 39ac713 to 2e1df0a Compare March 24, 2026 07:09

feiyang3cat and others added 6 commits March 24, 2026 00:12

timeskipping-poc: control plane

6103af6

timeskipping-poc: data plane with timeskipping-transfer-timertask

0177eff

time-skipping: core part of state manipulation

4abe6f7

timeskipping-poc: fix code lint, conflicts

62746b3

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

add metrics for enable and disable time-skipping

bf7afc1

control plane: add time-skipping to other apis that can update and st…

b959b31

…art workflows data plane: rename persistencespb.TimeSkippedDetails

feiyang3cat force-pushed the server-time-skipping-v2 branch from 2e1df0a to dd0297a Compare March 24, 2026 07:13

feiyang3cat changed the title ~~[server-poc] automatic time-skipping (don't merge)~~ automatic time-skipping (don't merge) Mar 24, 2026

feiyang3cat changed the title ~~automatic time-skipping (don't merge)~~ automatic time-skipping Mar 24, 2026

feiyang3cat commented Mar 24, 2026

View reviewed changes

feiyang3cat force-pushed the server-time-skipping-v2 branch from dd0297a to 824d0c6 Compare March 24, 2026 07:24

feiyang3cat requested a review from yycptt March 24, 2026 17:01

feiyang3cat commented Mar 24, 2026

View reviewed changes

feiyang3cat changed the title ~~automatic time-skipping~~ automatic time-skipping (don't merge) Mar 24, 2026

feiyang3cat commented Mar 24, 2026

View reviewed changes

feiyang3cat requested review from a team as code owners March 26, 2026 04:19

feiyang3cat force-pushed the server-time-skipping-v2 branch 2 times, most recently from 14496ab to 4faf65c Compare March 26, 2026 05:33

add fine-grained control of time-skipping, and fix bugs

e6275d8

feiyang3cat force-pushed the server-time-skipping-v2 branch from 4faf65c to e6275d8 Compare March 26, 2026 06:34

feiyang3cat changed the title ~~automatic time-skipping (don't merge)~~ automatic time-skipping (don't merge, will split into smaller prs) Mar 30, 2026

Conversation

feiyang3cat commented Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What changed?

How did you test it?

Uh oh!

feiyang3cat commented Mar 23, 2026

Uh oh!

feiyang3cat commented Mar 23, 2026

Uh oh!

feiyang3cat Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

feiyang3cat Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

feiyang3cat Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

feiyang3cat Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

feiyang3cat commented Mar 24, 2026

Uh oh!

feiyang3cat Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

feiyang3cat Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

feiyang3cat Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

feiyang3cat Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

feiyang3cat commented Mar 24, 2026

Uh oh!

feiyang3cat Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

feiyang3cat Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

feiyang3cat commented Mar 23, 2026 •

edited

Loading

feiyang3cat Mar 24, 2026 •

edited

Loading

feiyang3cat Mar 24, 2026 •

edited

Loading

feiyang3cat Mar 24, 2026 •

edited

Loading