climaybe 2.2.4 → 2.3.0

package/README.md

@@ -2,6 +2,8 @@
 
 Shopify CLI for **theme CI/CD** (GitHub Actions, branches, multi-store config) and light **app repo** setup. Same install works in theme or app repositories.
 
+Built by [Electric Maybe](https://electricmaybe.com) — a Shopify-focused product and development studio.
+
 **Commit linting and Cursor bundle (optional in both flows):**
 
 - **Conventional commit linting:** During `climaybe theme init` or `climaybe app init`, you can install [commitlint](https://commitlint.js.org/) and [Husky](https://typicode.github.io/husky) for [Conventional Commits](https://www.conventionalcommits.org/).
@@ -209,7 +211,7 @@ Direct pushes to `staging-<store>` or `live-<store>` are automatically synced ba
 
 | Workflow | Trigger | What it does |
 |----------|---------|-------------|
-| `main-to-staging-stores.yml` (main-to-staging-&lt;store&gt;) | Push to `main` | Merges main into each `staging-<alias>`; root JSONs ignored. For hotfix-backport, skips the store that sent the hotfix; other stores get the merge. Skips only on pure store-sync. |
+| `main-to-staging-stores.yml` (main-to-staging-&lt;store&gt;) | Push to `main` | Merges main into each `staging-<alias>`; root JSONs ignored. For hotfix-backport: if source is `staging-<alias>`, that same staging branch is skipped; if source is `live-<alias>`, `staging-<alias>` is also synced. Skips only on pure store-sync. |
 | `stores-to-root.yml` | Push to `staging-*` | From main merge: stores→root. From elsewhere (e.g. Shopify): root→stores |
 | `pr-to-live.yml` | After stores-to-root | Opens PR from `staging-<alias>` to `live-<alias>` |
 | `root-to-stores.yml` | Push to `live-*` | From main merge: stores→root. From elsewhere: root→stores (same as stores-to-root on staging-*) |
@@ -268,7 +270,7 @@ You can install/update this later with:
 - **No tags yet?** The system uses `theme_version` from `config/settings_schema.json` (`theme_info`), creates that tag on main (e.g. `v1.0.0`), and continues from there.
 - **Staging → main**: On PR, a pre-release patch tag (e.g. v3.1.13) locks the current minor line; on merge, **minor** bump (e.g. v3.1.13 → v3.2.0).
 - **Non-staging to main** (hotfix backports, direct commits): **Patch** bump only, via **nightly workflow** at 02:00 US Eastern (not at commit time).
-- **Version bump runs only on main** (post-merge-tag and nightly-hotfix). Main-to-staging-stores merges main into each `staging-<alias>` on every push (version bumps and hotfixes). When the push is a hotfix from one store (e.g. live-norway), that store’s staging branch is skipped; other stores’ staging branches still get the merge.
+- **Version bump runs only on main** (post-merge-tag and nightly-hotfix). Main-to-staging-stores merges main into each `staging-<alias>` on every push (version bumps and hotfixes). For hotfix-backport, only a `staging-<alias> -> main` source skips syncing back to the same staging branch; a `live-<alias> -> main` source still syncs into `staging-<alias>`.
 - Version bumps update `config/settings_schema.json` and, when present, `package.json` `version`.
 - **Safety**: The version-bump workflow fails if the new tag would not be **strictly higher** than the latest merged release tag (semver), so the release line cannot step backward.
 
@@ -336,7 +338,7 @@ Add the following secrets to your GitHub repository (or use **GitLab CI/CD varia
 
 - **Branch:** Single default branch `main`. Feature branches open as PRs into `main`.
 - **Versioning:** [SemVer](https://semver.org/). Versions are **bumped automatically** when PRs are merged to `main` using [conventional commits](https://www.conventionalcommits.org/): `fix:` → patch, `feat:` → minor, `BREAKING CHANGE` or `feat!:` → major.
-- **Flow:** Merge to `main` → [Release version](.github/workflows/release-version.yml) runs semantic-release (bumps `package.json`, publishes to npm, pushes tag). Optional: tag push runs [Verify release tag](.github/workflows/verify-release-tag.yml) for an extra test pass and tag vs `package.json` check (no publish). Prefer [npm Trusted Publisher](https://docs.npmjs.com/trusted-publishers) (workflow file `release-version.yml`) so no long-lived `NPM_TOKEN` is needed for CI; see [CONTRIBUTING.md](CONTRIBUTING.md). Do not create tags manually; only the Release version workflow creates tags so that tag and package version stay in sync.
+- **Flow:** Merge to `main` → [Release version](.github/workflows/release-version.yml) runs semantic-release (bumps `package.json`, creates GitHub Release notes, publishes to npm, pushes tag). Optional: tag push runs [Verify release tag](.github/workflows/verify-release-tag.yml) for an extra test pass and tag vs `package.json` check (no publish). We publish to **npmjs.com** only (not GitHub Packages). Prefer [npm Trusted Publisher](https://docs.npmjs.com/trusted-publishers) (workflow file `release-version.yml`) so no long-lived `NPM_TOKEN` is needed for CI; see [CONTRIBUTING.md](CONTRIBUTING.md). Do not create tags manually; only the Release version workflow creates tags so that tag and package version stay in sync.
 - **CI:** Every PR and push to `main` runs tests on Node 20 and 22 ([CI workflow](.github/workflows/ci.yml)).
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for branch, PR, and conventional-commit details.

package/bin/version.txt

@@ -1 +1 @@
-2.2.4
+2.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "climaybe",
-  "version": "2.2.4",
-  "description": "Shopify CLI — theme CI/CD (workflows, branches, stores) and app repo helpers; also: commitlint and Cursor rules/skills",
+  "version": "2.3.0",
+  "description": "Shopify CLI by Electric Maybe for theme CI/CD workflows, branch orchestration, app setup, and dev tooling",
   "type": "module",
   "bin": {
     "climaybe": "bin/cli.js"
@@ -15,20 +15,23 @@
   },
   "keywords": [
     "shopify",
-    "ci",
-    "cd",
-    "theme",
-    "workflow",
-    "github-actions"
+    "shopify-cli",
+    "shopify-theme",
+    "theme-development",
+    "ci-cd",
+    "github-actions",
+    "workflow-automation",
+    "release-automation",
+    "electric-maybe"
   ],
-  "author": "Electric Maybe",
+  "author": "Electric Maybe (https://electricmaybe.com)",
   "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",
+  "homepage": "https://electricmaybe.com",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -60,6 +63,7 @@
         }
       ],
       "@semantic-release/release-notes-generator",
+      "@semantic-release/github",
       "@semantic-release/npm",
       [
         "@semantic-release/git",
@@ -82,6 +86,7 @@
     "@commitlint/cli": "^20.4.4",
     "@commitlint/config-conventional": "^20.4.4",
     "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.6",
     "@semantic-release/npm": "^13.1.5",
     "husky": "^9.1.7",
     "semantic-release": "^25.0.3"

package/src/workflows/build/build-scripts.js

@@ -3,12 +3,16 @@ const path = require('path');
 const ROOT_DIR = process.cwd();
 
 function extractImports(content) {
-  const importRegex = /^\s*import\s+(?:[^'"\n;]+?\s+from\s+)?['"]([^'"]+)['"]\s*;?\s*$/gm;
   const imports = [];
+  const fromImportRegex = /(^|\n)\s*import\s+[\s\S]*?\s+from\s+['"]([^'"]+)['"]\s*;?/g;
+  const sideEffectImportRegex = /(^|\n)\s*import\s+['"]([^'"]+)['"]\s*;?/g;
   let match;
 
-  while ((match = importRegex.exec(content)) !== null) {
-    imports.push(match[1]);
+  while ((match = fromImportRegex.exec(content)) !== null) {
+    imports.push(match[2]);
+  }
+  while ((match = sideEffectImportRegex.exec(content)) !== null) {
+    imports.push(match[2]);
   }
 
   return imports;
@@ -36,7 +40,12 @@ function processScriptFile(filePath, processedFiles = new Set()) {
     importedContent += processScriptFile(importPath, processedFiles);
   }
 
-  content = content.replace(/^\s*import\s+(?:[^'"\n;]+?\s+from\s+)?['"][^'"]+['"]\s*;?\s*$/gm, '');
+  // Remove import statements (including multiline "import { ... } from '...'" forms).
+  content = content.replace(/(^|\n)\s*import\s+[\s\S]*?\s+from\s+['"][^'"]+['"]\s*;?/g, '$1');
+  content = content.replace(/(^|\n)\s*import\s+['"][^'"]+['"]\s*;?/g, '$1');
+  content = content.replace(/^\s*export\s+default\s+/gm, '');
+  content = content.replace(/^\s*export\s+\{[^}]*\}\s*;?\s*$/gm, '');
+  content = content.replace(/^\s*export\s+(?=(const|let|var|function|class)\b)/gm, '');
 
   if (process.env.NODE_ENV === 'production') {
     content = content.replace(/\/\*\*[\s\S]*?\*\//g, '');

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

@@ -4,7 +4,9 @@
 # merge brings main in but we immediately restore root from stores/<alias>/ so store-specific data is kept.
 # Runs on every push to main except pure store-sync commits ([stores-to-root], [root-to-stores]), so that:
 # - Version-bump commits: staging-<alias> get the new version.
-# - Hotfix backports (live or staging-<alias> → main): other staging-<alias> get those changes; the store that sent the hotfix is skipped (no need to merge back to the same branch).
+# - Hotfix backports:
+#   - staging-<alias> → main: skip syncing back into the same staging-<alias> (already has the change).
+#   - live-<alias> → main: sync into staging-<alias> too (so staging gets the live hotfix).
 #
 # Also runs when Post-Merge Tag or Nightly Hotfix Tag complete: version-bump pushes with GITHUB_TOKEN,
 # which does not trigger push-based workflows, so we explicitly run sync after those workflows finish.
@@ -25,7 +27,7 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  # Gate: skip only pure store-sync commits. When hotfix-backport, extract source branch alias so we skip merging back into that same store.
+  # Gate: skip only pure store-sync commits. For hotfix-backport, skip syncing back only when source was staging-<alias>.
   # When triggered by workflow_run (version-bump finished), run sync if the workflow succeeded.
   gate:
     runs-on: ubuntu-latest
@@ -33,7 +35,7 @@ jobs:
     if: github.event_name != 'workflow_run' || github.event.workflow_run.conclusion == 'success'
     outputs:
       should_run: ${{ steps.check.outputs.should_run }}
-      hotfix_source_alias: ${{ steps.check.outputs.hotfix_source_alias }}
+      hotfix_skip_alias: ${{ steps.check.outputs.hotfix_skip_alias }}
     steps:
       - name: Check commit message and hotfix source
         id: check
@@ -41,7 +43,7 @@ jobs:
           if [ "${{ github.event_name }}" = "workflow_run" ]; then
             echo "Triggered by workflow_run (version-bump finished); syncing main to staging."
             echo "should_run=true" >> $GITHUB_OUTPUT
-            echo "hotfix_source_alias=" >> $GITHUB_OUTPUT
+            echo "hotfix_skip_alias=" >> $GITHUB_OUTPUT
             exit 0
           fi
 
@@ -50,22 +52,21 @@ jobs:
           if echo "$COMMIT_MSG" | grep -qE "\[skip-store-sync\]|\[stores-to-root\]|\[root-to-stores\]"; then
             echo "Skipping — store sync commit (avoid loop)"
             echo "should_run=false" >> $GITHUB_OUTPUT
-            echo "hotfix_source_alias=" >> $GITHUB_OUTPUT
+            echo "hotfix_skip_alias=" >> $GITHUB_OUTPUT
             exit 0
           fi
 
           echo "should_run=true" >> $GITHUB_OUTPUT
 
-          # If hotfix-backport, extract source branch alias (e.g. staging-norway or live-norway → norway) so we skip that store in sync
-          HOTFIX_SOURCE_ALIAS=""
+          # If hotfix-backport came from staging-<alias>, skip syncing back to that same staging branch.
+          HOTFIX_SKIP_ALIAS=""
           if echo "$COMMIT_MSG" | grep -q "\[hotfix-backport\]"; then
             SOURCE_BRANCH=$(echo "$COMMIT_MSG" | sed -n 's/.*Merge \([^ ]*\) into main.*/\1/p' | head -1)
-            if [ -n "$SOURCE_BRANCH" ]; then
-              HOTFIX_SOURCE_ALIAS="${SOURCE_BRANCH#staging-}"
-              HOTFIX_SOURCE_ALIAS="${HOTFIX_SOURCE_ALIAS#live-}"
+            if [[ -n "$SOURCE_BRANCH" && "$SOURCE_BRANCH" == staging-* ]]; then
+              HOTFIX_SKIP_ALIAS="${SOURCE_BRANCH#staging-}"
             fi
           fi
-          echo "hotfix_source_alias=$HOTFIX_SOURCE_ALIAS" >> $GITHUB_OUTPUT
+          echo "hotfix_skip_alias=$HOTFIX_SKIP_ALIAS" >> $GITHUB_OUTPUT
 
   # Read store list from package.json
   config:
@@ -88,7 +89,8 @@ jobs:
           echo "stores=$STORES" >> $GITHUB_OUTPUT
           echo "Store aliases: $STORES"
 
-  # Merge main into each staging-<alias>; root JSONs ignored (restored from stores/<alias>/). Skip the store that sent the hotfix (no need to merge back).
+  # Merge main into each staging-<alias>; root JSONs ignored (restored from stores/<alias>/).
+  # Skip only staging-origin hotfix source branch (no need to merge back to same staging branch).
   sync:
     needs: [gate, config]
     if: needs.gate.outputs.should_run == 'true'
@@ -103,7 +105,7 @@ jobs:
       actions: write
     env:
       GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      HOTFIX_SOURCE_ALIAS: ${{ needs.gate.outputs.hotfix_source_alias }}
+      HOTFIX_SKIP_ALIAS: ${{ needs.gate.outputs.hotfix_skip_alias }}
     steps:
       - uses: actions/checkout@v4
         with:
@@ -116,8 +118,8 @@ jobs:
           ALIAS="${{ matrix.store }}"
           STORE_DIR="stores/${ALIAS}"
 
-          if [ -n "$HOTFIX_SOURCE_ALIAS" ] && [ "$HOTFIX_SOURCE_ALIAS" = "$ALIAS" ]; then
-            echo "Hotfix came from staging-$ALIAS or live-$ALIAS, skipping (no need to merge back to same store)."
+          if [ -n "$HOTFIX_SKIP_ALIAS" ] && [ "$HOTFIX_SKIP_ALIAS" = "$ALIAS" ]; then
+            echo "Hotfix came from staging-$ALIAS, skipping (no need to merge back to same staging branch)."
             exit 0
           fi