@toolproof-npm/shared 0.1.112 → 0.1.113

package/dist/_lib/utils/stepCreation.js

@@ -1,5 +1,9 @@
 import { CONSTANTS } from '@toolproof-npm/shared/constants';
 import { getNewIdentity } from '@toolproof-npm/shared/server';
+function assertNonEmpty(arr, msg) {
+    if (arr.length === 0)
+        throw new Error(msg);
+}
 const mintNewRoleBindingMap = async (existingMap) => {
     const newMap = {};
     await Promise.all(Object.keys(existingMap).map(async (resourceRoleRef) => {
@@ -77,11 +81,15 @@ export const createBranchStepFromJobPairs = async (cases) => {
             when: whenWorkStep
         };
     }));
+    assertNonEmpty(casesWithWorkSteps, 'createBranchStepFromJobPairs requires at least one case');
+    const casesTuple = casesWithWorkSteps;
     // Assemble the branch step
+    const canonicalWhatExecutionRef = casesWithWorkSteps?.[0]?.what?.execution?.identity;
     return {
         identity: branchStepIdentity,
         kind: CONSTANTS.STEPS.branch,
-        cases: casesWithWorkSteps
+        cases: casesTuple,
+        canonicalWhatExecutionRef: canonicalWhatExecutionRef ? String(canonicalWhatExecutionRef) : undefined
     };
 };
 // DOC: Helper function to clone a ForStep with new identities for steps and executions, preserving job references and bindings
@@ -184,9 +192,19 @@ export const cloneWhileStep = async (whileStep) => {
 // Note: We intentionally do NOT clone executions/steps here because BranchStep (Option A) does not repeat cases.
 export const cloneBranchStep = async (branchStep, casesOverride) => {
     const newBranchStepIdentity = await getNewIdentity(CONSTANTS.STEPS.branch);
+    const cases = casesOverride ?? branchStep.cases;
+    const priorCanonical = branchStep.canonicalWhatExecutionRef;
+    const canonicalStillExists = priorCanonical
+        ? (cases ?? []).some((c) => String(c?.what?.execution?.identity ?? '') === String(priorCanonical))
+        : false;
+    const fallbackCanonical = (cases ?? [])?.[0]?.what?.execution?.identity;
+    const canonicalWhatExecutionRef = canonicalStillExists
+        ? priorCanonical
+        : (fallbackCanonical ? String(fallbackCanonical) : undefined);
     return {
         identity: newBranchStepIdentity,
         kind: CONSTANTS.STEPS.branch,
-        cases: casesOverride ?? branchStep.cases,
+        cases,
+        canonicalWhatExecutionRef,
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolproof-npm/shared",
-  "version": "0.1.112",
+  "version": "0.1.113",
   "description": "Core library utilities for ToolProof",
   "keywords": [
     "toolproof",
@@ -56,7 +56,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@toolproof-npm/schema": "^0.1.75",
+    "@toolproof-npm/schema": "^0.1.76",
     "firebase-admin": "^13.6.0"
   },
   "scripts": {