ultimate-jekyll-manager 1.9.14 → 1.9.16

package/CLAUDE.md

@@ -55,6 +55,8 @@ The only things that ARE safe to run inside UJM itself:
 
 ### For Framework Development (This Repository)
 
+> **🚫 NEVER use `npx mgr ...` from the framework repo.** `npx mgr` is for CONSUMER projects only (where the bin is linked in `node_modules/.bin/`). From the framework repo, use `npm test`, `npm start`, etc. — the `scripts` in `package.json` call the local `bin/` directly. This applies to ALL four OMEGA frameworks (BEM/UJM/BXM/EM).
+
 1. `npm install` — install UJM's own deps
 2. `npm start` (≡ `npm run prepare:watch`) — copies `src/` → `dist/` on file change
 3. Test in the **designated test consumer** — `../ultimate-jekyll-website` is UJM's consumer for validating framework changes end-to-end (exercise any consumer-level flow there freely: builds, tests, runtime). From inside it, run `npx mgr install dev` to swap UJM to this local repo — required whenever you edit the framework source and want the consumer to pick up the changes (the consumer otherwise keeps its installed `node_modules/ultimate-jekyll-manager`). Reverse with `npx mgr install live`.
@@ -175,6 +177,7 @@ Note: `-t` short alias belongs to `translation`. The `test` command uses `--test
 
 ## Development Workflow
 
+- **🚫 NEVER use `npx mgr ...` from the framework repo** — `npx mgr` is for CONSUMER projects only (where the bin lives in `node_modules/.bin/`). From the framework repo, use `npm test`, `npm start`, etc. — the `scripts` in `package.json` call `node bin/ultimate-jekyll-manager` directly. This applies to ALL four OMEGA frameworks (BEM/UJM/BXM/EM).
 - **🚫 NEVER run `npm start` in a consumer project** — the user runs the dev server; running it again kills theirs. Assume it's already running; if it isn't, **instruct the user to run it** rather than running it yourself. Instead, **check `logs/dev.log`** after editing files to confirm the watcher recompiled successfully (`Reloading Browsers...` = success; `errored` = fix the error) — never tail/attach to the process. If editing multiple files, check the log once after the last edit. A change that breaks the build is not a completed change. Running `npx mgr test` is fine.
 - **Live-test UI changes via CDP.** After code changes compile, use the `chrome-devtools` MCP tools (screenshots, click, evaluate JS, console logs) to verify the change works in the running browser. This is the primary way to confirm UI changes — type-checking and test suites verify code correctness, not feature correctness. Read the URL from the consumer's `.temp/_config_browsersync.yml`. Prefer `https://localhost:4000`; fall back to the local network IP (e.g. `https://192.168.x.x:4000`) if localhost doesn't connect. See [docs/cdp-debugging.md](docs/cdp-debugging.md) + `~/.claude/mcp-server/servers/chrome-devtools/CLAUDE.md`.
 

package/dist/defaults/.github/workflows/build.yml

@@ -36,7 +36,7 @@ jobs:
           git config --global user.email "$GITHUB_ACTOR@users.noreply.github.com"
           git config --global user.name "$GITHUB_ACTOR"
       - name: Checkout main branch
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           token: ${{ secrets.GH_TOKEN }}
           fetch-depth: 0
@@ -57,13 +57,26 @@ jobs:
         run: |
           bundle install
       - name: Setup node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: ${{ env.NODE_VERSION }}
       - name: Install Socket Firewall
         run: npm install -g sfw
-      - name: Run node install
-        run: sfw npm install
+      # Retry up to 3 times — transient ECONNRESET / socket hang-ups on GH Actions
+      # runners are common, and sfw crashes (instead of gracefully degrading) when
+      # a fetch fails mid-flight, killing the whole job.
+      - name: Run node install (with retry)
+        run: |
+          for attempt in 1 2 3; do
+            echo "Install attempt $attempt of 3..."
+            sfw npm install && break
+            echo "Attempt $attempt failed"
+            if [ "$attempt" -eq 3 ]; then
+              echo "All 3 install attempts failed"
+              exit 1
+            fi
+            sleep 15
+          done
       - name: Log dependency versions
         run: |
           echo "🖥️ Unix Versions: "

package/dist/gulp/tasks/defaults.js

@@ -129,6 +129,7 @@ const FILE_MAP = {
 
   // Files to run templating on
   '.github/workflows/build.yml': {
+    overwrite: true,
     template: { ...cleanVersions, ...ujConfig, ...githubSecrets },
   },
   '.nvmrc': {

package/dist/gulp/tasks/imagemin.js

@@ -361,16 +361,18 @@ async function rewriteOversizedSources(files) {
 }
 
 // Lowercase the extension on each Vinyl file's path before piping into gulp-responsive-modern.
-// gulp-responsive-modern's lib/format.js uses a case-sensitive switch on path.extname() and returns
-// the string 'unsupported' for anything else, which then crashes sharp.toFormat(). Files saved
-// straight off a camera (IMG_3119.JPG) hit this. Rewriting the Vinyl path in-stream keeps the
-// on-disk file untouched while letting the plugin recognize the format.
+// On case-sensitive filesystems (Linux CI), the on-disk file may be IMG_3119.JPG while the
+// lowercased path points to a nonexistent IMG_3119.jpg. We read file.contents into a buffer
+// first so sharp uses the buffer (not the renamed path), then safely lowercase the extension.
 function lowercaseExtTransform() {
   return new Transform({
     objectMode: true,
     transform(file, _enc, cb) {
       const ext = path.extname(file.path);
       if (ext && ext !== ext.toLowerCase()) {
+        if (file.isNull()) {
+          file.contents = jetpack.read(file.path, 'buffer');
+        }
         file.path = file.path.slice(0, -ext.length) + ext.toLowerCase();
       }
       cb(null, file);
@@ -439,7 +441,7 @@ async function determineFilesToProcess(files, meta, githubCache, stats) {
     // Track expected outputs for this file
     const baseName = path.basename(file, path.extname(file));
     const dirName = path.dirname(relativePath).replace(/^src\/assets\/images\/?/, '');
-    const originalExt = path.extname(file).slice(1); // Remove the dot
+    const originalExt = path.extname(file).slice(1).toLowerCase();
 
     // Only generate responsive outputs for supported formats
     // Other formats (svg, gif, webp) pass through as-is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-jekyll-manager",
-  "version": "1.9.14",
+  "version": "1.9.16",
   "description": "Ultimate Jekyll dependency manager",
   "main": "dist/index.js",
   "files": [
@@ -99,7 +99,7 @@
     "gulp-filter": "^10.0.0",
     "gulp-postcss": "^10.0.0",
     "gulp-rename": "^2.1.0",
-    "gulp-responsive-modern": "^1.0.0",
+    "gulp-responsive-modern": "^1.0.1",
     "gulp-sass": "^6.0.1",
     "html-minifier-terser": "^7.2.0",
     "html-validate": "^11.5.3",