@runwell/shopify-toolkit 0.17.4 → 0.18.0

package/bin/runwell-shopify

@@ -44,7 +44,10 @@ function help() {
 
 Commands:
   sync                            Apply runwell.config.json to the target theme
-  list                            List available + installed modules
+  list                            List available + installed modules.
+                                  --tenants prints a cross-tenant matrix
+                                  (tenants x baseline pin x toolkit pin x
+                                  drift) read from shopify-toolkit-deployments.json.
   add <module>                    Enable a module in runwell.config.json
   remove <module>                 Disable + clean a module's files
   doctor                          Detect drift between manifest and theme

package/lib/list.js

@@ -1,8 +1,16 @@
 import path from 'node:path';
 import fs from 'node:fs';
+import os from 'node:os';
 import { listAvailableModules, loadModuleManifest, loadConfig } from './config-loader.js';
 
 export async function list(flags) {
+  if (flags.tenants) {
+    return listTenants(flags);
+  }
+  return listModules(flags);
+}
+
+function listModules(flags) {
   const available = listAvailableModules(flags.toolkitRoot);
 
   let installed = new Set();
@@ -29,3 +37,115 @@ export async function list(flags) {
 
   console.log(`\nTotal: ${available.length} modules. Installed in current config: ${installed.size}.`);
 }
+
+function listTenants(flags) {
+  const registryPath = resolveRegistryPath(flags);
+  if (!registryPath) {
+    console.error('Could not locate shopify-toolkit-deployments.json.');
+    console.error('Pass --registry <path>, set RUNWELL_DEPLOYMENT_REGISTRY env var, or place the file at ~/Documents/Code/claude-PM/infrastructure/config/shopify-toolkit-deployments.json');
+    process.exit(1);
+  }
+
+  const registry = JSON.parse(fs.readFileSync(registryPath, 'utf-8'));
+  const deployments = registry.deployments || {};
+  const tenants = Object.entries(deployments);
+
+  if (tenants.length === 0) {
+    console.log('No tenants in registry.');
+    return;
+  }
+
+  const toolkitCurrent = readToolkitVersion(flags.toolkitRoot);
+
+  console.log(`Runwell Shopify tenants (registry: ${registryPath})\n`);
+  console.log(`Toolkit current: ${toolkitCurrent}\n`);
+  console.log('  Tenant     Store                                        Baseline pin                       Config pin    Synced ver   Modules  Drift  Status');
+  console.log('  ---------  -------------------------------------------  ---------------------------------  ------------  -----------  -------  -----  ----------');
+
+  let drifters = 0;
+
+  for (const [slug, t] of tenants.sort((a, b) => a[0].localeCompare(b[0]))) {
+    const store = (t.store || '?').padEnd(43);
+    const tenantConfig = readTenantConfig(t.theme_repo_local);
+    const basePin = (tenantConfig?.baseline || t.baseline || '?').padEnd(33);
+    const configPin = (tenantConfig?.toolkit_version || '?').padEnd(12);
+    const syncedVer = (readManifestToolkit(t.theme_repo_local) || '?').padEnd(11);
+    const moduleCount = (t.modules_enabled || []).length.toString().padEnd(7);
+    const drift = computeDrift(tenantConfig?.toolkit_version, toolkitCurrent);
+    if (drift !== 'ok') drifters++;
+    const driftStr = drift.padEnd(5);
+    const status = (t.status || '?');
+    console.log(`  ${slug.padEnd(9)}  ${store}  ${basePin}  ${configPin}  ${syncedVer}  ${moduleCount}  ${driftStr}  ${status}`);
+  }
+
+  console.log(`\nTotal: ${tenants.length} tenants. Drift: ${drifters} of ${tenants.length} pinned below toolkit current (${toolkitCurrent}).`);
+
+  if (flags.verbose) {
+    console.log('\nLegend:');
+    console.log('  Baseline pin: from runwell.config.json baseline field (truth source).');
+    console.log('  Config pin:   from runwell.config.json toolkit_version (truth source). ^X.Y.Z accepts forward minor bumps.');
+    console.log('  Synced ver:   actual toolkit version recorded by the last `runwell-shopify sync` (from runwell-manifest.json).');
+    console.log('  Drift:        "ok" if config-pin minor >= toolkit-current minor; "stale" if behind. "stale" with synced=current means the files are current but the pin lies.');
+  }
+}
+
+function resolveRegistryPath(flags) {
+  if (flags.registry) {
+    return path.resolve(flags.registry);
+  }
+  if (process.env.RUNWELL_DEPLOYMENT_REGISTRY) {
+    return path.resolve(process.env.RUNWELL_DEPLOYMENT_REGISTRY);
+  }
+  const guesses = [
+    path.join(os.homedir(), 'Documents/Code/claude-PM/infrastructure/config/shopify-toolkit-deployments.json'),
+    path.resolve(flags.toolkitRoot, '../claude-PM/infrastructure/config/shopify-toolkit-deployments.json'),
+  ];
+  return guesses.find(p => fs.existsSync(p));
+}
+
+function readToolkitVersion(toolkitRoot) {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(toolkitRoot, 'package.json'), 'utf-8'));
+    return pkg.version;
+  } catch {
+    return null;
+  }
+}
+
+function readManifestToolkit(themeRepoLocal) {
+  if (!themeRepoLocal) return null;
+  const manifestPath = path.join(themeRepoLocal, 'runwell-manifest.json');
+  if (!fs.existsSync(manifestPath)) return null;
+  try {
+    const m = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    return m.toolkit_version || null;
+  } catch {
+    return null;
+  }
+}
+
+function readTenantConfig(themeRepoLocal) {
+  if (!themeRepoLocal) return null;
+  const configPath = path.join(themeRepoLocal, 'runwell.config.json');
+  if (!fs.existsSync(configPath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function computeDrift(pin, current) {
+  if (!pin || !current) return '?';
+  const pinMinor = extractMinor(pin);
+  const curMinor = extractMinor(current);
+  if (pinMinor == null || curMinor == null) return '?';
+  if (pinMinor >= curMinor) return 'ok';
+  return 'stale';
+}
+
+function extractMinor(version) {
+  const m = String(version).match(/(\d+)\.(\d+)/);
+  if (!m) return null;
+  return parseInt(m[1], 10) * 1000 + parseInt(m[2], 10);
+}

package/modules/INDEX.md

@@ -3,45 +3,49 @@
 Auto-generated by `scripts/generate-index.mjs`. Do not edit by hand.
 Skills (shopify-storefront, shopify-cro, shopify-cli-ops, shopify-admin-browser) grep this file before writing custom Liquid.
 
-Total modules: 34.
+Total modules: 38.
 
 ## By category
 
+- **branding**: care-coaching-medvi, product-trio-medvi
 - **catalog**: bundle-builder, quantity-breaks, subscriptions
 - **conversion**: cart-cross-sell, cart-freeship-progress, cart-usps, exit-intent, gift-with-purchase, post-purchase-upsell, quick-view, risk-reversal, shipping-bar, sticky-atc
 - **customer**: loyalty-tiers, wishlist
 - **pdp**: comparison-table, delivery-estimate, inventory-urgency, pdp-ingredients, pdp-journal-link, pdp-trust-checks, recently-viewed
-- **social-proof**: press-bar, product-badges, reviews, scrolling-ticker, social-proof-banner, stats-bar, testimonials, trust-badges
-- **storefront**: editorial-block, editorial-hero, faq, how-it-works
+- **social-proof**: press-bar, product-badges, reviews, scrolling-ticker, social-proof-banner, stats-bar, testimonials, testimonials-medvi, trust-badges
+- **storefront**: collection-block-medvi, editorial-block, editorial-hero, faq, how-it-works
 
 ## Modules
 
 | Name | Category | Replaces | Files | Config keys | Variants | Admin steps |
 |---|---|---|---|---|---|---|
 | `bundle-builder` | catalog | BYOB-style bundle apps | sections:1 assets:1 | heading, sale_prefix, show_rating, rating_score, rating_count, show_trust_badges, trust_1, trust_2, trust_3, fomo_mode, fomo_cycle_days, fomo_stock_count | (none) | (none) |
+| `care-coaching-medvi` | branding | (native build) | sections:1 snippets:1 assets:1 | section_eyebrow, headline_pre, headline_post, headline_accent_color, block_heading, circular_text, circular_text_position, footer_link_label, layout, bg_band | (none) | (none) |
 | `cart-cross-sell` | conversion | Rebuy / OneClickUpsell pre-purchase upsell | snippets:1 | eyebrow, cta_label | (none) | (none) |
 | `cart-freeship-progress` | conversion | Bold Free Shipping Manager and similar app features | snippets:1 | threshold_cents, away_text, unlocked_message | (none) | (none) |
 | `cart-usps` | conversion | (native build) | snippets:1 | icon, usp_1, usp_2, usp_3 | (none) | (none) |
+| `collection-block-medvi` | storefront | (native build) | sections:1 assets:1 | eyebrow, headline_pre, headline_post, headline_accent_color, show_product_card, product_card_bg, benefits_heading, subhead, cta_label, layout, bg_band | (none) | (none) |
 | `comparison-table` | pdp | app-driven comparison widgets |  | eyebrow, heading, lede, background_color, text_color | feature-columns, feature-rows | (none) |
 | `delivery-estimate` | pdp | (native build) | snippets:1 | (none) | (none) | (none) |
-| `editorial-block` | storefront | (native build) | sections:1 | eyebrow, heading, lede, background_color, text_color | (none) | (none) |
+| `editorial-block` | storefront | (native build) | sections:1 assets:1 | eyebrow, heading, lede, background_color, text_color | (none) | (none) |
 | `editorial-hero` | storefront | Dawn's image-banner / video-banner |  | eyebrow, heading, subheading | video-bg, hero-with-card | (none) |
-| `exit-intent` | conversion | Privy / Justuno display layer | sections:1 assets:1 | eyebrow, heading, lede | (none) | (none) |
-| `faq` | storefront | (native build) | sections:1 | eyebrow, heading, background_color, text_color | (none) | (none) |
+| `exit-intent` | conversion | Privy / Justuno display layer | sections:1 assets:2 | eyebrow, heading, lede | (none) | (none) |
+| `faq` | storefront | (native build) | sections:1 assets:1 | eyebrow, heading, background_color, text_color | (none) | (none) |
 | `gift-with-purchase` | conversion | (native build) | snippets:1 assets:1 | threshold_cents, gift_handle, unlocked_message, locked_message_suffix | (none) | create-gift-product + create-gift-discount |
-| `how-it-works` | storefront | (native build) | sections:1 | eyebrow, heading, lede, image, asset_filename, background_color, text_color, cta_label, cta_link | (none) | (none) |
+| `how-it-works` | storefront | (native build) | sections:1 assets:1 | eyebrow, heading, lede, image, asset_filename, background_color, text_color, cta_label, cta_link | (none) | (none) |
 | `inventory-urgency` | pdp | (native build) | snippets:1 | (none) | (none) | (none) |
-| `loyalty-tiers` | customer | (native build) | sections:1 | tier_0_name, tier_1_name, tier_1_threshold, tier_1_perk_pct, tier_2_name, tier_2_threshold, tier_2_perk_pct | (none) | create-tier-tags-and-flows + create-tier-discounts + add-tier-card-to-account |
+| `loyalty-tiers` | customer | (native build) | sections:1 assets:1 | tier_0_name, tier_1_name, tier_1_threshold, tier_1_perk_pct, tier_2_name, tier_2_threshold, tier_2_perk_pct | (none) | create-tier-tags-and-flows + create-tier-discounts + add-tier-card-to-account |
 | `pdp-ingredients` | pdp | (native build) | sections:1 | eyebrow, heading, lede, background_color, text_color | (none) | (none) |
 | `pdp-journal-link` | pdp | (native build) | sections:1 | eyebrow, article, background_color, text_color, fallback_title, fallback_body, fallback_link_label, fallback_link_url | (none) | (none) |
 | `pdp-trust-checks` | pdp | (native build) | sections:1 | eyebrow, heading, lede, background_color, text_color, link_label, link_url | (none) | (none) |
 | `post-purchase-upsell` | conversion | Reconvert / OneClickUpsell / AfterSell display layer | assets:2 | discount_code, discount_label, max_items, heading, eyebrow, lede, cross_category_logic | (none) | create-discount + paste-bootstrap |
 | `press-bar` | social-proof | (native build) | sections:1 | eyebrow, background_color, text_color | (none) | (none) |
 | `product-badges` | social-proof | (native build) | snippets:1 | label_best_seller, label_new, label_editor_pick | (none) | (none) |
+| `product-trio-medvi` | branding | (native build) | sections:1 assets:1 | panel_heading, panel_bg, layout, bg_band | (none) | (none) |
 | `quantity-breaks` | catalog | (native build) | snippets:1 | eyebrow, fineprint | (none) | define-breaks-metafield + set-product-breaks + create-discount-function |
 | `quick-view` | conversion | (native build) | snippets:2 assets:1 | (none) | (none) | (none) |
-| `recently-viewed` | pdp | (native build) | sections:1 assets:1 | eyebrow, heading, background_color | (none) | (none) |
-| `reviews` | social-proof | (native build) | sections:1 | heading | (none) | (none) |
+| `recently-viewed` | pdp | (native build) | sections:1 assets:2 | eyebrow, heading, background_color | (none) | (none) |
+| `reviews` | social-proof | (native build) | sections:1 assets:1 | heading | (none) | (none) |
 | `risk-reversal` | conversion | (native build) | sections:1 | icon, heading, body, link_label, link_url, background_color, text_color | (none) | (none) |
 | `scrolling-ticker` | social-proof | announcement-bar / scrolling-text apps | sections:1 assets:1 | (none) | (none) | (none) |
 | `shipping-bar` | conversion | (native build) | sections:1 | threshold_cents, message_below, message_qualified, message_default, background_color, text_color | (none) | (none) |
@@ -50,8 +54,9 @@ Total modules: 34.
 | `sticky-atc` | conversion | Sticky Add To Cart Booster Pro and similar | sections:1 assets:1 | (none) | (none) | (none) |
 | `subscriptions` | catalog | Recharge / Bold Subscriptions / Appstle for the storefront display layer; subscription management still uses Shopify's native customer account | snippets:1 | one_time_label, subscribe_label, fineprint | (none) | install-shopify-subscriptions + create-selling-plan-group + enable-customer-account-tab |
 | `testimonials` | social-proof | app-driven review widgets at the social-proof display layer |  | eyebrow, heading, background_color, text_color | grid-quotes, carousel-ugc | (none) |
+| `testimonials-medvi` | social-proof | (native build) | sections:1 assets:1 | section_eyebrow, headline_pre, headline_post, headline_accent_color, lede, card_bg, star_color, bg_band | (none) | (none) |
 | `trust-badges` | social-proof | (native build) | sections:1 | background_color, text_color | (none) | (none) |
-| `wishlist` | customer | Wishlist Plus, Wishlist King, Globo Wishlist | sections:1 snippets:1 assets:1 templates:1 | max_items | (none) | create-wishlist-page |
+| `wishlist` | customer | Wishlist Plus, Wishlist King, Globo Wishlist | sections:1 snippets:1 assets:2 templates:1 | max_items | (none) | create-wishlist-page |
 
 ## Descriptions
 
@@ -63,6 +68,13 @@ Total modules: 34.
 - Files: sections:1 assets:1
 - Config: heading, sale_prefix, show_rating, rating_score, rating_count, show_trust_badges, trust_1, trust_2, trust_3, fomo_mode, fomo_cycle_days, fomo_stock_count
 
+### care-coaching-medvi
+
+- Category: branding
+- What: Brand-promise section: portrait card + circular rotating text mark + 2-color headline + body + footer CTA line.
+- Files: sections:1 snippets:1 assets:1
+- Config: section_eyebrow, headline_pre, headline_post, headline_accent_color, block_heading, circular_text, circular_text_position, footer_link_label, layout, bg_band
+
 ### cart-cross-sell
 
 - Category: conversion
@@ -86,6 +98,13 @@ Total modules: 34.
 - Files: snippets:1
 - Config: icon, usp_1, usp_2, usp_3
 
+### collection-block-medvi
+
+- Category: storefront
+- What: Duplex category section: product hero card on one side; eyebrow + split-color headline + benefits checklist + 2 lifestyle photos + CTA on the other.
+- Files: sections:1 assets:1
+- Config: eyebrow, headline_pre, headline_post, headline_accent_color, show_product_card, product_card_bg, benefits_heading, subhead, cta_label, layout, bg_band
+
 ### comparison-table
 
 - Category: pdp
@@ -104,7 +123,7 @@ Total modules: 34.
 
 - Category: storefront
 - What: Editorial introduction block: eyebrow + serif italic heading + lede + body.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: eyebrow, heading, lede, background_color, text_color
 
 ### editorial-hero
@@ -120,14 +139,14 @@ Total modules: 34.
 - Category: conversion
 - Replaces: Privy / Justuno display layer
 - What: Exit-intent popup with email capture.
-- Files: sections:1 assets:1
+- Files: sections:1 assets:2
 - Config: eyebrow, heading, lede
 
 ### faq
 
 - Category: storefront
 - What: FAQ accordion.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: eyebrow, heading, background_color, text_color
 
 ### gift-with-purchase
@@ -142,7 +161,7 @@ Total modules: 34.
 
 - Category: storefront
 - What: How-it-works section: side-image + multi-step explainer.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: eyebrow, heading, lede, image, asset_filename, background_color, text_color, cta_label, cta_link
 
 ### inventory-urgency
@@ -155,7 +174,7 @@ Total modules: 34.
 
 - Category: customer
 - What: Lifetime-spend tier card on the customer account page.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: tier_0_name, tier_1_name, tier_1_threshold, tier_1_perk_pct, tier_2_name, tier_2_threshold, tier_2_perk_pct
 - Admin steps: create-tier-tags-and-flows + create-tier-discounts + add-tier-card-to-account
 
@@ -203,6 +222,13 @@ Total modules: 34.
 - Files: snippets:1
 - Config: label_best_seller, label_new, label_editor_pick
 
+### product-trio-medvi
+
+- Category: branding
+- What: 3-product showcase, fan layout with center product foregrounded, soft-corner copy panel beside.
+- Files: sections:1 assets:1
+- Config: panel_heading, panel_bg, layout, bg_band
+
 ### quantity-breaks
 
 - Category: catalog
@@ -221,14 +247,14 @@ Total modules: 34.
 
 - Category: pdp
 - What: recently viewed.
-- Files: sections:1 assets:1
+- Files: sections:1 assets:2
 - Config: eyebrow, heading, background_color
 
 ### reviews
 
 - Category: social-proof
 - What: PDP reviews.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: heading
 
 ### risk-reversal
@@ -290,6 +316,13 @@ Total modules: 34.
 - Config: eyebrow, heading, background_color, text_color
 - Variants: grid-quotes, carousel-ugc
 
+### testimonials-medvi
+
+- Category: social-proof
+- What: Two horizontal marquee rows of testimonial cards.
+- Files: sections:1 assets:1
+- Config: section_eyebrow, headline_pre, headline_post, headline_accent_color, lede, card_bg, star_color, bg_band
+
 ### trust-badges
 
 - Category: social-proof
@@ -302,7 +335,7 @@ Total modules: 34.
 - Category: customer
 - Replaces: Wishlist Plus, Wishlist King, Globo Wishlist
 - What: Native wishlist using localStorage.
-- Files: sections:1 snippets:1 assets:1 templates:1
+- Files: sections:1 snippets:1 assets:2 templates:1
 - Config: max_items
 - Admin steps: create-wishlist-page
 

package/modules/_shared/css-tokens/assets/runwell-tokens.css

@@ -1,7 +1,10 @@
-/* Runwell Shopify Toolkit: brand tokens.
-   Generated from runwell.config.json brand vars. Every other module
-   references these via var(--runwell-X). Do not hand-edit in client
-   themes; re-run runwell-shopify sync to update.
+/* Runwell Shopify Toolkit: brand and design tokens.
+
+   Section 1 (brand): generated from runwell.config.json brand vars.
+   Re-run runwell-shopify sync to update.
+
+   Section 2 (design system): toolkit-wide constants. Tenants override
+   in their own tenant-brand.css if they need a different scale.
 
    --runwell-tertiary is the canonical brand-tertiary token; the
    --runwell-rain-forrest alias is preserved for one minor cycle of
@@ -10,6 +13,7 @@
    brand.tertiary in runwell.config.json.
 */
 :root {
+  /* Brand colors (interpolated from runwell.config.json) */
   --runwell-primary: {{brand.primary}};
   --runwell-accent: {{brand.accent}};
   --runwell-cream: {{brand.cream}};
@@ -18,4 +22,20 @@
   --runwell-blue: {{brand.blue}};
   --runwell-tertiary: {{brand.tertiary}};
   --runwell-rain-forrest: {{brand.tertiary}};
+
+  /* Design system: semantic surfaces.
+     Components reference these so the theme controls the default look.
+     Tenants override in tenant-brand.css to retarget any brand color. */
+  --runwell-surface-card: var(--runwell-oat);
+  --runwell-surface-card-alt: color-mix(in srgb, var(--runwell-celadon) 18%, white);
+
+  /* Design system: corner radii */
+  --runwell-radius-sm: 4px;
+  --runwell-radius-md: 12px;
+  --runwell-radius-lg: 20px;
+  --runwell-radius-xl: 32px;
+
+  /* Design system: elevation */
+  --runwell-shadow-card: 0 2px 8px rgba(0, 0, 0, 0.04);
+  --runwell-shadow-elevated: 0 8px 24px rgba(0, 0, 0, 0.06);
 }

package/modules/_shared/css-tokens/module.json

@@ -1,8 +1,8 @@
 {
   "name": "_shared/css-tokens",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "category": "foundation",
-  "description": "CSS custom properties published as :root vars so every Runwell module pulls brand colors from one source. Always synced.",
+  "description": "CSS custom properties published as :root vars. Brand colors interpolated from runwell.config.json. Design system tokens (radii, shadows) hardcoded as toolkit-wide constants. Always synced.",
   "always_enabled": true,
   "files": {
     "assets": ["assets/runwell-tokens.css"]

package/modules/_shared/css-typography/assets/runwell-typography.css

@@ -4,6 +4,11 @@
    sliders in layout/theme.liquid) so every toolkit module renders type
    that scales uniformly when a merchant adjusts the sliders.
 
+   Sizes are Dawn-aligned. Dawn sets html font-size to
+   calc(var(--font-body-scale) * 62.5%), so 1rem equals 10px when body
+   scale is 1.0. Our tokens land in the readability range Dawn uses for
+   its own headings and captions (1.2rem to 1.8rem).
+
    Modules reference these via var(--runwell-X-size). Tenant CSS may also
    reference them directly OR compose its own scale-aware sizes using
    calc(var(--font-body-scale) * Xrem) and calc(var(--font-heading-scale) * Xrem).
@@ -11,13 +16,16 @@
    Do not hand-edit in client themes; re-run runwell-shopify sync to update.
 */
 :root {
-  /* Body-scale derived. Eyebrows, captions, ledes, body, CTAs. */
-  --runwell-eyebrow-size:  calc(var(--font-body-scale) * 0.78rem);
-  --runwell-caption-size:  calc(var(--font-body-scale) * 0.85rem);
-  --runwell-meta-size:     calc(var(--font-body-scale) * 0.92rem);
-  --runwell-cta-size:      calc(var(--font-body-scale) * 1.15rem);
+  /* Body-scale derived. Eyebrows, captions, meta, body, ledes, CTAs.
+     Dawn-aligned: smallest readable text at 1.2rem (12px), Dawn body at
+     1.5rem (15px), our body slightly larger at 1.6rem (16px) for
+     component readability inside cards and sections. */
+  --runwell-eyebrow-size:  calc(var(--font-body-scale) * 1.2rem);
+  --runwell-caption-size:  calc(var(--font-body-scale) * 1.3rem);
+  --runwell-meta-size:     calc(var(--font-body-scale) * 1.4rem);
+  --runwell-cta-size:      calc(var(--font-body-scale) * 1.5rem);
   --runwell-body-size:     calc(var(--font-body-scale) * 1.6rem);
-  --runwell-lede-size:     calc(var(--font-body-scale) * 1.7rem);
+  --runwell-lede-size:     calc(var(--font-body-scale) * 1.8rem);
 
   /* Heading-scale derived. Section titles, big numbers, hero/aura titles. */
   --runwell-h4-size: calc(var(--font-heading-scale) * 1.7rem);

package/modules/_shared/css-typography/module.json

@@ -1,8 +1,8 @@
 {
   "name": "_shared/css-typography",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "category": "foundation",
-  "description": "Typography tokens published as :root vars. Every Runwell module references these instead of hardcoding rem values, so type scale responds to Dawn's body_scale and heading_scale Theme Editor sliders. Always synced.",
+  "description": "Typography tokens published as :root vars. Every Runwell module references these instead of hardcoding rem values, so type scale responds to Dawn's body_scale and heading_scale Theme Editor sliders. Sizes are Dawn-aligned (eyebrow 1.2rem, body 1.6rem, etc.). Always synced.",
   "always_enabled": true,
   "files": {
     "assets": ["assets/runwell-typography.css"]

package/modules/care-coaching-medvi/README.md

@@ -0,0 +1,46 @@
+# care-coaching-medvi
+
+Brand-promise section. Centered eyebrow + 2-color headline at top; large portrait card on one side; block (heading + body) on the other; circular rotating text mark anchored to a corner of the section; footer eyebrow + link below.
+
+Category: `branding`
+
+The distinguishing visual is the **circular rotating text mark** ("WITH YOU FROM START TO SUCCESS" in medvi's reference), rendered as inline SVG `textPath` along a closed circle, slowly rotating via CSS animation. Respects `prefers-reduced-motion`.
+
+## Files
+
+- `sections/runwell-care-coaching-medvi.liquid`
+- `snippets/runwell-care-coaching-medvi-circular-text.liquid` (SVG textPath generator, isolated for reuse)
+- `assets/runwell-care-coaching-medvi.css`
+
+## Layout
+
+- Section eyebrow (centered, tracked uppercase) + 2-color split headline span across the top, full width.
+- Inner grid: portrait card on one side (4:5), block (eyebrow + heading + body) on the other.
+- Circular text mark anchored to a corner of the section (`top-right` default, `top-left` / `bottom-right` / `bottom-left` available).
+- Footer line: small eyebrow plus link, centered below the inner.
+
+## Tokens consumed
+
+Brand: `--runwell-primary`, `--runwell-tertiary`, `--runwell-oat`, `--runwell-blue`. Design system: `--runwell-radius-xl`. Typography: `--runwell-eyebrow-size`, `--runwell-h2-size`, `--runwell-h3-size`, `--runwell-body-size`, `--runwell-meta-size`.
+
+## Lineage
+
+Extracted from `https://home.medvi.org/` on 2026-05-06. Framer label: `Care Coaching`. Scrape path: `_clients/capital-v/lushi/research/medvi-reference/site-scrape/`.
+
+The medvi reference shot:
+- Eyebrow: `BETTER IS POSSIBLE, AND WE BUILT FOR IT.`
+- Headline: `Modern healthcare,` (black) `built around you` (green accent), centered.
+- Portrait: woman in beige sweater on warm-grey background.
+- Circular mark: `WITH YOU FROM START TO SUCCESS` in soft tan, top-right of inner card.
+
+## Tenant overrides
+
+- `runwell.config.json` brand block: rewires the global tokens.
+- Per-instance Theme Editor: section eyebrow, headline split, accent color, portrait + card tint, block heading/eyebrow/body, circular text content + color + corner position, footer eyebrow + link, layout (portrait-left vs portrait-right), bg band.
+
+## Notes
+
+- Circular mark animation: 30s per full turn, linear, infinite. Stops on `prefers-reduced-motion: reduce`.
+- The SVG `textPath` snippet uses `id_suffix: section.id` to avoid id collisions when the section is dropped multiple times on the same page.
+- Mobile: stacks portrait above block. Circular mark scales smaller and pulls in to corners.
+- Block has its own oat-tinted background by default to lift it visually from the white section bg, mirroring medvi's reference. Override via `portrait_card_bg`-style additions if a different background is needed.