From dd498588e1dd7fd80fe7f91ba9518064c22c775d Mon Sep 17 00:00:00 2001
From: "alex.stanfield" <13949480+chaptersix@users.noreply.github.com>
Date: Tue, 14 Jul 2026 12:55:48 -0500
Subject: [PATCH] Fix schedule catchup window default

---
 packages/client/src/schedule-client.ts | 2 +-
 packages/client/src/schedule-types.ts  | 4 ++--
 packages/test/src/test-schedules.ts    | 1 +
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/client/src/schedule-client.ts b/packages/client/src/schedule-client.ts
index e88721316e..b0c8960d2b 100644
--- a/packages/client/src/schedule-client.ts
+++ b/packages/client/src/schedule-client.ts
@@ -437,7 +437,7 @@ export class ScheduleClient extends BaseClient {
           policies: {
             // 'overlap' should never be missing on describe, as the server will replace UNSPECIFIED by an actual value
             overlap: decodeScheduleOverlapPolicy(raw.schedule.policies?.overlapPolicy) ?? ScheduleOverlapPolicy.SKIP,
-            catchupWindow: optionalTsToMs(raw.schedule.policies?.catchupWindow) ?? 60_000,
+            catchupWindow: optionalTsToMs(raw.schedule.policies?.catchupWindow) ?? 365 * 24 * 60 * 60 * 1000,
             pauseOnFailure: raw.schedule.policies?.pauseOnFailure === true,
           },
           state: {
diff --git a/packages/client/src/schedule-types.ts b/packages/client/src/schedule-types.ts
index 0c384b883e..66451bf3c0 100644
--- a/packages/client/src/schedule-types.ts
+++ b/packages/client/src/schedule-types.ts
@@ -45,11 +45,11 @@ export interface ScheduleOptions<A extends ScheduleOptionsAction = ScheduleOptio
     /**
      * The Temporal Server might be down or unavailable at the time when a Schedule should take an Action. When the Server
      * comes back up, `catchupWindow` controls which missed Actions should be taken at that point. The default is one
-     * minute, which means that the Schedule attempts to take any Actions that wouldn't be more than one minute late. It
+     * year, which means that the Schedule attempts to take any Actions that wouldn't be more than one year late. It
      * takes those Actions according to the {@link ScheduleOverlapPolicy}. An outage that lasts longer than the Catchup
      * Window could lead to missed Actions. (But you can always {@link ScheduleHandle.backfill}.)
      *
-     * @default 1 year
+     * When unset, this field is omitted so the Temporal Server applies its default (currently one year).
      * @format number of milliseconds or {@link https://www.npmjs.com/package/ms | ms-formatted string}
      */
     catchupWindow?: Duration;
diff --git a/packages/test/src/test-schedules.ts b/packages/test/src/test-schedules.ts
index bd606bf44f..3d7c8c008e 100644
--- a/packages/test/src/test-schedules.ts
+++ b/packages/test/src/test-schedules.ts
@@ -69,6 +69,7 @@ if (RUN_INTEGRATION_TESTS) {
       t.deepEqual(describedSchedule.spec.calendars, [
         { ...calendarSpecDescriptionDefaults, hour: [{ start: 2, end: 7, step: 1 }] },
       ]);
+      t.is(describedSchedule.policies.catchupWindow, 365 * 24 * 60 * 60 * 1000);
     } finally {
       await handle.delete();
     }