shadcn + cmdk Version Drift : Filter Signature, Value Case, Vaul Focus, and the Hidden Wrapper Coupling

The shadcn Command primitive is a thin React wrapper around the third-party cmdk library (https://github.com/pacocoursey/cmdk). The wrapper is copied into your repo at components/ui/command.tsx by shadcn add command. The wrapper is generated against the cmdk version the registry was built against at that moment. Your package.json then carries its OWN copy of cmdk under dependencies. Those two pins can drift apart, and when they do the symptoms are always one of three : items will not filter, items will not click, or CommandItem rendered outside CommandList crashes with TypeError : undefined is not iterable (cannot read property Symbol(Symbol.iterator)).

This skill documents the six drift cases that surface as three of the top-15 issues in shadcn-ui/ui by reaction count (#2944, #2980, #3051) and the fix workflow.

Companion skills :