@pygmalionjs/pygmalion 0.5.10 → 0.5.12

package/node/dev-mirror.mjs

@@ -556,7 +556,17 @@ export async function syncDevMirrorWorktree(options) {
   let warning = null;
   let switchTarget = null;
 
-  if (localRef) {
+  // A pinned commit must never move: that is the whole point of pinning, and
+  // fetching behind a designer's back would silently change what a captured
+  // frame means. A branch NAME is the opposite promise — asking for `dev` means
+  // "whatever dev is now", so it has to reach the remote first.
+  //
+  // Conflating the two made the consumer's "refresh branch" button re-read a
+  // local ref and never advance: it looked like the newest dev and was whatever
+  // the machine last happened to fetch.
+  const pinnedCommit = localRef != null && /^[0-9a-f]{7,40}$/i.test(localRef);
+
+  if (localRef && pinnedCommit) {
     try {
       switchTarget = await git(
         repoRoot,
@@ -568,6 +578,35 @@ export async function syncDevMirrorWorktree(options) {
     } catch {
       throw new Error(`local source.ref "${localRef}" cannot be interpreted as a commit`);
     }
+  } else if (localRef) {
+    // `origin/dev` and `dev` both mean the same branch here; strip the remote so
+    // the fetch names a branch and the result is read back from the remote ref.
+    const namedBranch = localRef.startsWith(`${remote}/`)
+      ? localRef.slice(remote.length + 1)
+      : localRef;
+    const namedRemoteRef = `${remote}/${namedBranch}`;
+    try {
+      await git(repoRoot, 'fetch', remote, namedBranch);
+      switchTarget = namedRemoteRef;
+    } catch (error) {
+      // Offline is not fatal — fall back to whatever the ref resolves to
+      // locally, and say so rather than pretending the branch is current.
+      warning = `source.ref "${localRef}" could not be refreshed from ${remote}: ${
+        error instanceof Error ? error.message.split('\n')[0] : String(error)
+      }`;
+      options.onWarning?.(warning);
+      try {
+        switchTarget = await git(
+          repoRoot,
+          'rev-parse',
+          '--verify',
+          '--end-of-options',
+          `${localRef}^{commit}`,
+        );
+      } catch {
+        throw new Error(`local source.ref "${localRef}" cannot be interpreted as a commit`);
+      }
+    }
   } else {
     try {
       await git(repoRoot, 'fetch', remote, branch);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pygmalionjs/pygmalion",
-  "version": "0.5.10",
+  "version": "0.5.12",
   "description": "Code-backed DOM design sandbox and visual QA editor",
   "license": "UNLICENSED",
   "publishConfig": {