climaybe 1.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Electric Maybe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -26,10 +26,12 @@ Interactive setup that configures your repo for CI/CD.
 1. Prompts for your store URL (e.g., `voldt-staging.myshopify.com`)
 2. Extracts subdomain as alias, lets you override
 3. Asks if you want to add more stores
-4. Based on store count, sets up **single-store** or **multi-store** mode
-5. Writes `package.json` config
-6. Scaffolds GitHub Actions workflows
-7. Creates git branches and store directories (multi-store)
+4. Asks whether to enable optional **preview + cleanup** workflows
+5. Asks whether to enable optional **build + Lighthouse** workflows
+6. Based on store count, sets up **single-store** or **multi-store** mode
+7. Writes `package.json` config
+8. Scaffolds GitHub Actions workflows
+9. Creates git branches and store directories (multi-store)
 
 ### `climaybe add-store`
 
@@ -83,6 +85,8 @@ The CLI writes config into the `config` field of your `package.json`:
   "config": {
     "port": 9295,
     "default_store": "voldt-staging.myshopify.com",
+    "preview_workflows": true,
+    "build_workflows": true,
     "stores": {
       "voldt-staging": "voldt-staging.myshopify.com",
       "voldt-norway": "voldt-norway.myshopify.com"
@@ -115,6 +119,8 @@ staging → main → staging-<store> → live-<store>
 - `staging-<store>` — per-store staging with store-specific JSON data
 - `live-<store>` — per-store production
 
+Direct pushes to `staging-<store>` or `live-<store>` are automatically synced back to `main` (no PR; multistore-hotfix-to-main merges the branch into main).
+
 ## Workflows
 
 ### Shared (both modes)
@@ -129,24 +135,50 @@ staging → main → staging-<store> → live-<store>
 | Workflow | Trigger | What it does |
 |----------|---------|-------------|
 | `release-pr-check.yml` | PR from `staging` to `main` | Generates changelog, creates pre-release patch tag, posts PR comment |
-| `post-merge-tag.yml` | Push to `main` (merged PR) | Detects release version from PR title, bumps minor version |
+| `post-merge-tag.yml` | Push to `main` (merged PR) | Staging→main: minor bump (e.g. v3.2.0). Hotfix sync: patch bump (e.g. v3.2.1) |
 | `nightly-hotfix.yml` | Cron 02:00 US Eastern | Tags untagged hotfix commits with patch version |
 
 ### Multi-store (additional)
 
 | Workflow | Trigger | What it does |
 |----------|---------|-------------|
-| `main-to-staging-stores.yml` | Push to `main` | Opens PRs to each `staging-<alias>` branch |
+| `main-to-staging-stores.yml` (main-to-staging-&lt;store&gt;) | Push to `main` | Opens PRs from main to each `staging-<alias>` branch |
 | `stores-to-root.yml` | Push to `staging-*` | Copies `stores/<alias>/` JSONs to repo root |
 | `pr-to-live.yml` | After stores-to-root | Opens PR from `staging-<alias>` to `live-<alias>` |
 | `root-to-stores.yml` | Push to `live-*` (hotfix) | Syncs root JSONs back to `stores/<alias>/` |
-| `hotfix-backport.yml` | After root-to-stores | Creates backport PR to `main` |
+| `multistore-hotfix-to-main.yml` | Push to `staging-*` or `live-*` (and after root-to-stores) | Automatically merges store branch into main (no PR); everything is synced back to main |
+
+### Optional preview + cleanup package
+
+Enabled via `climaybe init` prompt (`Enable preview + cleanup workflows?`).
+
+| Workflow | Trigger | What it does |
+|----------|---------|-------------|
+| `pr-update.yml` | PR opened/synchronize/reopened | Shares draft theme, renames with `-PR<number>`, comments preview + customize URLs |
+| `pr-close.yml` | PR closed | Deletes matching preview themes and comments deleted count + names |
+| `reusable-share-theme.yml` | workflow_call | Shares Shopify draft theme and returns `theme_id` |
+| `reusable-rename-theme.yml` | workflow_call | Renames shared theme to include `PR<number>` (fails job on rename failure) |
+| `reusable-comment-on-pr.yml` | workflow_call | Posts preview comment including Customize URL |
+| `reusable-cleanup-themes.yml` | workflow_call | Deletes preview themes by PR number and exposes cleanup outputs |
+| `reusable-extract-pr-number.yml` | workflow_call | Extracts padded/unpadded PR number outputs for naming and API-safe usage |
+
+### Optional build + Lighthouse package
+
+Enabled via `climaybe init` prompt (`Enable build + Lighthouse workflows?`).
+
+| Workflow | Trigger | What it does |
+|----------|---------|-------------|
+| `build-pipeline.yml` | Push to `main/staging/develop` | Runs reusable build and Lighthouse checks (when required secrets exist) |
+| `reusable-build.yml` | workflow_call | Runs Node build + Tailwind compile, then commits compiled assets when changed |
+| `create-release.yml` | Push tag `v*` | Builds release archive and creates GitHub Release using `release-notes.md` |
 
 ## Versioning
 
-- **Release merge** (`staging` → `main`): Minor bump (e.g., `v3.1.x` → `v3.2.0`)
-- **Hotfix** (direct commit to `main` or `live-*`): Patch bump (e.g., `v3.2.0` → `v3.2.1`)
-- **PR title convention**: `Release v3.2` — the workflow extracts the version from this
+- **Version format**: Always three-part (e.g. `v3.2.0`). No two-part tags.
+- **Release merge** (`staging` → `main`): Minor bump (e.g. `v3.1.12` → `v3.2.0`)
+- **Hotfix sync** (`staging-<store>` or `live-<store>` → main via multistore-hotfix-to-main): Patch bump runs immediately (e.g. `v3.2.0` → `v3.2.1`)
+- **Other hotfixes** (direct commit to `main`): Patch bump via nightly workflow or manual run
+- **PR title convention**: `Release v3.2` or `Release v3.2.0` — the workflow normalizes to three-part
 
 All version bumps update `config/settings_schema.json` automatically.
 
@@ -163,7 +195,7 @@ All version bumps update `config/settings_schema.json` automatically.
 
 ## Recursive Trigger Prevention
 
-- Hotfix backport commits contain `[hotfix-backport]` in the message
+- Hotfix sync merge commits (multistore-hotfix-to-main) contain `[hotfix-backport]` in the message
 - Store sync commits contain `[stores-to-root]` or `[root-to-stores]`
 - Version bump commits contain `chore(release): bump version`
 - All workflows check for these flags and skip accordingly
@@ -175,6 +207,25 @@ Add the following secret to your GitHub repository:
 | Secret | Required | Description |
 |--------|----------|-------------|
 | `GEMINI_API_KEY` | Yes | Google Gemini API key for changelog generation |
+| `SHOPIFY_STORE_URL` | Optional* | Required only when optional preview workflows are enabled |
+| `SHOPIFY_CLI_THEME_TOKEN` | Optional* | Required only when optional preview workflows are enabled |
+| `SHOP_STORE` | Optional* | Required only when optional build workflows are enabled (Lighthouse) |
+| `SHOP_ACCESS_TOKEN` | Optional* | Required only when optional build workflows are enabled (Lighthouse) |
+| `LHCI_GITHUB_APP_TOKEN` | Optional* | Required only when optional build workflows are enabled (Lighthouse) |
+| `SHOP_PASSWORD` | Optional | Used by Lighthouse action when your store requires password auth |
+
+For multi-store deploy PR links, you can optionally define store-scoped secrets:
+
+- `SHOPIFY_STORE_URL_<ALIAS>`
+- `SHOPIFY_CLI_THEME_TOKEN_<ALIAS>`
+
+`<ALIAS>` must be uppercase with hyphens converted to underscores.  
+Example: alias `voldt-norway` → `SHOPIFY_STORE_URL_VOLDT_NORWAY`.
+
+Preview workflows also support the same scoped secret pattern and will use:
+
+1. `SHOPIFY_*_<ALIAS>`
+2. fallback to `SHOPIFY_*` (default)
 
 ## Directory Structure (Multi-store)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "climaybe",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Shopify CI/CD CLI — scaffolds workflows, branch strategy, and store config for single-store and multi-store theme repos",
   "type": "module",
   "bin": {
@@ -23,6 +23,12 @@
   ],
   "author": "Electric Maybe",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/electricmaybe/climaybe.git"
+  },
+  "bugs": "https://github.com/electricmaybe/climaybe/issues",
+  "homepage": "https://github.com/electricmaybe/climaybe#readme",
   "dependencies": {
     "commander": "^13.1.0",
     "picocolors": "^1.1.1",

package/src/commands/add-store.js

@@ -1,6 +1,6 @@
 import pc from 'picocolors';
 import { promptNewStore } from '../lib/prompts.js';
-import { readConfig, addStoreToConfig, getStoreAliases, getMode } from '../lib/config.js';
+import { readConfig, addStoreToConfig, getStoreAliases, getMode, isPreviewWorkflowsEnabled, isBuildWorkflowsEnabled } from '../lib/config.js';
 import { createStoreBranches } from '../lib/git.js';
 import { scaffoldWorkflows } from '../lib/workflows.js';
 import { createStoreDirectories } from '../lib/store-sync.js';
@@ -17,6 +17,8 @@ export async function addStoreCommand() {
 
   const existingAliases = getStoreAliases();
   const previousMode = getMode();
+  const includePreview = isPreviewWorkflowsEnabled();
+  const includeBuild = isBuildWorkflowsEnabled();
 
   // Prompt for new store
   const store = await promptNewStore(existingAliases);
@@ -42,11 +44,11 @@ export async function addStoreCommand() {
     createStoreDirectories(originalAlias);
 
     // Re-scaffold workflows for multi mode
-    scaffoldWorkflows('multi');
+    scaffoldWorkflows('multi', { includePreview, includeBuild });
     console.log(pc.green('  Migration complete — workflows updated to multi-store mode.'));
   } else if (newMode === 'multi') {
     // Already multi, just make sure workflows are current
-    scaffoldWorkflows('multi');
+    scaffoldWorkflows('multi', { includePreview, includeBuild });
   }
 
   console.log(pc.bold(pc.green('\n  Store added successfully!\n')));

package/src/commands/init.js

@@ -1,5 +1,5 @@
 import pc from 'picocolors';
-import { promptStoreLoop } from '../lib/prompts.js';
+import { promptStoreLoop, promptPreviewWorkflows, promptBuildWorkflows } from '../lib/prompts.js';
 import { readConfig, writeConfig } from '../lib/config.js';
 import { ensureGitRepo, ensureInitialCommit, ensureStagingBranch, createStoreBranches } from '../lib/git.js';
 import { scaffoldWorkflows } from '../lib/workflows.js';
@@ -20,6 +20,8 @@ export async function initCommand() {
   // 1. Collect stores from user
   const stores = await promptStoreLoop();
   const mode = stores.length > 1 ? 'multi' : 'single';
+  const enablePreviewWorkflows = await promptPreviewWorkflows();
+  const enableBuildWorkflows = await promptBuildWorkflows();
 
   console.log(pc.dim(`\n  Mode: ${mode}-store (${stores.length} store(s))`));
 
@@ -27,6 +29,8 @@ export async function initCommand() {
   const config = {
     port: 9295,
     default_store: stores[0].domain,
+    preview_workflows: enablePreviewWorkflows,
+    build_workflows: enableBuildWorkflows,
     stores: {},
   };
 
@@ -55,7 +59,10 @@ export async function initCommand() {
   }
 
   // 6. Scaffold workflows
-  scaffoldWorkflows(mode);
+  scaffoldWorkflows(mode, {
+    includePreview: enablePreviewWorkflows,
+    includeBuild: enableBuildWorkflows,
+  });
 
   // Done
   console.log(pc.bold(pc.green('\n  Setup complete!\n')));
@@ -70,6 +77,8 @@ export async function initCommand() {
     }
     console.log(pc.dim('  Workflow: staging → main → staging-<store> → live-<store>'));
   }
+  console.log(pc.dim(`  Preview workflows: ${enablePreviewWorkflows ? 'enabled' : 'disabled'}`));
+  console.log(pc.dim(`  Build workflows: ${enableBuildWorkflows ? 'enabled' : 'disabled'}`));
 
   console.log(pc.dim('\n  Next steps:'));
   console.log(pc.dim('    1. Add GEMINI_API_KEY to your GitHub repo secrets'));

package/src/commands/update-workflows.js

@@ -1,5 +1,5 @@
 import pc from 'picocolors';
-import { getMode, readConfig } from '../lib/config.js';
+import { getMode, isBuildWorkflowsEnabled, isPreviewWorkflowsEnabled, readConfig } from '../lib/config.js';
 import { scaffoldWorkflows } from '../lib/workflows.js';
 
 export async function updateWorkflowsCommand() {
@@ -12,7 +12,9 @@ export async function updateWorkflowsCommand() {
   }
 
   const mode = getMode();
-  scaffoldWorkflows(mode);
+  const includePreview = isPreviewWorkflowsEnabled();
+  const includeBuild = isBuildWorkflowsEnabled();
+  scaffoldWorkflows(mode, { includePreview, includeBuild });
 
   console.log(pc.bold(pc.green('\n  Workflows updated!\n')));
 }

package/src/lib/config.js

@@ -72,6 +72,22 @@ export function getMode(cwd = process.cwd()) {
   return aliases.length > 1 ? 'multi' : 'single';
 }
 
+/**
+ * Whether optional preview/cleanup workflows are enabled.
+ */
+export function isPreviewWorkflowsEnabled(cwd = process.cwd()) {
+  const config = readConfig(cwd);
+  return config?.preview_workflows === true;
+}
+
+/**
+ * Whether optional build/Lighthouse workflows are enabled.
+ */
+export function isBuildWorkflowsEnabled(cwd = process.cwd()) {
+  const config = readConfig(cwd);
+  return config?.build_workflows === true;
+}
+
 /**
  * Add a store entry to the config.
  * Returns the updated config.

package/src/lib/prompts.js

@@ -14,9 +14,24 @@ export function extractAlias(domain) {
  * Appends ".myshopify.com" if not present.
  */
 export function normalizeDomain(input) {
-  const trimmed = input.trim().toLowerCase();
-  if (trimmed.endsWith('.myshopify.com')) return trimmed;
-  return `${trimmed}.myshopify.com`;
+  const cleaned = input
+    .trim()
+    .toLowerCase()
+    .replace(/^https?:\/\//, '')
+    .replace(/\/.*$/, '')
+    .replace(/\s+/g, '');
+
+  if (!cleaned) return '';
+  if (cleaned.endsWith('.myshopify.com')) return cleaned;
+  return `${cleaned}.myshopify.com`;
+}
+
+/**
+ * Validate normalized Shopify store domain format.
+ * Expected: "<subdomain>.myshopify.com"
+ */
+export function isValidShopifyDomain(domain) {
+  return /^[a-z0-9][a-z0-9-]*\.myshopify\.com$/.test(domain);
 }
 
 /**
@@ -29,13 +44,20 @@ export async function promptStore(defaultDomain = '') {
     name: 'domain',
     message: 'Store URL',
     initial: defaultDomain,
-    validate: (v) =>
-      v.trim().length > 0 ? true : 'Store URL is required',
+    validate: (v) => {
+      if (v.trim().length === 0) return 'Store URL is required';
+      const normalized = normalizeDomain(v);
+      if (!normalized || !isValidShopifyDomain(normalized)) {
+        return 'Enter a valid Shopify domain (e.g. voldt-staging.myshopify.com)';
+      }
+      return true;
+    },
   });
 
   if (!domain) return null;
 
   const normalized = normalizeDomain(domain);
+  if (!isValidShopifyDomain(normalized)) return null;
   const suggestedAlias = extractAlias(normalized);
 
   const { alias } = await prompts({
@@ -98,6 +120,34 @@ export async function promptStoreLoop() {
   return stores;
 }
 
+/**
+ * Ask whether preview + cleanup workflows should be scaffolded.
+ */
+export async function promptPreviewWorkflows() {
+  const { enablePreviewWorkflows } = await prompts({
+    type: 'confirm',
+    name: 'enablePreviewWorkflows',
+    message: 'Enable preview + cleanup workflows?',
+    initial: false,
+  });
+
+  return !!enablePreviewWorkflows;
+}
+
+/**
+ * Ask whether build workflows should be scaffolded.
+ */
+export async function promptBuildWorkflows() {
+  const { enableBuildWorkflows } = await prompts({
+    type: 'confirm',
+    name: 'enableBuildWorkflows',
+    message: 'Enable build + Lighthouse workflows?',
+    initial: false,
+  });
+
+  return !!enableBuildWorkflows;
+}
+
 /**
  * Prompt for a single new store (used by add-store command).
  * Takes existing aliases to prevent duplicates.

package/src/lib/workflows.js

@@ -36,7 +36,7 @@ function copyWorkflow(srcDir, fileName, destDir) {
  * but for simplicity we track known filenames instead.
  */
 function getKnownWorkflowFiles() {
-  const dirs = ['shared', 'single', 'multi'];
+  const dirs = ['shared', 'single', 'multi', 'preview', 'build'];
   const files = new Set();
   for (const dir of dirs) {
     const dirPath = join(TEMPLATES_DIR, dir);
@@ -47,6 +47,9 @@ function getKnownWorkflowFiles() {
   return files;
 }
 
+/** Deprecated workflow filenames to remove when scaffolding (renamed or replaced). */
+const DEPRECATED_WORKFLOW_FILES = ['hotfix-backport.yml'];
+
 /**
  * Remove previously scaffolded climaybe workflows from target.
  */
@@ -56,7 +59,7 @@ function cleanWorkflows(cwd = process.cwd()) {
 
   const known = getKnownWorkflowFiles();
   for (const file of readdirSync(dest)) {
-    if (known.has(file)) {
+    if (known.has(file) || DEPRECATED_WORKFLOW_FILES.includes(file)) {
       rmSync(join(dest, file));
     }
   }
@@ -67,7 +70,8 @@ function cleanWorkflows(cwd = process.cwd()) {
  * - Always copies shared/ workflows.
  * - Copies single/ or multi/ (+ single/) based on mode.
  */
-export function scaffoldWorkflows(mode = 'single', cwd = process.cwd()) {
+export function scaffoldWorkflows(mode = 'single', options = {}, cwd = process.cwd()) {
+  const { includePreview = false, includeBuild = false } = options;
   const dest = ghWorkflowsDir(cwd);
   mkdirSync(dest, { recursive: true });
 
@@ -93,7 +97,23 @@ export function scaffoldWorkflows(mode = 'single', cwd = process.cwd()) {
     }
   }
 
+  if (includePreview) {
+    const previewDir = join(TEMPLATES_DIR, 'preview');
+    for (const f of listYmls(previewDir)) {
+      copyWorkflow(previewDir, f, dest);
+    }
+  }
+
+  if (includeBuild) {
+    const buildDir = join(TEMPLATES_DIR, 'build');
+    for (const f of listYmls(buildDir)) {
+      copyWorkflow(buildDir, f, dest);
+    }
+  }
+
   const total = readdirSync(dest).filter((f) => f.endsWith('.yml')).length;
   console.log(pc.green(`  Scaffolded ${total} workflow(s) → .github/workflows/`));
   console.log(pc.dim(`  Mode: ${mode}-store`));
+  console.log(pc.dim(`  Preview workflows: ${includePreview ? 'enabled' : 'disabled'}`));
+  console.log(pc.dim(`  Build workflows: ${includeBuild ? 'enabled' : 'disabled'}`));
 }

package/src/workflows/build/build-pipeline.yml

@@ -0,0 +1,57 @@
+# climaybe — Build Pipeline (Optional Build Package)
+
+name: Build Pipeline
+
+on:
+  push:
+    branches: [main, staging, develop]
+
+jobs:
+  build:
+    uses: ./.github/workflows/reusable-build.yml
+
+  lighthouse-ci:
+    runs-on: ubuntu-latest
+    needs: [build]
+    env:
+      SHOP_STORE: ${{ secrets.SHOP_STORE }}
+      SHOP_ACCESS_TOKEN: ${{ secrets.SHOP_ACCESS_TOKEN }}
+      LHCI_GITHUB_APP_TOKEN: ${{ secrets.LHCI_GITHUB_APP_TOKEN }}
+    steps:
+      - name: Check conditions and log skip reason
+        run: |
+          SKIP_REASONS=()
+
+          if [ "${{ github.ref }}" != "refs/heads/main" ] && [ "${{ github.ref }}" != "refs/heads/staging" ]; then
+            SKIP_REASONS+=("Not on main or staging branch (current: ${{ github.ref }})")
+          fi
+
+          if [ -z "$SHOP_STORE" ] || [ -z "$SHOP_ACCESS_TOKEN" ] || [ -z "$LHCI_GITHUB_APP_TOKEN" ]; then
+            SKIP_REASONS+=("Missing required secrets: SHOP_STORE, SHOP_ACCESS_TOKEN, or LHCI_GITHUB_APP_TOKEN")
+          fi
+
+          if [ ${#SKIP_REASONS[@]} -gt 0 ]; then
+            echo "Lighthouse CI skipped"
+            echo "Reasons:"
+            for reason in "${SKIP_REASONS[@]}"; do
+              echo "  - $reason"
+            done
+            exit 0
+          fi
+
+          echo "All conditions met, proceeding with Lighthouse CI"
+
+      - name: Checkout code
+        if: env.SHOP_STORE != '' && env.SHOP_ACCESS_TOKEN != '' && env.LHCI_GITHUB_APP_TOKEN != '' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/staging')
+        uses: actions/checkout@v4
+
+      - name: Lighthouse
+        if: env.SHOP_STORE != '' && env.SHOP_ACCESS_TOKEN != '' && env.LHCI_GITHUB_APP_TOKEN != '' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/staging')
+        uses: shopify/lighthouse-ci-action@v1
+        with:
+          store: ${{ secrets.SHOP_STORE }}
+          access_token: ${{ secrets.SHOP_ACCESS_TOKEN }}
+          password: ${{ secrets.SHOP_PASSWORD }}
+          lhci_github_app_token: ${{ secrets.LHCI_GITHUB_APP_TOKEN }}
+          lhci_min_score_performance: 0.9
+          lhci_min_score_accessibility: 0.9

package/src/workflows/build/create-release.yml

@@ -0,0 +1,52 @@
+name: Create Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create release archive
+        run: |
+          mkdir release-temp
+          mkdir -p .sys/release-notes
+
+          TAG_NAME=${GITHUB_REF#refs/tags/}
+          cp release-notes.md ".sys/release-notes/release-note-${TAG_NAME}.md"
+
+          for dir in assets layout locales sections snippets config; do
+            mkdir -p "release-temp/$dir"
+            find "$dir" -type f ! -name "*.md" -exec cp --parents {} release-temp/ \;
+          done
+
+          mkdir -p release-temp/templates
+          find templates -type f ! -name "*.md" ! -name "page.test-*" -exec cp --parents {} release-temp/ \;
+
+          find release-temp -type f -name "*.liquid" -exec sed -i '
+            /{% comment %}/{
+              N
+              /{% comment %}\s*\nINTERNAL/{
+                :a
+                N
+                /{% endcomment %}/!ba
+                d
+              }
+            }' {} \;
+
+          cd release-temp
+          zip -r ../release.zip ./*
+          cd ..
+          rm -rf release-temp
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: release.zip
+          body_path: release-notes.md
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/src/workflows/build/reusable-build.yml

@@ -0,0 +1,52 @@
+name: Build
+
+on:
+  workflow_call:
+    outputs:
+      build-success:
+        description: "Whether build was successful"
+        value: ${{ jobs.build.outputs.success }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      success: ${{ steps.build.outputs.success }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build scripts
+        run: node build-scripts.js
+
+      - name: Run Tailwind build
+        id: build
+        run: |
+          NODE_ENV=production npx @tailwindcss/cli -i _styles/main.css -o assets/style.css --minify
+          echo "success=true" >> $GITHUB_OUTPUT
+
+      - name: Commit and push changes
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          BRANCH_NAME=${{ github.head_ref || github.ref_name }}
+          git fetch origin "$BRANCH_NAME" || echo "Branch does not exist yet"
+          git checkout -B "$BRANCH_NAME" "origin/$BRANCH_NAME" 2>/dev/null || git checkout -B "$BRANCH_NAME"
+          git add -f assets/index.js assets/style.css
+          if git diff --staged --quiet; then
+            echo "No changes to commit"
+          else
+            git commit -m "Update compiled assets (JavaScript and CSS)"
+            git push origin "$BRANCH_NAME"
+          fi

package/src/workflows/multi/main-to-staging-stores.yml

@@ -1,7 +1,7 @@
-# climaybe — Main to Staging Stores (Multi-store)
+# climaybe — Main to Staging <store> (Multi-store)
 # When a PR is merged into main (from staging), this workflow
 # opens and auto-merges PRs from main to each staging-<alias> branch.
-# Skips hotfix backport commits to prevent recursive triggers.
+# Skips [hotfix-backport] and version-bump commits so multistore-hotfix-to-main syncs are not re-pushed to stores.
 
 name: Main to Staging Stores
 
@@ -72,6 +72,7 @@ jobs:
     permissions:
       contents: write
       pull-requests: write
+      actions: write
     env:
       GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     steps:
@@ -112,7 +113,47 @@ jobs:
 
             # Auto-merge
             PR_NUM=$(echo "$PR_URL" | grep -oP '\d+$')
-            gh pr merge "$PR_NUM" --merge --admin 2>/dev/null || echo "Auto-merge failed — manual review may be needed."
+            if gh pr merge "$PR_NUM" --merge --admin 2>/dev/null; then
+              echo "Auto-merge succeeded for $BRANCH"
+
+              # Explicitly trigger Stores to Root to avoid missing downstream runs
+              # when merges are performed by GITHUB_TOKEN-based automation.
+              gh workflow run "Stores to Root" --ref "$BRANCH" 2>/dev/null || \
+                echo "Failed to trigger Stores to Root for $BRANCH"
+
+              # Wait for the latest Stores to Root run on this branch to complete,
+              # then trigger PR to Live to keep ordering deterministic.
+              for i in $(seq 1 30); do
+                RUN_STATUS=$(gh run list \
+                  --workflow "Stores to Root" \
+                  --branch "$BRANCH" \
+                  --limit 1 \
+                  --json status,conclusion \
+                  --jq '.[0].status + "|" + (.[0].conclusion // "")' 2>/dev/null || echo "")
+
+                if [ -z "$RUN_STATUS" ]; then
+                  sleep 5
+                  continue
+                fi
+
+                STATUS="${RUN_STATUS%%|*}"
+                CONCLUSION="${RUN_STATUS##*|}"
+
+                if [ "$STATUS" = "completed" ]; then
+                  if [ "$CONCLUSION" = "success" ]; then
+                    gh workflow run "PR to Live" --ref "$BRANCH" 2>/dev/null || \
+                      echo "Failed to trigger PR to Live for $BRANCH"
+                  else
+                    echo "Stores to Root did not succeed for $BRANCH (conclusion: $CONCLUSION)"
+                  fi
+                  break
+                fi
+
+                sleep 5
+              done
+            else
+              echo "Auto-merge failed — manual review may be needed."
+            fi
           else
             echo "No changes to sync for $BRANCH"
           fi