climaybe 2.4.2 → 3.0.0

package/src/lib/shopify-cli.js

@@ -0,0 +1,30 @@
+import { spawn } from 'node:child_process';
+import pc from 'picocolors';
+
+function spawnInherit(cmd, args, { cwd = process.cwd(), name = cmd } = {}) {
+  const child = spawn(cmd, args, {
+    cwd,
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+  child.on('exit', (code) => {
+    if (code && code !== 0) {
+      console.log(pc.red(`\n  ${name} exited with code ${code}\n`));
+    }
+  });
+  return child;
+}
+
+/**
+ * Run Shopify CLI, falling back to npx when `shopify` isn't available.
+ * @param {string[]} args e.g. ['theme','check']
+ */
+export function runShopify(args, { cwd = process.cwd(), name = 'shopify' } = {}) {
+  const child = spawnInherit('shopify', args, { cwd, name });
+  child.on('error', (err) => {
+    if (err?.code !== 'ENOENT') return;
+    spawnInherit('npx', ['-y', '@shopify/cli@latest', ...args], { cwd, name: 'shopify(npx)' });
+  });
+  return child;
+}
+

package/src/lib/theme-dev-kit.js

@@ -1,21 +1,8 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
-import { readPkg, writePkg } from './config.js';
+import { readPkg, writePkg, writeClimaybeConfig } from './config.js';
 
 const DEV_KIT_FILES = {
-  'nodemon.json': `{
-  "watch": ["_scripts"],
-  "ext": "js",
-  "exec": "npm run scripts:build --silent",
-  "quiet": true,
-  "no-colours": true,
-  "ignore": ["node_modules/**/*", "assets/**/*", "**/*.min.js"],
-  "delay": "500",
-  "polling": false,
-  "legacyWatch": false,
-  "restartable": "rs"
-}
-`,
   '.theme-check.yml': `root: .
 
 extends: :nothing
@@ -80,7 +67,7 @@ const VSCODE_TASKS_CONTENT = `{
     {
       "label": "Shopify",
       "type": "shell",
-      "command": "yarn shopify:serve",
+      "command": "climaybe serve:shopify",
       "isBackground": true,
       "presentation": {
         "echo": true,
@@ -96,7 +83,7 @@ const VSCODE_TASKS_CONTENT = `{
     {
       "label": "Tailwind",
       "type": "shell",
-      "command": "yarn tailwind:watch",
+      "command": "climaybe serve:assets",
       "isBackground": true,
       "presentation": {
         "echo": true,
@@ -128,33 +115,6 @@ assets/index.js
 .vercel
 `;
 
-const PACKAGE_MERGES = {
-  scripts: {
-    'shopify:serve': 'shopify theme dev --theme-editor-sync --store=$npm_package_config_store',
-    'shopify:populate': 'shopify populate --store=$npm_package_config_store',
-    'scripts:build': 'node build-scripts.js',
-    'scripts:watch': 'nodemon',
-    'tailwind:watch':
-      `concurrently --kill-others --max-restarts 3 "NODE_ENV=production NODE_OPTIONS='--max-old-space-size=512' ` +
-      `npx @tailwindcss/cli -i _styles/main.css -o assets/style.css --watch" "NODE_OPTIONS='--max-old-space-size=256' ` +
-      `npm run scripts:watch" "npx -y @shopify/dev-mcp@latest"`,
-    'tailwind:build': 'NODE_ENV=production npx @tailwindcss/cli -i _styles/main.css -o assets/style.css --minify && npm run scripts:build',
-    'lint:liquid': 'shopify theme check',
-    'lint:js': 'eslint ./assets/*.js --config .config/eslint.config.mjs',
-    'lint:css': 'node_modules/.bin/stylelint ./assets/*.css --config .config/.stylelintrc.json',
-    release: 'node .sys/scripts/release.js',
-  },
-  devDependencies: {
-    '@shopify/prettier-plugin-liquid': '^1.6.3',
-    '@tailwindcss/cli': '^4.1.17',
-    concurrently: '^8.2.2',
-    nodemon: '^3.0.2',
-    prettier: '^3.4.2',
-    stylelint: '^16.9.0',
-    eslint: '^9.11.0',
-  },
-};
-
 function ensureParent(path) {
   mkdirSync(dirname(path), { recursive: true });
 }
@@ -171,12 +131,16 @@ function mergeGitignore(cwd = process.cwd()) {
   writeFileSync(path, `${next}\n`, 'utf-8');
 }
 
-function mergePackageJson(defaultStoreDomain = '', cwd = process.cwd()) {
-  const pkg = readPkg(cwd) || { name: 'shopify-theme', version: '1.0.0', private: true };
-  pkg.config = { ...(pkg.config || {}) };
-  if (!pkg.config.store && defaultStoreDomain) pkg.config.store = defaultStoreDomain;
-  pkg.scripts = { ...(pkg.scripts || {}), ...PACKAGE_MERGES.scripts };
-  pkg.devDependencies = { ...(pkg.devDependencies || {}), ...PACKAGE_MERGES.devDependencies };
+function mergePackageJson({ packageName = 'shopify-theme', cwd = process.cwd() } = {}) {
+  const pkg = readPkg(cwd) || { name: packageName, version: '1.0.0', private: true };
+  pkg.devDependencies = { ...(pkg.devDependencies || {}) };
+
+  // Ensure teammates can run climaybe + Tailwind after plain npm install.
+  const cliVersion = process.env.CLIMAYBE_PACKAGE_VERSION;
+  const climaybeRange = /^\d+\.\d+\.\d+/.test(String(cliVersion || '')) ? `^${cliVersion}` : 'latest';
+  if (!pkg.devDependencies.climaybe) pkg.devDependencies.climaybe = climaybeRange;
+  if (!pkg.devDependencies.tailwindcss) pkg.devDependencies.tailwindcss = 'latest';
+
   writePkg(pkg, cwd);
 }
 
@@ -186,7 +150,12 @@ export function getDevKitExistingFiles({ includeVSCodeTasks = true, cwd = proces
   return paths.filter((p) => existsSync(join(cwd, p)));
 }
 
-export function scaffoldThemeDevKit({ includeVSCodeTasks = true, defaultStoreDomain = '', cwd = process.cwd() } = {}) {
+export function scaffoldThemeDevKit({
+  includeVSCodeTasks = true,
+  defaultStoreDomain = '',
+  packageName = 'shopify-theme',
+  cwd = process.cwd(),
+} = {}) {
   for (const [rel, content] of Object.entries(DEV_KIT_FILES)) {
     const dest = join(cwd, rel);
     ensureParent(dest);
@@ -198,5 +167,18 @@ export function scaffoldThemeDevKit({ includeVSCodeTasks = true, defaultStoreDom
     writeFileSync(dest, VSCODE_TASKS_CONTENT, 'utf-8');
   }
   mergeGitignore(cwd);
-  mergePackageJson(defaultStoreDomain, cwd);
+  mergePackageJson({ packageName, cwd });
+
+  // New source-of-truth config file for climaybe (local dev + CI).
+  // We intentionally keep package.json changes minimal (no script injection).
+  writeClimaybeConfig(
+    {
+      port: 9295,
+      default_store: defaultStoreDomain || undefined,
+      dev_kit: true,
+      vscode_tasks: includeVSCodeTasks,
+      project_type: 'theme',
+    },
+    cwd
+  );
 }

package/src/lib/watch.js

@@ -0,0 +1,80 @@
+import { existsSync, readdirSync, watch } from 'node:fs';
+import { join } from 'node:path';
+
+function debounce(fn, ms) {
+  let t = null;
+  return (...args) => {
+    if (t) clearTimeout(t);
+    t = setTimeout(() => fn(...args), ms);
+  };
+}
+
+function listDirsRecursively(rootDir) {
+  const dirs = [];
+  if (!existsSync(rootDir)) return dirs;
+
+  const stack = [rootDir];
+  while (stack.length) {
+    const dir = stack.pop();
+    dirs.push(dir);
+    let entries = [];
+    try {
+      entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      const full = join(dir, e.name);
+      stack.push(full);
+    }
+  }
+  return dirs;
+}
+
+export function watchTree({ rootDir, ignore = () => false, onChange, debounceMs = 300 } = {}) {
+  if (!rootDir) throw new Error('watchTree: rootDir is required');
+  if (typeof onChange !== 'function') throw new Error('watchTree: onChange is required');
+  if (!existsSync(rootDir)) return { close: () => {} };
+
+  const watchers = new Map();
+  const debounced = debounce(onChange, debounceMs);
+
+  function ensureWatched(dir) {
+    if (watchers.has(dir)) return;
+    try {
+      const w = watch(dir, { persistent: true }, (eventType, filename) => {
+        const name = typeof filename === 'string' ? filename : '';
+        const full = name ? join(dir, name) : dir;
+        if (ignore(full)) return;
+        debounced(full, eventType);
+        // Best-effort: new dirs can appear; rescan on any event.
+        rescan();
+      });
+      watchers.set(dir, w);
+    } catch {
+      // ignore unwatcheable dirs
+    }
+  }
+
+  function rescan() {
+    const dirs = listDirsRecursively(rootDir);
+    for (const d of dirs) ensureWatched(d);
+  }
+
+  rescan();
+
+  return {
+    close() {
+      for (const w of watchers.values()) {
+        try {
+          w.close();
+        } catch {
+          // ignore
+        }
+      }
+      watchers.clear();
+    },
+  };
+}
+

package/src/lib/workflows.js

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, readdirSync, copyFileSync, rmSync } from 'node:f
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import pc from 'picocolors';
-import { installBuildScript, removeBuildScript } from './build-workflows.js';
+import { ensureBuildWorkflowDefaults } from './build-workflows.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TEMPLATES_DIR = join(__dirname, '..', 'workflows');
@@ -110,9 +110,7 @@ export function scaffoldWorkflows(mode = 'single', options = {}, cwd = process.c
     for (const f of listYmls(buildDir)) {
       copyWorkflow(buildDir, f, dest);
     }
-    installBuildScript(cwd);
-  } else {
-    removeBuildScript(cwd);
+    ensureBuildWorkflowDefaults(cwd);
   }
 
   const total = readdirSync(dest).filter((f) => f.endsWith('.yml')).length;

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

@@ -119,9 +119,18 @@ jobs:
             COMMITS=$(git log --pretty=format:"%s" -n 30 "$TAG_NAME" 2>/dev/null || true)
           fi
 
+          # Filter out noisy system-generated sync/merge commits so release notes stay readable.
+          FILTERED_COMMITS=$(printf '%s\n' "$COMMITS" | sed '/^[[:space:]]*$/d' | grep -Eiv \
+            '^Sync main → staging-|^Sync main -> staging-|^Merge pull request #|^Merge branch |^Merge live-.* into main \[hotfix-backport\]$|^chore: sync root to stores/.+ \[root-to-stores\]$|^chore: keep store root JSONs from stores/.+ \[stores-to-root\]$|^Update from Shopify for theme ')
+          if [ -z "$FILTERED_COMMITS" ]; then
+            NOISY_ONLY_COMMITS=true
+          else
+            NOISY_ONLY_COMMITS=false
+          fi
+
           # Score how many commit subjects follow conventional-commit style.
-          TOTAL_COUNT=$(printf '%s\n' "$COMMITS" | sed '/^[[:space:]]*$/d' | wc -l | tr -d ' ')
-          CONVENTIONAL_COUNT=$(printf '%s\n' "$COMMITS" | sed '/^[[:space:]]*$/d' | grep -Eic '^(feat|fix|refactor|perf|docs|style|test|build|ci|chore|revert)(\([^)]+\))?!?: ')
+          TOTAL_COUNT=$(printf '%s\n' "$FILTERED_COMMITS" | sed '/^[[:space:]]*$/d' | wc -l | tr -d ' ')
+          CONVENTIONAL_COUNT=$(printf '%s\n' "$FILTERED_COMMITS" | sed '/^[[:space:]]*$/d' | grep -Eic '^(feat|fix|refactor|perf|docs|style|test|build|ci|chore|revert)(\([^)]+\))?!?: ')
           if [ -z "$TOTAL_COUNT" ] || [ "$TOTAL_COUNT" -eq 0 ]; then
             TOTAL_COUNT=1
           fi
@@ -139,8 +148,8 @@ jobs:
           } > "$NOTES_FILE"
 
           # If commit quality is low and Gemini is available, ask AI to summarize merchant-facing notes.
-          if [ "$QUALITY" -lt 50 ] && [ -n "$GEMINI_API_KEY" ]; then
-            printf '%s\n' "$COMMITS" > .sys/release-notes/commits-for-ai.txt
+          if [ "$QUALITY" -lt 50 ] && [ -n "$GEMINI_API_KEY" ] && [ "$NOISY_ONLY_COMMITS" != "true" ]; then
+            printf '%s\n' "$FILTERED_COMMITS" > .sys/release-notes/commits-for-ai.txt
 
             PROMPT=$(cat <<'PROMPT_EOF'
           You generate release notes for a Shopify theme.
@@ -182,12 +191,20 @@ jobs:
             else
               echo "## Changes" >> "$NOTES_FILE"
               echo >> "$NOTES_FILE"
-              printf '%s\n' "$COMMITS" | sed '/^[[:space:]]*$/d' | sed 's/^/- /' >> "$NOTES_FILE"
+              if [ "$NOISY_ONLY_COMMITS" = "true" ]; then
+                echo "- No notable merchant-facing changes in this release." >> "$NOTES_FILE"
+              else
+                printf '%s\n' "$FILTERED_COMMITS" | sed '/^[[:space:]]*$/d' | sed 's/^/- /' >> "$NOTES_FILE"
+              fi
             fi
           else
             echo "## Changes" >> "$NOTES_FILE"
             echo >> "$NOTES_FILE"
-            printf '%s\n' "$COMMITS" | sed '/^[[:space:]]*$/d' | sed 's/^/- /' >> "$NOTES_FILE"
+            if [ "$NOISY_ONLY_COMMITS" = "true" ]; then
+              echo "- No notable merchant-facing changes in this release." >> "$NOTES_FILE"
+            else
+              printf '%s\n' "$FILTERED_COMMITS" | sed '/^[[:space:]]*$/d' | sed 's/^/- /' >> "$NOTES_FILE"
+            fi
           fi
 
           echo "notes_file=$NOTES_FILE" >> $GITHUB_OUTPUT

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

@@ -24,16 +24,32 @@ jobs:
           node-version: "24"
           cache: "npm"
 
-      - name: Install dependencies
-        run: npm ci
+      - name: Detect build entrypoints
+        id: detect
+        run: |
+          HAS_SCRIPTS=false
+          if ls _scripts/*.js >/dev/null 2>&1; then
+            HAS_SCRIPTS=true
+          fi
+          HAS_STYLES=false
+          if [ -f "_styles/main.css" ]; then
+            HAS_STYLES=true
+          fi
+          echo "has_scripts=$HAS_SCRIPTS" >> $GITHUB_OUTPUT
+          echo "has_styles=$HAS_STYLES" >> $GITHUB_OUTPUT
 
       - name: Build scripts
-        run: node .climaybe/build-scripts.js
+        if: steps.detect.outputs.has_scripts == 'true'
+        run: npx -y climaybe@latest build-scripts
 
       - name: Run Tailwind build
         id: build
         run: |
-          NODE_ENV=production npx @tailwindcss/cli -i _styles/main.css -o assets/style.css --minify
+          if [ "${{ steps.detect.outputs.has_styles }}" = "true" ]; then
+            NODE_ENV=production npx -y climaybe@latest build
+          else
+            echo "No _styles/main.css found; skipping Tailwind build."
+          fi
           echo "success=true" >> $GITHUB_OUTPUT
 
       - name: Commit and push changes
@@ -43,7 +59,12 @@ jobs:
           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 ls assets/*.js >/dev/null 2>&1; then
+            git add -f assets/*.js
+          fi
+          if [ -f "assets/style.css" ]; then
+            git add -f assets/style.css
+          fi
           if git diff --staged --quiet; then
             echo "No changes to commit"
           else

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

@@ -68,7 +68,7 @@ jobs:
           fi
           echo "hotfix_skip_alias=$HOTFIX_SKIP_ALIAS" >> $GITHUB_OUTPUT
 
-  # Read store list from package.json
+  # Read store list from climaybe.config.json
   config:
     needs: gate
     if: needs.gate.outputs.should_run == 'true'
@@ -82,8 +82,9 @@ jobs:
         id: read
         run: |
           STORES=$(node -e "
-            const pkg = require('./package.json');
-            const stores = Object.keys(pkg.config?.stores || {});
+            const fs = require('fs');
+            const cfg = JSON.parse(fs.readFileSync('./climaybe.config.json', 'utf8'));
+            const stores = Object.keys(cfg?.stores || {});
             console.log(JSON.stringify(stores));
           ")
           echo "stores=$STORES" >> $GITHUB_OUTPUT

package/src/workflows/multi/multistore-hotfix-to-main.yml

@@ -48,9 +48,9 @@ jobs:
         run: |
           DEFAULT_ALIAS=$(node -e "
             const fs = require('fs');
-            const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
-            const stores = pkg?.config?.stores || {};
-            const defaultStoreRaw = pkg?.config?.default_store;
+            const cfg = JSON.parse(fs.readFileSync('./climaybe.config.json', 'utf8'));
+            const stores = cfg?.stores || {};
+            const defaultStoreRaw = cfg?.default_store;
             const normalize = (v) => String(v || '').toLowerCase().replace(/^https?:\\/\\//, '').replace(/\/.*\$/, '');
             const defaultStore = normalize(defaultStoreRaw);
             let alias = '';

package/src/workflows/multi/pr-to-live.yml

@@ -47,7 +47,7 @@ jobs:
           echo "staging_branch=$BRANCH" >> $GITHUB_OUTPUT
           echo "live_branch=live-${ALIAS}" >> $GITHUB_OUTPUT
 
-      - name: Resolve store domain from package.json
+      - name: Resolve store domain from climaybe.config.json
         id: store
         env:
           SHOPIFY_STORE_URL_SCOPED: ${{ secrets[format('SHOPIFY_STORE_URL_{0}', steps.alias.outputs.alias_secret)] }}
@@ -56,8 +56,8 @@ jobs:
           ALIAS="${{ steps.alias.outputs.alias }}"
           DOMAIN_CONFIG=$(node -e "
             const fs = require('fs');
-            const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
-            const domain = pkg?.config?.stores?.['${ALIAS}'] || '';
+            const cfg = JSON.parse(fs.readFileSync('./climaybe.config.json', 'utf8'));
+            const domain = cfg?.stores?.['${ALIAS}'] || '';
             process.stdout.write(domain);
           ")
           DOMAIN="${SHOPIFY_STORE_URL_SCOPED:-}"

package/src/workflows/preview/pr-close.yml

@@ -31,9 +31,9 @@ jobs:
           else
             ALIAS=$(node -e "
               const fs = require('fs');
-              const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
-              const stores = pkg?.config?.stores || {};
-              const defaultStoreRaw = pkg?.config?.default_store;
+              const cfg = JSON.parse(fs.readFileSync('./climaybe.config.json', 'utf8'));
+              const stores = cfg?.stores || {};
+              const defaultStoreRaw = cfg?.default_store;
               const normalize = (v) => String(v || '')
                 .toLowerCase()
                 .replace(/^https?:\\/\\//, '')
@@ -63,7 +63,7 @@ jobs:
           fi
 
           if [ -z "$ALIAS" ]; then
-            echo "Could not resolve store alias from package.json config or base branch."
+            echo "Could not resolve store alias from climaybe.config.json config or base branch."
             exit 1
           fi
 

package/src/workflows/preview/pr-update.yml

@@ -34,9 +34,9 @@ jobs:
           else
             ALIAS=$(node -e "
               const fs = require('fs');
-              const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
-              const stores = pkg?.config?.stores || {};
-              const defaultStoreRaw = pkg?.config?.default_store;
+              const cfg = JSON.parse(fs.readFileSync('./climaybe.config.json', 'utf8'));
+              const stores = cfg?.stores || {};
+              const defaultStoreRaw = cfg?.default_store;
               const normalize = (v) => String(v || '')
                 .toLowerCase()
                 .replace(/^https?:\\/\\//, '')
@@ -66,7 +66,7 @@ jobs:
           fi
 
           if [ -z "$ALIAS" ]; then
-            echo "Could not resolve default store alias from package.json config."
+            echo "Could not resolve default store alias from climaybe.config.json config."
             exit 1
           fi