@jetta/cargo-stabilizer 0.1.0-11 → 0.1.0-12

package/CHANGELOG.md

@@ -13,13 +13,14 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Empty-space candidate discovery for floor and elevated slots via `@jetta/empty-spaces-manager`.
 - Supporter-top candidate slots aligned to each stacked item footprint, included in beam expansion (`top_k ∪ supporter_top`).
 - Elevated candidates must sit on a supporter `(x, z)` origin so stacked loose items copy the supporter footprint.
-- `cargo_stabilizer.pin_tie_ratio_blocks` (default `false`): when true, 3_2/2_3 groups stay pinned; otherwise every item is movable.
+- `cargo_stabilizer.pin_tie_ratio_blocks` (default `false`): when true, only **floor five-slot** `3_2`/`2_3` walls stay pinned; stacked tie-ratio items and generic groups stay movable.
 - Public contract exports: `parse_stabilizer_input`, `parse_stabilizer_output`, `safe_parse_stabilizer_input`, `safe_parse_stabilizer_output`, and related domain types.
 
 ### Changed
 
 - README documents I/O contract mapping, configuration keys, dependencies, and test/coverage commands.
 - Reorder objective is whole-cargo `transport_score`; loose-item score sum is only a tie-break. Axle, waypoint, and milkrun gates are unchanged.
+- `pin_tie_ratio_blocks` pins only floor five-slot `3_2`/`2_3` walls; stacked members of the same group stay movable.
 
 ### Testing
 

package/README.md

@@ -1,6 +1,6 @@
 # @jetta/cargo-stabilizer
 
-TypeScript library that reorders items to improve **whole-cargo transport stability**. By default every item is movable; set `cargo_stabilizer.pin_tie_ratio_blocks` to pin 3_2/2_3 groups. The reorder objective is `transport_score` (loose-item score sum is a tie-break). Implements five config-selectable strategies with organization gates (waypoint order, milkrun wall reservation) and empty-space candidate discovery (JET-2262).
+TypeScript library that reorders items to improve **whole-cargo transport stability**. By default every item is movable; set `cargo_stabilizer.pin_tie_ratio_blocks` to pin **floor five-slot** `3_2`/`2_3` walls. Stacked tie-ratio pieces and generic groups stay movable one item at a time. The reorder objective is `transport_score` (loose-item score sum is a tie-break). Implements five config-selectable strategies with organization gates (waypoint order, milkrun wall reservation) and empty-space candidate discovery (JET-2262).
 
 ## Requirements
 
@@ -73,7 +73,7 @@ Exported parsers: `parse_stabilizer_input`, `parse_stabilizer_output`, `safe_par
 | `cargo_stabilizer.transport_stability_floor` | `0` | Hard minimum transport stability score (gate, not the maximize objective) |
 | `cargo_stabilizer.max_iteration` | `10` | Greedy / SA iteration budget |
 | `cargo_stabilizer.preserve_tie_block_organization` | `true` | When true, enforce waypoint Z zones and macro delivery order |
-| `cargo_stabilizer.pin_tie_ratio_blocks` | `false` | When true, do not move 3_2/2_3 groups; other items remain movable |
+| `cargo_stabilizer.pin_tie_ratio_blocks` | `false` | When true, do not move floor five-slot `3_2`/`2_3` walls; stacked tie-ratio items and other groups remain movable |
 | `cargo_stabilizer.enforce_milkrun_wall_reservation` | `false` | When true, reserve rear compound-wall Z bands using profile key below |
 | `number_of_wall_to_allocate_from_last_waypoints` | `0` | Count of trailing waypoints whose compound walls are reserved (read from `cargo_state.config.algoritmo` when milkrun enforcement is enabled) |
 | `folga_de_peso_nos_eixos` | `0` | Axle folga percent |

package/build/core/filters/collect_movable_items.d.ts

@@ -3,7 +3,7 @@ import type { LooseItemRef } from './loose_item_filter.js';
 /**
  * Collects items the stabilizer may move.
  * @param containers - Container list from env.
- * @param pin_tie_ratio_blocks - When true, skip 3_2/2_3 groups.
+ * @param pin_tie_ratio_blocks - When true, skip floor five-slot 3_2/2_3 walls.
  * @returns Movable item references with container index.
  */
 export declare function collect_movable_items(containers: {
@@ -11,8 +11,8 @@ export declare function collect_movable_items(containers: {
 }[], pin_tie_ratio_blocks: boolean): LooseItemRef[];
 /**
  * @param item - Item record.
- * @param tie_ratio_group_ids - Group ids that contain a 3_2/2_3 member.
- * @returns True when the item belongs to a pinned tie-ratio group.
+ * @param pinned_group_ids - Floor five-slot 3_2/2_3 group ids.
+ * @returns True when the item is a floor member of a pinned wall.
  */
-export declare function is_tie_ratio_block_item(item: StabilizerItem, tie_ratio_group_ids: Set<string>): boolean;
+export declare function is_tie_ratio_block_item(item: StabilizerItem, pinned_group_ids: Set<string>): boolean;
 //# sourceMappingURL=collect_movable_items.d.ts.map

package/build/core/filters/collect_movable_items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect_movable_items.d.ts","sourceRoot":"","sources":["../../../src/core/filters/collect_movable_items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AAExF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,UAAU,EAAE;IAAE,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,EAAE,EACzC,oBAAoB,EAAE,OAAO,GAC9B,YAAY,EAAE,CAMhB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,cAAc,EACpB,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,GACjC,OAAO,CAOT"}
+{"version":3,"file":"collect_movable_items.d.ts","sourceRoot":"","sources":["../../../src/core/filters/collect_movable_items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAI1D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,UAAU,EAAE;IAAE,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,EAAE,EACzC,oBAAoB,EAAE,OAAO,GAC9B,YAAY,EAAE,CAMhB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,cAAc,EACpB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,OAAO,CAOT"}

package/build/core/filters/collect_movable_items.js

@@ -1,38 +1,27 @@
-import { TIE_RATIO_ORIENTATION } from '../constants/TieRatioOrientation.js';
+import { collect_pinned_floor_tie_ratio_group_ids } from './collect_pinned_floor_tie_ratio_group_ids.js';
+import { is_item_on_cm_floor } from './is_item_on_cm_floor.js';
 /**
  * Collects items the stabilizer may move.
  * @param containers - Container list from env.
- * @param pin_tie_ratio_blocks - When true, skip 3_2/2_3 groups.
+ * @param pin_tie_ratio_blocks - When true, skip floor five-slot 3_2/2_3 walls.
  * @returns Movable item references with container index.
  */
 export function collect_movable_items(containers, pin_tie_ratio_blocks) {
     const pinned_groups = pin_tie_ratio_blocks
-        ? collect_tie_ratio_group_ids(flatten_container_items(containers))
+        ? collect_pinned_floor_tie_ratio_group_ids(flatten_container_items(containers))
         : new Set();
     return collect_items_except_pinned(containers, pinned_groups);
 }
 /**
  * @param item - Item record.
- * @param tie_ratio_group_ids - Group ids that contain a 3_2/2_3 member.
- * @returns True when the item belongs to a pinned tie-ratio group.
+ * @param pinned_group_ids - Floor five-slot 3_2/2_3 group ids.
+ * @returns True when the item is a floor member of a pinned wall.
  */
-export function is_tie_ratio_block_item(item, tie_ratio_group_ids) {
-    if (item.group_id == null) {
+export function is_tie_ratio_block_item(item, pinned_group_ids) {
+    if (item.group_id == null || !is_item_on_cm_floor(item)) {
         return false;
     }
-    return tie_ratio_group_ids.has(item.group_id);
-}
-function collect_tie_ratio_group_ids(items) {
-    const group_ids = new Set();
-    for (const item of items) {
-        if (item.group_id == null) {
-            continue;
-        }
-        if (is_tie_ratio_orientation(read_tie_ratio_orientation(item))) {
-            group_ids.add(item.group_id);
-        }
-    }
-    return group_ids;
+    return pinned_group_ids.has(item.group_id);
 }
 function collect_items_except_pinned(containers, pinned_groups) {
     const movable = [];
@@ -62,11 +51,3 @@ function flatten_container_items(containers) {
     }
     return items;
 }
-function read_tie_ratio_orientation(item) {
-    const orientation = item.attributes?.tie_ratio_orientation;
-    return typeof orientation === 'string' ? orientation : undefined;
-}
-function is_tie_ratio_orientation(orientation) {
-    return orientation === TIE_RATIO_ORIENTATION.THREE_TWO
-        || orientation === TIE_RATIO_ORIENTATION.TWO_THREE;
-}

package/build/core/filters/collect_pinned_floor_tie_ratio_group_ids.d.ts

@@ -0,0 +1,8 @@
+import type { StabilizerItem } from '../validation/contract/stabilizer_domain_schema.js';
+/**
+ * Group ids of floor five-slot 3_2/2_3 walls that the stabilizer must pin.
+ * @param items - All items in the cargo.
+ * @returns Group ids with exactly five floor tie-ratio members.
+ */
+export declare function collect_pinned_floor_tie_ratio_group_ids(items: StabilizerItem[]): Set<string>;
+//# sourceMappingURL=collect_pinned_floor_tie_ratio_group_ids.d.ts.map

package/build/core/filters/collect_pinned_floor_tie_ratio_group_ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect_pinned_floor_tie_ratio_group_ids.d.ts","sourceRoot":"","sources":["../../../src/core/filters/collect_pinned_floor_tie_ratio_group_ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AAMxF;;;;GAIG;AACH,wBAAgB,wCAAwC,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ7F"}

package/build/core/filters/collect_pinned_floor_tie_ratio_group_ids.js

@@ -0,0 +1,41 @@
+import { TIE_RATIO_ORIENTATION } from '../constants/TieRatioOrientation.js';
+import { is_item_on_cm_floor } from './is_item_on_cm_floor.js';
+const FULL_TIE_RATIO_FLOOR_COUNT = 5;
+/**
+ * Group ids of floor five-slot 3_2/2_3 walls that the stabilizer must pin.
+ * @param items - All items in the cargo.
+ * @returns Group ids with exactly five floor tie-ratio members.
+ */
+export function collect_pinned_floor_tie_ratio_group_ids(items) {
+    const floor_tie_count_by_group = new Map();
+    for (const item of items) {
+        add_floor_tie_member(floor_tie_count_by_group, item);
+    }
+    return groups_with_full_floor_wall(floor_tie_count_by_group);
+}
+function add_floor_tie_member(counts, item) {
+    if (item.group_id == null || !is_item_on_cm_floor(item)) {
+        return;
+    }
+    if (!is_tie_ratio_orientation(read_tie_ratio_orientation(item))) {
+        return;
+    }
+    counts.set(item.group_id, (counts.get(item.group_id) ?? 0) + 1);
+}
+function groups_with_full_floor_wall(counts) {
+    const pinned = new Set();
+    for (const [group_id, count] of counts) {
+        if (count === FULL_TIE_RATIO_FLOOR_COUNT) {
+            pinned.add(group_id);
+        }
+    }
+    return pinned;
+}
+function read_tie_ratio_orientation(item) {
+    const orientation = item.attributes?.tie_ratio_orientation;
+    return typeof orientation === 'string' ? orientation : undefined;
+}
+function is_tie_ratio_orientation(orientation) {
+    return orientation === TIE_RATIO_ORIENTATION.THREE_TWO
+        || orientation === TIE_RATIO_ORIENTATION.TWO_THREE;
+}

package/build/core/filters/is_item_on_cm_floor.d.ts

@@ -0,0 +1,8 @@
+import type { StabilizerItem } from '../validation/contract/stabilizer_domain_schema.js';
+/**
+ * True when the item rests on the cargo-movement floor (z is height).
+ * @param item - Stabilizer item in CM coordinates.
+ * @returns True when height origin is on the floor.
+ */
+export declare function is_item_on_cm_floor(item: StabilizerItem): boolean;
+//# sourceMappingURL=is_item_on_cm_floor.d.ts.map

package/build/core/filters/is_item_on_cm_floor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_item_on_cm_floor.d.ts","sourceRoot":"","sources":["../../../src/core/filters/is_item_on_cm_floor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AAIxF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAGjE"}

package/build/core/filters/is_item_on_cm_floor.js

@@ -0,0 +1,9 @@
+const CM_FLOOR_HEIGHT_EPSILON = 1e-6;
+/**
+ * True when the item rests on the cargo-movement floor (z is height).
+ * @param item - Stabilizer item in CM coordinates.
+ * @returns True when height origin is on the floor.
+ */
+export function is_item_on_cm_floor(item) {
+    return item.z <= CM_FLOOR_HEIGHT_EPSILON;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jetta/cargo-stabilizer",
-    "version": "0.1.0-11",
+    "version": "0.1.0-12",
     "description": "Stable loose-item reorder library for cargo-movement (JET-2262)",
     "main": "build/index.js",
     "types": "build/index.d.ts",