Explore commerce context hooks for WooCommerce-aware conversion

[chubes4]

Problem

Block Format Bridge currently orchestrates general content conversion between static HTML and WordPress blocks. A future WooCommerce site-generation experiment may need a clean extension seam for passing commerce context from Static Site Importer into HTML-to-block conversion.

This should avoid hard-coupling every converter layer to WooCommerce while still allowing product-aware conversions when product data exists.

Related Studio issue: Automattic/studio#3323
Likely Studio experiment base: Automattic/studio#3309

Proposed direction

Explore whether BFB needs explicit context hooks/options for commerce-aware conversion, such as:

• product data available for the current source file
• product-card selector hints from SSI
• replacement placeholders for product collections
• diagnostics for low-confidence commerce conversion
• a way to preserve normal non-commerce behavior unchanged

Questions

• Can SSI pass product context into h2bc through existing BFB options?
• Do Woo-aware transforms belong fully in h2bc, or should BFB expose a generic context/diagnostics channel?
• How should fallback/diagnostic events represent commerce-specific approximations?

Acceptance criteria for an experiment

• Determine whether existing BFB APIs are enough for SSI + h2bc WooCommerce support.
• If not, add a minimal generic context/diagnostics seam, not Woo-specific hardcoding unless unavoidable.
• Existing conversion behavior remains unchanged without commerce context.

Links

• Studio WooCommerce exploration: Explore WooCommerce support for Studio site generation Automattic/studio#3323
• Studio SSI draft PR: Experiment: use Static Site Importer for generated local sites Automattic/studio#3309
• Block Format Bridge: https://github.com/chubes4/block-format-bridge
• Static Site Importer: https://github.com/chubes4/static-site-importer
• HTML to Blocks Converter: https://github.com/chubes4/html-to-blocks-converter

AI assistance

• AI assistance: Yes
• Tool(s): OpenCode (gpt-5.5)
• Used for: Drafting the companion BFB seam issue for a future WooCommerce generation experiment; Chris remains responsible for review and prioritization.

[chubes4]

Scoped primitive split for fleet cooking:

• Context passthrough primitive: Pass generic conversion context through HTML-to-blocks calls #93
• h2bc raw-handler context dependency: Thread raw-handler context into transform callbacks html-to-blocks-converter#228
• h2bc gated product-grid fixture: Add gated product-grid fixture for commerce-aware conversion html-to-blocks-converter#229
• SSI manifest contract: Define and validate a products.json store import contract static-site-importer#113
• SSI product seeding: Seed WooCommerce products from validated store manifest static-site-importer#112
• SSI product context forwarding: Pass validated product context into page conversion static-site-importer#111
• Pre-Studio fixture validation: Add fixture-level WooCommerce import validation for SSI primitives homeboy-rigs#39

Strategy: land generic context plumbing first, then SSI manifest/product primitives, then h2bc commerce-aware conversion behavior, then Homeboy validation. No Studio changes are needed for this ladder.

AI assistance: OpenCode (gpt-5.5) drafted this tracker split; Chris remains responsible for prioritization and review.

[chubes4]

Closing per cleanup request before restarting the full QHOLE generation pipeline.