@synergenius/flow-weaver 0.9.0 → 0.9.1

package/dist/cli/flow-weaver.mjs

@@ -44825,38 +44825,39 @@ function assignImplicitPortOrders(ports) {
     scopeGroups.get(scopeKey).push([portName, portDef]);
   }
   for (const [scope, portsInScope] of scopeGroups.entries()) {
+    let nextSlot2 = function(from) {
+      while (occupied.has(from)) from++;
+      occupied.add(from);
+      return from;
+    };
+    var nextSlot = nextSlot2;
     const isScoped = scope !== void 0;
-    const mandatoryPorts = portsInScope.filter(([name]) => isMandatoryPort(name, isScoped));
-    const regularPorts = portsInScope.filter(([name]) => !isMandatoryPort(name, isScoped));
-    let minRegularExplicitOrder = Infinity;
-    for (const [, portDef] of regularPorts) {
+    const occupied = /* @__PURE__ */ new Set();
+    for (const [, portDef] of portsInScope) {
       const order = portDef.metadata?.order;
       if (typeof order === "number") {
-        minRegularExplicitOrder = Math.min(minRegularExplicitOrder, order);
+        occupied.add(order);
       }
     }
-    let mandatoryStartOrder = 0;
-    if (minRegularExplicitOrder !== Infinity && minRegularExplicitOrder === 0) {
-      const regularPortsWithOrder0 = regularPorts.filter(([, p]) => p.metadata?.order === 0);
-      mandatoryStartOrder = regularPortsWithOrder0.length;
-    }
-    let currentMandatoryOrder = mandatoryStartOrder;
-    for (const [, portDef] of mandatoryPorts) {
-      if (portDef.metadata?.order === void 0) {
-        if (!portDef.metadata) {
-          portDef.metadata = {};
-        }
-        portDef.metadata.order = currentMandatoryOrder++;
-      }
+    const mandatoryNeedOrder = portsInScope.filter(
+      ([name, def]) => isMandatoryPort(name, isScoped) && def.metadata?.order === void 0
+    );
+    const regularNeedOrder = portsInScope.filter(
+      ([name, def]) => !isMandatoryPort(name, isScoped) && def.metadata?.order === void 0
+    );
+    let slot = -mandatoryNeedOrder.length;
+    for (const [, portDef] of mandatoryNeedOrder) {
+      if (!portDef.metadata) portDef.metadata = {};
+      slot = nextSlot2(slot);
+      portDef.metadata.order = slot;
+      slot++;
     }
-    let currentRegularOrder = currentMandatoryOrder;
-    for (const [, portDef] of regularPorts) {
-      if (portDef.metadata?.order === void 0) {
-        if (!portDef.metadata) {
-          portDef.metadata = {};
-        }
-        portDef.metadata.order = currentRegularOrder++;
-      }
+    slot = Math.max(slot, 0);
+    for (const [, portDef] of regularNeedOrder) {
+      if (!portDef.metadata) portDef.metadata = {};
+      slot = nextSlot2(slot);
+      portDef.metadata.order = slot;
+      slot++;
     }
   }
 }
@@ -60592,7 +60593,7 @@ function renderSVG(graph, options = {}) {
 function renderConnection(parts2, conn, gradIndex) {
   const dashAttr = conn.isStepConnection ? "" : ' stroke-dasharray="8 4"';
   parts2.push(
-    `  <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="3"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}"/>`
+    `  <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="3"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`
   );
 }
 function renderScopeConnection(parts2, conn, allConnections) {
@@ -60600,7 +60601,7 @@ function renderScopeConnection(parts2, conn, allConnections) {
   if (gradIndex < 0) return;
   const dashAttr = conn.isStepConnection ? "" : ' stroke-dasharray="8 4"';
   parts2.push(
-    `    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}"/>`
+    `    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`
   );
 }
 function renderNodeBody(parts2, node, theme, indent) {
@@ -60681,7 +60682,7 @@ function renderPortDots(parts2, nodeId, inputs, outputs, themeName) {
     const color = getPortColor(port.dataType, port.isFailure, themeName);
     const ringColor = getPortRingColor(port.dataType, port.isFailure, themeName);
     const dir = port.direction === "INPUT" ? "input" : "output";
-    parts2.push(`    <circle cx="${port.cx}" cy="${port.cy}" r="${PORT_RADIUS}" fill="${color}" stroke="${ringColor}" stroke-width="2" data-port-id="${escapeXml(nodeId)}.${escapeXml(port.name)}" data-direction="${dir}"/>`);
+    parts2.push(`    <circle cx="${port.cx}" cy="${port.cy}" r="${PORT_RADIUS}" fill="${color}" stroke="${ringColor}" stroke-width="2" data-port-id="${escapeXml(nodeId)}.${escapeXml(port.name)}:${dir}" data-direction="${dir}"/>`);
   }
 }
 function renderPortLabels(parts2, nodeId, inputs, outputs, theme, themeName) {
@@ -60689,7 +60690,8 @@ function renderPortLabels(parts2, nodeId, inputs, outputs, theme, themeName) {
     const color = getPortColor(port.dataType, port.isFailure, themeName);
     const isInput = port.direction === "INPUT";
     const abbrev = TYPE_ABBREVIATIONS[port.dataType] ?? port.dataType;
-    const portId = `${escapeXml(nodeId)}.${escapeXml(port.name)}`;
+    const dir = isInput ? "input" : "output";
+    const portId = `${escapeXml(nodeId)}.${escapeXml(port.name)}:${dir}`;
     const portLabel = port.label;
     const typeWidth = measureText(abbrev);
     const labelWidth = measureText(portLabel);
@@ -60983,43 +60985,79 @@ body.node-active .connections path.dimmed { opacity: 0.15; }
     else if (e.key === 'Escape') deselectNode();
   });
 
-  // ---- Port label visibility via JS (since CSS sibling selectors can't reach .labels group) ----
-  var labelEls = content.querySelectorAll('.labels g[data-port-label]');
-  var nodeEls = content.querySelectorAll('.nodes g[data-node-id]');
+  // ---- Port label visibility ----
+  var labelMap = {};
+  content.querySelectorAll('.labels g[data-port-label]').forEach(function(lbl) {
+    labelMap[lbl.getAttribute('data-port-label')] = lbl;
+  });
 
-  function showLabelsFor(id) {
-    labelEls.forEach(function(lbl) {
-      var portId = lbl.getAttribute('data-port-label') || '';
-      if (portId.indexOf(id + '.') === 0) {
-        lbl.style.opacity = '1';
-        lbl.style.pointerEvents = 'auto';
-      }
+  // Build adjacency: portId \u2192 array of connected portIds
+  var portConnections = {};
+  content.querySelectorAll('.connections path').forEach(function(p) {
+    var src = p.getAttribute('data-source');
+    var tgt = p.getAttribute('data-target');
+    if (!src || !tgt) return;
+    if (!portConnections[src]) portConnections[src] = [];
+    if (!portConnections[tgt]) portConnections[tgt] = [];
+    portConnections[src].push(tgt);
+    portConnections[tgt].push(src);
+  });
+
+  var allLabelIds = Object.keys(labelMap);
+  var hoveredPort = null;
+
+  function showLabel(id) { var l = labelMap[id]; if (l) { l.style.opacity = '1'; l.style.pointerEvents = 'auto'; } }
+  function hideLabel(id) { var l = labelMap[id]; if (l) { l.style.opacity = '0'; l.style.pointerEvents = 'none'; } }
+
+  function showLabelsFor(nodeId) {
+    allLabelIds.forEach(function(id) {
+      if (id.indexOf(nodeId + '.') === 0) showLabel(id);
     });
   }
-  function hideLabelsFor(id) {
-    labelEls.forEach(function(lbl) {
-      var portId = lbl.getAttribute('data-port-label') || '';
-      if (portId.indexOf(id + '.') === 0) {
-        lbl.style.opacity = '0';
-        lbl.style.pointerEvents = 'none';
-      }
+  function hideLabelsFor(nodeId) {
+    allLabelIds.forEach(function(id) {
+      if (id.indexOf(nodeId + '.') === 0) hideLabel(id);
     });
   }
 
+  // Node hover: show all port labels for the hovered node
+  var nodeEls = content.querySelectorAll('.nodes g[data-node-id]');
   nodeEls.forEach(function(nodeG) {
     var nodeId = nodeG.getAttribute('data-node-id');
     var parentNodeG = nodeG.parentElement ? nodeG.parentElement.closest('g[data-node-id]') : null;
     var parentId = parentNodeG ? parentNodeG.getAttribute('data-node-id') : null;
     nodeG.addEventListener('mouseenter', function() {
+      if (hoveredPort) return; // port hover takes priority
       if (parentId) hideLabelsFor(parentId);
       showLabelsFor(nodeId);
     });
     nodeG.addEventListener('mouseleave', function() {
+      if (hoveredPort) return;
       hideLabelsFor(nodeId);
       if (parentId) showLabelsFor(parentId);
     });
   });
 
+  // Port hover: show this port's label + all connected port labels
+  content.querySelectorAll('[data-port-id]').forEach(function(portEl) {
+    var portId = portEl.getAttribute('data-port-id');
+    var nodeId = portId.split('.')[0];
+    var peers = (portConnections[portId] || []).concat(portId);
+
+    portEl.addEventListener('mouseenter', function() {
+      hoveredPort = portId;
+      // Hide all labels for this node first, then show only the relevant ones
+      hideLabelsFor(nodeId);
+      peers.forEach(showLabel);
+    });
+    portEl.addEventListener('mouseleave', function() {
+      hoveredPort = null;
+      peers.forEach(hideLabel);
+      // Restore all labels for the node since we're still inside it
+      showLabelsFor(nodeId);
+    });
+  });
+
   // ---- Click to inspect node ----
   function deselectNode() {
     selectedNodeId = null;
@@ -61046,7 +61084,7 @@ body.node-active .connections path.dimmed { opacity: 0.15; }
     ports.forEach(function(p) {
       var id = p.getAttribute('data-port-id');
       var dir = p.getAttribute('data-direction');
-      var name = id.split('.').slice(1).join('.');
+      var name = id.split('.').slice(1).join('.').replace(/:(?:input|output)$/, '');
       if (dir === 'input') inputs.push(name);
       else outputs.push(name);
     });
@@ -95710,7 +95748,7 @@ function displayInstalledPackage(pkg) {
 }
 
 // src/cli/index.ts
-var version2 = true ? "0.9.0" : "0.0.0-dev";
+var version2 = true ? "0.9.1" : "0.0.0-dev";
 var program2 = new Command();
 program2.name("flow-weaver").description("Flow Weaver Annotations - Compile and validate workflow files").version(version2, "-v, --version", "Output the current version");
 program2.configureOutput({

package/dist/diagram/html-viewer.js

@@ -266,43 +266,79 @@ body.node-active .connections path.dimmed { opacity: 0.15; }
     else if (e.key === 'Escape') deselectNode();
   });
 
-  // ---- Port label visibility via JS (since CSS sibling selectors can't reach .labels group) ----
-  var labelEls = content.querySelectorAll('.labels g[data-port-label]');
-  var nodeEls = content.querySelectorAll('.nodes g[data-node-id]');
+  // ---- Port label visibility ----
+  var labelMap = {};
+  content.querySelectorAll('.labels g[data-port-label]').forEach(function(lbl) {
+    labelMap[lbl.getAttribute('data-port-label')] = lbl;
+  });
 
-  function showLabelsFor(id) {
-    labelEls.forEach(function(lbl) {
-      var portId = lbl.getAttribute('data-port-label') || '';
-      if (portId.indexOf(id + '.') === 0) {
-        lbl.style.opacity = '1';
-        lbl.style.pointerEvents = 'auto';
-      }
+  // Build adjacency: portId → array of connected portIds
+  var portConnections = {};
+  content.querySelectorAll('.connections path').forEach(function(p) {
+    var src = p.getAttribute('data-source');
+    var tgt = p.getAttribute('data-target');
+    if (!src || !tgt) return;
+    if (!portConnections[src]) portConnections[src] = [];
+    if (!portConnections[tgt]) portConnections[tgt] = [];
+    portConnections[src].push(tgt);
+    portConnections[tgt].push(src);
+  });
+
+  var allLabelIds = Object.keys(labelMap);
+  var hoveredPort = null;
+
+  function showLabel(id) { var l = labelMap[id]; if (l) { l.style.opacity = '1'; l.style.pointerEvents = 'auto'; } }
+  function hideLabel(id) { var l = labelMap[id]; if (l) { l.style.opacity = '0'; l.style.pointerEvents = 'none'; } }
+
+  function showLabelsFor(nodeId) {
+    allLabelIds.forEach(function(id) {
+      if (id.indexOf(nodeId + '.') === 0) showLabel(id);
     });
   }
-  function hideLabelsFor(id) {
-    labelEls.forEach(function(lbl) {
-      var portId = lbl.getAttribute('data-port-label') || '';
-      if (portId.indexOf(id + '.') === 0) {
-        lbl.style.opacity = '0';
-        lbl.style.pointerEvents = 'none';
-      }
+  function hideLabelsFor(nodeId) {
+    allLabelIds.forEach(function(id) {
+      if (id.indexOf(nodeId + '.') === 0) hideLabel(id);
     });
   }
 
+  // Node hover: show all port labels for the hovered node
+  var nodeEls = content.querySelectorAll('.nodes g[data-node-id]');
   nodeEls.forEach(function(nodeG) {
     var nodeId = nodeG.getAttribute('data-node-id');
     var parentNodeG = nodeG.parentElement ? nodeG.parentElement.closest('g[data-node-id]') : null;
     var parentId = parentNodeG ? parentNodeG.getAttribute('data-node-id') : null;
     nodeG.addEventListener('mouseenter', function() {
+      if (hoveredPort) return; // port hover takes priority
       if (parentId) hideLabelsFor(parentId);
       showLabelsFor(nodeId);
     });
     nodeG.addEventListener('mouseleave', function() {
+      if (hoveredPort) return;
       hideLabelsFor(nodeId);
       if (parentId) showLabelsFor(parentId);
     });
   });
 
+  // Port hover: show this port's label + all connected port labels
+  content.querySelectorAll('[data-port-id]').forEach(function(portEl) {
+    var portId = portEl.getAttribute('data-port-id');
+    var nodeId = portId.split('.')[0];
+    var peers = (portConnections[portId] || []).concat(portId);
+
+    portEl.addEventListener('mouseenter', function() {
+      hoveredPort = portId;
+      // Hide all labels for this node first, then show only the relevant ones
+      hideLabelsFor(nodeId);
+      peers.forEach(showLabel);
+    });
+    portEl.addEventListener('mouseleave', function() {
+      hoveredPort = null;
+      peers.forEach(hideLabel);
+      // Restore all labels for the node since we're still inside it
+      showLabelsFor(nodeId);
+    });
+  });
+
   // ---- Click to inspect node ----
   function deselectNode() {
     selectedNodeId = null;
@@ -329,7 +365,7 @@ body.node-active .connections path.dimmed { opacity: 0.15; }
     ports.forEach(function(p) {
       var id = p.getAttribute('data-port-id');
       var dir = p.getAttribute('data-direction');
-      var name = id.split('.').slice(1).join('.');
+      var name = id.split('.').slice(1).join('.').replace(/:(?:input|output)$/, '');
       if (dir === 'input') inputs.push(name);
       else outputs.push(name);
     });

package/dist/diagram/renderer.js

@@ -90,14 +90,14 @@ export function renderSVG(graph, options = {}) {
 // ---- Connection rendering ----
 function renderConnection(parts, conn, gradIndex) {
     const dashAttr = conn.isStepConnection ? '' : ' stroke-dasharray="8 4"';
-    parts.push(`  <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="3"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}"/>`);
+    parts.push(`  <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="3"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`);
 }
 function renderScopeConnection(parts, conn, allConnections) {
     const gradIndex = allConnections.indexOf(conn);
     if (gradIndex < 0)
         return;
     const dashAttr = conn.isStepConnection ? '' : ' stroke-dasharray="8 4"';
-    parts.push(`    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}"/>`);
+    parts.push(`    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`);
 }
 // ---- Node rendering ----
 /** Render node body rect + icon */
@@ -183,7 +183,7 @@ function renderPortDots(parts, nodeId, inputs, outputs, themeName) {
         const color = getPortColor(port.dataType, port.isFailure, themeName);
         const ringColor = getPortRingColor(port.dataType, port.isFailure, themeName);
         const dir = port.direction === 'INPUT' ? 'input' : 'output';
-        parts.push(`    <circle cx="${port.cx}" cy="${port.cy}" r="${PORT_RADIUS}" fill="${color}" stroke="${ringColor}" stroke-width="2" data-port-id="${escapeXml(nodeId)}.${escapeXml(port.name)}" data-direction="${dir}"/>`);
+        parts.push(`    <circle cx="${port.cx}" cy="${port.cy}" r="${PORT_RADIUS}" fill="${color}" stroke="${ringColor}" stroke-width="2" data-port-id="${escapeXml(nodeId)}.${escapeXml(port.name)}:${dir}" data-direction="${dir}"/>`);
     }
 }
 /** Render only port label badges (no dots) */
@@ -192,7 +192,8 @@ function renderPortLabels(parts, nodeId, inputs, outputs, theme, themeName) {
         const color = getPortColor(port.dataType, port.isFailure, themeName);
         const isInput = port.direction === 'INPUT';
         const abbrev = TYPE_ABBREVIATIONS[port.dataType] ?? port.dataType;
-        const portId = `${escapeXml(nodeId)}.${escapeXml(port.name)}`;
+        const dir = isInput ? 'input' : 'output';
+        const portId = `${escapeXml(nodeId)}.${escapeXml(port.name)}:${dir}`;
         const portLabel = port.label;
         const typeWidth = measureText(abbrev);
         const labelWidth = measureText(portLabel);

package/dist/utils/port-ordering.d.ts

@@ -14,11 +14,11 @@ export declare function isMandatoryPort(portName: string, isScoped: boolean): bo
  *
  * Rules:
  * 1. Ports are grouped by scope (undefined = external, string = scoped)
- * 2. Within each scope group:
- *    - Mandatory ports (execute, onSuccess, onFailure) get lower order values
- *    - Regular ports get higher order values
- * 3. Explicit order metadata is always preserved
- * 4. If a regular port has explicit order 0, mandatory ports are pushed to order >= 1
+ * 2. Explicit order metadata is always preserved
+ * 3. Mandatory ports without explicit orders get negative slots (-N, ..., -1)
+ *    so they always sort before any user-specified [order:0] data port
+ * 4. Regular ports without explicit orders fill non-negative slots (0+),
+ *    skipping any slots already occupied by explicit orders
  *
  * @param ports - Record of port definitions to process (mutated in place)
  */

package/dist/utils/port-ordering.js

@@ -19,11 +19,11 @@ export function isMandatoryPort(portName, isScoped) {
  *
  * Rules:
  * 1. Ports are grouped by scope (undefined = external, string = scoped)
- * 2. Within each scope group:
- *    - Mandatory ports (execute, onSuccess, onFailure) get lower order values
- *    - Regular ports get higher order values
- * 3. Explicit order metadata is always preserved
- * 4. If a regular port has explicit order 0, mandatory ports are pushed to order >= 1
+ * 2. Explicit order metadata is always preserved
+ * 3. Mandatory ports without explicit orders get negative slots (-N, ..., -1)
+ *    so they always sort before any user-specified [order:0] data port
+ * 4. Regular ports without explicit orders fill non-negative slots (0+),
+ *    skipping any slots already occupied by explicit orders
  *
  * @param ports - Record of port definitions to process (mutated in place)
  */
@@ -40,48 +40,41 @@ export function assignImplicitPortOrders(ports) {
     // Process each scope group independently
     for (const [scope, portsInScope] of scopeGroups.entries()) {
         const isScoped = scope !== undefined;
-        // Separate mandatory from regular ports
-        const mandatoryPorts = portsInScope.filter(([name]) => isMandatoryPort(name, isScoped));
-        const regularPorts = portsInScope.filter(([name]) => !isMandatoryPort(name, isScoped));
-        // Find minimum explicit order among regular ports (if any)
-        let minRegularExplicitOrder = Infinity;
-        for (const [, portDef] of regularPorts) {
+        // Collect all explicitly occupied order slots
+        const occupied = new Set();
+        for (const [, portDef] of portsInScope) {
             const order = portDef.metadata?.order;
             if (typeof order === "number") {
-                minRegularExplicitOrder = Math.min(minRegularExplicitOrder, order);
+                occupied.add(order);
             }
         }
-        // Determine starting order for mandatory ports
-        let mandatoryStartOrder = 0;
-        // If a regular port has explicit order 0 (or any low value),
-        // mandatory ports should be pushed after it
-        if (minRegularExplicitOrder !== Infinity && minRegularExplicitOrder === 0) {
-            // Count how many regular ports have explicit order 0
-            const regularPortsWithOrder0 = regularPorts.filter(([, p]) => p.metadata?.order === 0);
-            mandatoryStartOrder = regularPortsWithOrder0.length;
+        // Helper: find next available slot starting from `from`
+        function nextSlot(from) {
+            while (occupied.has(from))
+                from++;
+            occupied.add(from);
+            return from;
         }
-        // Assign orders to mandatory ports (if they don't have explicit order)
-        let currentMandatoryOrder = mandatoryStartOrder;
-        for (const [, portDef] of mandatoryPorts) {
-            if (portDef.metadata?.order === undefined) {
-                // Assign implicit order
-                if (!portDef.metadata) {
-                    portDef.metadata = {};
-                }
-                portDef.metadata.order = currentMandatoryOrder++;
-            }
+        // Separate mandatory from regular ports (only those needing implicit orders)
+        const mandatoryNeedOrder = portsInScope.filter(([name, def]) => isMandatoryPort(name, isScoped) && def.metadata?.order === undefined);
+        const regularNeedOrder = portsInScope.filter(([name, def]) => !isMandatoryPort(name, isScoped) && def.metadata?.order === undefined);
+        // Mandatory ports fill negative slots so they always sort before [order:0] data ports
+        let slot = -mandatoryNeedOrder.length;
+        for (const [, portDef] of mandatoryNeedOrder) {
+            if (!portDef.metadata)
+                portDef.metadata = {};
+            slot = nextSlot(slot);
+            portDef.metadata.order = slot;
+            slot++;
         }
-        // Assign orders to regular ports (if they don't have explicit order)
-        // Regular ports start after mandatory ports
-        let currentRegularOrder = currentMandatoryOrder;
-        for (const [, portDef] of regularPorts) {
-            if (portDef.metadata?.order === undefined) {
-                // Assign implicit order
-                if (!portDef.metadata) {
-                    portDef.metadata = {};
-                }
-                portDef.metadata.order = currentRegularOrder++;
-            }
+        // Regular ports fill non-negative slots, skipping occupied ones
+        slot = Math.max(slot, 0);
+        for (const [, portDef] of regularNeedOrder) {
+            if (!portDef.metadata)
+                portDef.metadata = {};
+            slot = nextSlot(slot);
+            portDef.metadata.order = slot;
+            slot++;
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",