$ the-wire · showcase
Typed JSON across theme commands, Hydrogen branch map
By RepoJournal · Filed · About Shopify · Composed from the cited sources · methodology
2 people shipped this
Shopify/cli turned five theme subcommands into machine-readable interfaces behind --json, and Hydrogen documented the branch split it created when the new version took over main on 2026-10-09.
Add typed JSON output to theme check Shopify/cli
Theme Check now emits valid, flat issues with consistent severity counts, absolute file paths and zero-based camelCase positions on the JSON path, so existing parsers of the human-readable output see a different shape only when they opt in. Completed validation is retained across environment batches and the blocking policy is still honored.
Add typed JSON output to theme package Shopify/cli
The package command returns a strict JSON artifact result containing a validated absolute path to the ZIP actually written, while the text presenter stays untouched. That gives CI a receipt it can point at without scraping stdout.
Add typed JSON output to theme metafields pull Shopify/cli
Metafields pull returns strict flattened definitions, absolute artifact paths and explicit success, partial, skipped or cancelled outcomes. The native owner-keyed metafields.json file and successful downloads are preserved.
Add typed JSON output to theme init Shopify/cli
Theme init returns an absolute project directory and instruction file paths with explicit success or partial outcomes, keeps a successfully cloned project when later AI setup fails, and exits nonzero on partial work.
Add hydrogen-branches skill mapping the new vs classic Hydrogen branches Shopify/hydrogen
The repo's branch split was undocumented: preview's tree replaced classic Hydrogen's content on main, and classic moved to the 2026-04 back-fix branch. The new hydrogen-branches skill records that mapping so rebasing and back-ports stop requiring git archaeology, and the repo's previous branch map in AGENTS.md was removed alongside it.
