fix(cli): link unsupported Zod errors to upgrade guidance

Clarify that Zod 4 is now the default while supported Zod 3 projects can
keep their existing major version.

Author: carderne

.changeset/zod-4-support.md

@@ -9,6 +9,6 @@
 "@trigger.dev/schema-to-json": minor
 ---
 
-Add Zod 4 support. You can now use Zod 3.25.56+ or Zod 4.
+Trigger.dev now uses Zod 4 by default. Projects using Zod 3.25.56 or later 3.x releases remain supported.
 
 Zod remains a runtime dependency of packages that execute schemas, so existing and new installations continue to receive it automatically. The matching peer dependency range allows package managers to reuse either a compatible Zod 3 or Zod 4 installation from your project.

packages/cli-v3/src/utilities/commandError.test.ts

@@ -3,7 +3,9 @@ import { formatCommandError } from "./commandError.js";
 
 const expectedMessage = `Your installed Zod version is not supported by Trigger.dev.
 
-Trigger.dev requires zod@^3.25.56 or zod@^4.0.0. Upgrade Zod, reinstall your dependencies, and try again.`;
+Trigger.dev requires zod@^3.25.56 or zod@^4.0.0. Upgrade Zod, reinstall your dependencies, and try again.
+
+See https://trigger.dev/docs/troubleshooting-zod for upgrade guidance.`;
 
 describe("formatCommandError", () => {
   it("explains when the installed Zod package does not export zod/v4", () => {

packages/cli-v3/src/utilities/commandError.ts

@@ -1,6 +1,8 @@
 const UNSUPPORTED_ZOD_MESSAGE = `Your installed Zod version is not supported by Trigger.dev.
 
-Trigger.dev requires zod@^3.25.56 or zod@^4.0.0. Upgrade Zod, reinstall your dependencies, and try again.`;
+Trigger.dev requires zod@^3.25.56 or zod@^4.0.0. Upgrade Zod, reinstall your dependencies, and try again.
+
+See https://trigger.dev/docs/troubleshooting-zod for upgrade guidance.`;
 
 export function formatCommandError(error: unknown): string {
   if (isUnsupportedZodError(error)) {