@pygmalionjs/pygmalion 0.6.34 → 0.6.35

package/dist-lib/types/editor/projectBootGate.d.ts

@@ -31,17 +31,30 @@ export interface MirrorGateStatus {
 export interface IdleMirrorSourceStatus extends MirrorGateStatus {
     sourceRef: string | null;
 }
+/** One listed ref whose exact revision can start a lazy checkout. */
+export interface IdleMirrorListedSourceRef {
+    name: string;
+    fullName?: string;
+    sourceRevision?: string;
+}
+/** The ref-list fields needed to resolve an idle named source. */
+export interface IdleMirrorSourceRefs {
+    refs: readonly IdleMirrorListedSourceRef[];
+    defaultRef: string | null;
+    worktreeRef?: string | null;
+}
 /**
  * Returns an immutable source revision that can safely create the first lazy
  * preview demand.
  *
  * An idle mirror has no checked-out `commit` yet. When it was configured with
  * a full Git object id, however, that ref already names the exact revision the
- * catalog endpoint will verify after preparation. Named refs, worktree mode,
- * and abbreviated ids can move or be ambiguous, so they remain pending until
- * the server reports the resolved commit.
+ * catalog endpoint will verify after preparation. A named ref can also create
+ * that first demand when the ref-list endpoint supplies its full object id.
+ * The abbreviated display commit is intentionally ignored: it can be
+ * ambiguous and cannot satisfy the exact source lease.
  */
-export declare function idleMirrorSourceRevision(status: IdleMirrorSourceStatus): string | null;
+export declare function idleMirrorSourceRevision(status: IdleMirrorSourceStatus, sourceRefs?: IdleMirrorSourceRefs): string | null;
 export interface SettleMirrorStatusOptions<S extends MirrorGateStatus> {
     /** Status of the initial request; returned as-is when already settled. */
     initial: S;

package/dist-lib/types/editor/projectRuntime.d.ts

@@ -22,7 +22,10 @@ export interface PygmalionDevMirrorStatus {
 /** One revision the mirror can be repointed at. */
 export interface PygmalionSourceRef {
     name: string;
+    /** Abbreviated commit used for compact branch-tip labels. */
     commit: string;
+    /** Full immutable object id used for preview and artifact identity. */
+    sourceRevision?: string;
     fullName: string;
     kind: 'local' | 'remote';
 }

package/node/dev-mirror.mjs

@@ -350,15 +350,21 @@ function escapeRegExp(value) {
  * of asking for a ref string.
  */
 export async function listSourceRefs(repoRoot, remote = 'origin') {
-  const format = '%(refname:short)%09%(objectname:short=8)%09%(refname)';
+  const format =
+    '%(refname:short)%09%(objectname:short=8)%09%(objectname)%09%(refname)';
   const read = async (...patterns) => {
     const raw = await git(repoRoot, 'for-each-ref', `--format=${format}`, ...patterns);
     if (!raw) return [];
     return raw
       .split('\n')
       .map((line) => line.split('\t'))
-      .filter((parts) => parts.length === 3 && parts[0])
-      .map(([name, commit, fullName]) => ({ name, commit, fullName }));
+      .filter((parts) => parts.length === 4 && parts[0])
+      .map(([name, commit, sourceRevision, fullName]) => ({
+        name,
+        commit,
+        sourceRevision,
+        fullName,
+      }));
   };
   const remotes = (await read(`refs/remotes/${remote}`))
     // `%(refname:short)` may abbreviate refs/remotes/origin/HEAD to just
@@ -375,15 +381,19 @@ export async function listSourceRefs(repoRoot, remote = 'origin') {
   // `dev@a0d5fdbf → 3e8cca5b`, an invitation to go backwards.
   const remoteTipPrefix = `refs/remotes/${remote}/`;
   const remoteTips = new Map(
-    remotes.map((item) => [item.fullName.slice(remoteTipPrefix.length), item.commit]),
+    remotes.map((item) => [item.fullName.slice(remoteTipPrefix.length), item]),
   );
-  const locals = (await read('refs/heads')).map((item) => ({
-    ...item,
-    // A branch the remote does not have resolves locally (the fetch fails and
-    // becomes a warning), so its own tip is the honest answer there.
-    commit: remoteTips.get(item.name) ?? item.commit,
-    kind: 'local',
-  }));
+  const locals = (await read('refs/heads')).map((item) => {
+    const remoteTip = remoteTips.get(item.name);
+    return {
+      ...item,
+      // A branch the remote does not have resolves locally (the fetch fails and
+      // becomes a warning), so its own tip is the honest answer there.
+      commit: remoteTip?.commit ?? item.commit,
+      sourceRevision: remoteTip?.sourceRevision ?? item.sourceRevision,
+      kind: 'local',
+    };
+  });
   const seen = new Set();
   return [...locals, ...remotes].filter((item) => {
     if (seen.has(item.name)) return false;

package/package.json

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