Managed Shopify plugin validators ship without required runtime dependencies

Open 💬 0 comments Opened Jul 22, 2026 by davetanguay-envision

What issue are you seeing?

The official shopify@openai-curated managed plugin installs successfully and appears as enabled, but its Liquid and Hydrogen validator scripts cannot run from the clean managed-plugin installation because required npm dependencies are missing.

Environment:

  • Codex Desktop on Windows
  • Node.js v24.14.0
  • Installation command: codex plugin add shopify@openai-curated
  • Curated plugin manifest version: 1.3.3
  • Shopify skill version: 1.9.1
  • Installed snapshot: 2f1a8948

The Liquid validator fails immediately with:

Error [ERR_MODULE_NOT_FOUND]: Cannot find package '@shopify/theme-check-common'

The Hydrogen validator fails immediately with:

Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'typescript'

The installed plugin contains the skill scripts and package manifests, but the required dependencies have not been included or installed in the managed plugin cache.

I tested dependency installation only in isolated temporary copies without modifying the managed cache. Installing the Liquid dependencies made its validator work. However, a normal Hydrogen dependency installation failed with an ERESOLVE conflict between @shopify/hydrogen@2026.1.3 and the pinned @react-router/dev version.

Forcing the Hydrogen installation with --legacy-peer-deps made the script execute, but it still did not recognize the core Hydrogen Money component as something it could validate.

This means the official managed plugin is installed and enabled, but important executable helpers included with its Liquid and Hydrogen skills are not usable from a clean installation.

What steps can reproduce the bug?

  1. On Windows with Node.js installed, open PowerShell.
  1. Install the official curated Shopify plugin:

codex plugin add shopify@openai-curated

  1. Confirm that the plugin is installed and enabled:

codex plugin list

  1. Define the installed plugin path:

$pluginRoot = "$env:USERPROFILE\.codex\plugins\cache\openai-curated\shopify\2f1a8948"

  1. Optionally disable validator instrumentation for the current PowerShell process:

$env:OPT_OUT_INSTRUMENTATION = "true"

  1. Run the Liquid validator script:

node "$pluginRoot\skills\shopify-liquid\scripts\validate.mjs" --help

  1. Observe that it exits with an ERR_MODULE_NOT_FOUND error for @shopify/theme-check-common.
  1. Run the Hydrogen validator script:

node "$pluginRoot\skills\shopify-hydrogen\scripts\validate.mjs" --help

  1. Observe that it exits with an ERR_MODULE_NOT_FOUND error for typescript.

These failures occur immediately after a clean managed-plugin installation without making any changes to the plugin cache.

What is the expected behavior?

_No response_

Additional information

_No response_

View original on GitHub ↗