$ the-wire · showcase
Theme tooling goes machine-readable, docs drift breaks CI
By RepoJournal · Filed · About Shopify · Composed from the cited sources · methodology
The Shopify CLI shipped a coherent agent-facing surface for theme development (JSONL streaming, finite scripted console sessions, historical app logs) while Hydrogen started enforcing that its published reference matches source.
Add finite JSON execution to theme console Shopify/cli
theme console gains repeatable --script and mutually exclusive --script-file flags, running commands sequentially in one Liquid session and exiting; --json requires supplied commands and returns a typed document with ordered results that preserve native values and assignments. This is what lets an agent evaluate Liquid without driving an interactive terminal.
Add JSONL output to theme dev Shopify/cli
This is the other half of the automation story: --json (-j) streams the same JSONL bytes to stdout and the Dev Instance log, with records carrying only timestamp and message. Setup diagnostics moved to stderr and fatal CLI errors use the standard JSON error envelope on stdout, so a stream consumer can parse output without heuristics.
ci: fail when generated shopify.dev docs are out of date Shopify/hydrogen
The shopify.dev Hydrogen reference is generated from the committed packages/hydrogen/docs/generated/generated_docs_data_v2.json, and nothing checked that file against source, so it had drifted. The file is regenerated here and a CI step now fails when it goes stale; since the nightly sync reads whatever is committed on main, stale means wrong on the live docs.
Fix Cloudflare tunnel crash errors when stopping app dev on Windows Shopify/cli
Stopping an app dev session on Windows could report the Cloudflare tunnel as crashed, because final process-tree cleanup killed the tunnel without marking its exit as an expected stop. The tunnel now stops through the dev session's abort signal before cleanup and is released on preparation, process-setup, or session failure, while unexpected tunnel failures are still reported.
Add window.Shopify.application runtime metadata global (#4238) Shopify/hydrogen
Rendered Hydrogen pages now expose window.Shopify.application with a version and name: "hydrogen" payload, filled by the Shopify global bootstrap script. Previously the only version signal was the server-side X-Hydrogen-Version header on Storefront API subrequests, which page scripts never see. The long tail: the hidden shopify app logs-next command adds historical webhook delivery and GraphQL ...