T-VTI6-zod-version-pin-guard-test

Status: closed/done · Impact: medium · Complexity: small

Goal

The registry-driven CLI adapter introspects zod schemas to derive commander flags, reading zod’s internal _def layout. That layout is zod-major-version-specific and undocumented, so a zod major upgrade can silently break CLI flag generation with no failing test. This task adds a version-pin guard test so such a break surfaces as a named failure instead of silent breakage.

Spawned-task brief from T-0014:

The registry-driven CLI adapter (plugin/cli/registry_adapter.ts) derives commander flags by reading zod@3.25.76’s classic v3 _def internal layout, discovered by trial against the live dependency. A zod v4 (or later major) upgrade reshapes _def and would silently break CLI flag generation with no failing test. Add a version-pin guard test alongside the zod-introspection helpers that asserts the installed zod major matches the layout the helpers assume, turning a silent break into a named, actionable failure on upgrade.