@jetta/cargo-stabilizer 0.1.0-6 → 0.1.0-8

package/CHANGELOG.md

@@ -11,11 +11,13 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Strict English internal I/O contract with bidirectional cargo-movement wire mapper (`map_wire_input_to_contract`, `map_contract_to_wire_output`).
 - Organization gates: waypoint Z zones, macro delivery order (`preserve_tie_block_organization`), and milkrun wall reservation (`enforce_milkrun_wall_reservation`).
 - 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`).
 - 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.
 
 ### Testing
 

package/README.md

@@ -1,6 +1,6 @@
 # @jetta/cargo-stabilizer
 
-TypeScript library that reorders **loose items only** to improve cargo stability while keeping compound blocks pinned. Implements five config-selectable strategies with organization gates (waypoint order, milkrun wall reservation) and empty-space candidate discovery (JET-2262).
+TypeScript library that reorders **loose items only** to improve **whole-cargo transport stability** while keeping compound blocks pinned. 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
 
@@ -70,7 +70,7 @@ Exported parsers: `parse_stabilizer_input`, `parse_stabilizer_output`, `safe_par
 | Key | Default | Description |
 |-----|---------|-------------|
 | `cargo_stabilizer.reorder_strategy` | `gravity` | `gravity`, `greedy`, `beam_search`, `simulated_annealing`, `genetic` |
-| `cargo_stabilizer.transport_stability_floor` | `0` | Hard minimum transport stability score |
+| `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.enforce_milkrun_wall_reservation` | `false` | When true, reserve rear compound-wall Z bands using profile key below |

package/build/core/candidates/candidate_generator.d.ts

@@ -1,7 +1,7 @@
 import type { MoveCandidate } from '../move/apply_move.js';
 import type { CandidateGenerationContext } from './candidate_context.js';
 /**
- * Generates ranked candidate slots from empty-space regions for a loose item.
+ * Generates ranked candidate slots from empty-space regions and supporter tops.
  * @param context - Candidate generation context.
  * @returns Candidate moves sorted floor-first, same container preferred.
  */

package/build/core/candidates/candidate_generator.js

@@ -1,8 +1,8 @@
-import { enumerate_empty_space_slots } from './enumerate_empty_space_slots.js';
+import { collect_container_slots } from './collect_container_slots.js';
 import { is_candidate_valid } from './candidate_validation.js';
 import { rank_candidates } from './rank_candidates.js';
 /**
- * Generates ranked candidate slots from empty-space regions for a loose item.
+ * Generates ranked candidate slots from empty-space regions and supporter tops.
  * @param context - Candidate generation context.
  * @returns Candidate moves sorted floor-first, same container preferred.
  */
@@ -11,18 +11,32 @@ export function generate_candidates(context) {
     return rank_candidates(candidates, context.loose.container_index);
 }
 function build_container_candidates(context, container, target_index) {
-    const slots = enumerate_empty_space_slots(container, context.loose.item, context.loose.item_id);
     const candidates = [];
-    for (const position of slots) {
-        if (!is_candidate_valid(context, target_index, position)) {
+    for (const tagged of collect_container_slots(container, context.loose.item, context.loose.item_id)) {
+        if (!is_candidate_valid(context, target_index, tagged.position)) {
             continue;
         }
         candidates.push({
             item_id: context.loose.item_id,
             source_container_index: context.loose.container_index,
             target_container_index: target_index,
-            new_position: position
+            new_position: tagged.position,
+            slot_kind: tagged.slot_kind
         });
     }
-    return candidates;
+    return unique_kind_positions(candidates);
+}
+function unique_kind_positions(candidates) {
+    const seen = new Set();
+    const unique = [];
+    for (const candidate of candidates) {
+        const position = candidate.new_position;
+        const key = `${position.x}:${position.y}:${position.z}:${candidate.target_container_index}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(candidate);
+    }
+    return unique;
 }

package/build/core/candidates/collect_container_slots.d.ts

@@ -0,0 +1,16 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { CandidateSlotKind } from '../move/apply_move.js';
+import type { EmptySpaceSlot } from './enumerate_empty_space_slots.js';
+export interface TaggedSlot {
+    position: EmptySpaceSlot;
+    slot_kind: CandidateSlotKind;
+}
+/**
+ * Collects empty-space origins and per-supporter top origins, supporter first.
+ * @param container - Target container layout.
+ * @param item - Loose item to place.
+ * @param exclude_item_id - Loose item id omitted from obstacles and supporters.
+ * @returns Tagged slots with supporter-top entries before empty-space entries.
+ */
+export declare function collect_container_slots(container: StabilizerContainer, item: StabilizerContainer['items'][number], exclude_item_id: string): TaggedSlot[];
+//# sourceMappingURL=collect_container_slots.d.ts.map

package/build/core/candidates/collect_container_slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect_container_slots.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/collect_container_slots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAItE,MAAM,WAAW,UAAU;IAEvB,QAAQ,EAAE,cAAc,CAAA;IACxB,SAAS,EAAE,iBAAiB,CAAA;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACnC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAC1C,eAAe,EAAE,MAAM,GACxB,UAAU,EAAE,CAQd"}

package/build/core/candidates/collect_container_slots.js

@@ -0,0 +1,20 @@
+import { enumerate_empty_space_slots } from './enumerate_empty_space_slots.js';
+import { enumerate_supporter_top_slots } from './enumerate_supporter_top_slots.js';
+/**
+ * Collects empty-space origins and per-supporter top origins, supporter first.
+ * @param container - Target container layout.
+ * @param item - Loose item to place.
+ * @param exclude_item_id - Loose item id omitted from obstacles and supporters.
+ * @returns Tagged slots with supporter-top entries before empty-space entries.
+ */
+export function collect_container_slots(container, item, exclude_item_id) {
+    const supporter = enumerate_supporter_top_slots(container, item, exclude_item_id);
+    const empty = enumerate_empty_space_slots(container, item, exclude_item_id);
+    return [
+        ...tag_slots(supporter, 'supporter_top'),
+        ...tag_slots(empty, 'empty_space')
+    ];
+}
+function tag_slots(slots, slot_kind) {
+    return slots.map(position => ({ position, slot_kind }));
+}

package/build/core/candidates/enumerate_supporter_top_slots.d.ts

@@ -0,0 +1,11 @@
+import type { StabilizerContainer, StabilizerItem } from '../validation/contract/stabilizer_domain_schema.js';
+import type { EmptySpaceSlot } from './enumerate_empty_space_slots.js';
+/**
+ * Emits one candidate origin per supporter footprint (x, supporter top y, z).
+ * @param container - Target container layout.
+ * @param item - Loose item dimensions.
+ * @param exclude_item_id - Loose item id omitted as a supporter.
+ * @returns Slot positions aligned to each supporter origin.
+ */
+export declare function enumerate_supporter_top_slots(container: StabilizerContainer, item: StabilizerItem, exclude_item_id: string): EmptySpaceSlot[];
+//# sourceMappingURL=enumerate_supporter_top_slots.d.ts.map

package/build/core/candidates/enumerate_supporter_top_slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumerate_supporter_top_slots.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/enumerate_supporter_top_slots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AAC7G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAItE;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CACzC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,cAAc,EACpB,eAAe,EAAE,MAAM,GACxB,cAAc,EAAE,CAgBlB"}

package/build/core/candidates/enumerate_supporter_top_slots.js

@@ -0,0 +1,36 @@
+const CONTAINER_EPSILON = 1e-6;
+/**
+ * Emits one candidate origin per supporter footprint (x, supporter top y, z).
+ * @param container - Target container layout.
+ * @param item - Loose item dimensions.
+ * @param exclude_item_id - Loose item id omitted as a supporter.
+ * @returns Slot positions aligned to each supporter origin.
+ */
+export function enumerate_supporter_top_slots(container, item, exclude_item_id) {
+    const slots = [];
+    for (const supporter of container.items) {
+        if (supporter.item_id === exclude_item_id) {
+            continue;
+        }
+        const slot = supporter_top_slot(supporter);
+        if (slot_fits_in_container(container, item, slot)) {
+            slots.push(slot);
+        }
+    }
+    return slots;
+}
+function supporter_top_slot(supporter) {
+    return {
+        x: supporter.x,
+        y: supporter.y + supporter.height,
+        z: supporter.z
+    };
+}
+function slot_fits_in_container(container, item, slot) {
+    return slot.x >= -CONTAINER_EPSILON &&
+        slot.y >= -CONTAINER_EPSILON &&
+        slot.z >= -CONTAINER_EPSILON &&
+        slot.x + item.width <= container.width + CONTAINER_EPSILON &&
+        slot.y + item.height <= container.height + CONTAINER_EPSILON &&
+        slot.z + item.depth <= container.length + CONTAINER_EPSILON;
+}

package/build/core/evaluation/compute_reorder_objective.d.ts

@@ -0,0 +1,13 @@
+import { type StabilityEvaluation } from '../adapters/stability_adapter.js';
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { LooseItemRef } from '../filters/loose_item_filter.js';
+export declare const LOOSE_SUM_TIE_BREAK_SCALE = 0.000001;
+/**
+ * Computes the reorder objective: maximize transport stability, then loose-item sum.
+ * @param stability - Transport stability evaluation.
+ * @param containers - Container layout used for loose-item index lookup.
+ * @param loose_items - Loose items included in the tie-break term.
+ * @returns Scalar objective; higher is better.
+ */
+export declare function compute_reorder_objective(stability: StabilityEvaluation, containers: StabilizerContainer[], loose_items: LooseItemRef[]): number;
+//# sourceMappingURL=compute_reorder_objective.d.ts.map

package/build/core/evaluation/compute_reorder_objective.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute_reorder_objective.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/compute_reorder_objective.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,mBAAmB,EAC3B,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAEnE,eAAO,MAAM,yBAAyB,WAAO,CAAA;AAE7C;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,mBAAmB,EAAE,EACjC,WAAW,EAAE,YAAY,EAAE,GAC5B,MAAM,CAIR"}

package/build/core/evaluation/compute_reorder_objective.js

@@ -0,0 +1,13 @@
+import { sum_loose_item_scores } from '../adapters/stability_adapter.js';
+export const LOOSE_SUM_TIE_BREAK_SCALE = 1e-6;
+/**
+ * Computes the reorder objective: maximize transport stability, then loose-item sum.
+ * @param stability - Transport stability evaluation.
+ * @param containers - Container layout used for loose-item index lookup.
+ * @param loose_items - Loose items included in the tie-break term.
+ * @returns Scalar objective; higher is better.
+ */
+export function compute_reorder_objective(stability, containers, loose_items) {
+    const loose_sum = sum_loose_item_scores(stability, containers, loose_items);
+    return stability.transport_score + loose_sum * LOOSE_SUM_TIE_BREAK_SCALE;
+}

package/build/core/evaluation/state_evaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state_evaluator.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/state_evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,EAGH,KAAK,mBAAmB,EAC3B,MAAM,kCAAkC,CAAA;AAKzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAA;AAE9E,MAAM,WAAW,gBAAgB;IAE7B,SAAS,EAAE,mBAAmB,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,EAAE,OAAO,CAAA;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;IACtB,cAAc,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,sBAAsB,GAChC,gBAAgB,CAUlB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,mBAAmB,EAAE,EAC5B,OAAO,EAAE,sBAAsB,GAChC,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,CAU/F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAGvF;AAwBD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,sBAAsB,GAChC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAMrD"}
+{"version":3,"file":"state_evaluator.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/state_evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,EAEH,KAAK,mBAAmB,EAC3B,MAAM,kCAAkC,CAAA;AAMzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAA;AAE9E,MAAM,WAAW,gBAAgB;IAE7B,SAAS,EAAE,mBAAmB,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,EAAE,OAAO,CAAA;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;IACtB,cAAc,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,sBAAsB,GAChC,gBAAgB,CAUlB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,mBAAmB,EAAE,EAC5B,OAAO,EAAE,sBAAsB,GAChC,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,CAU/F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAGvF;AAwBD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,sBAAsB,GAChC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAMrD"}

package/build/core/evaluation/state_evaluator.js

@@ -1,4 +1,5 @@
-import { try_evaluate_transport_stability, sum_loose_item_scores } from '../adapters/stability_adapter.js';
+import { try_evaluate_transport_stability } from '../adapters/stability_adapter.js';
+import { compute_reorder_objective } from './compute_reorder_objective.js';
 import { is_axle_load_valid } from '../adapters/axle_adapter.js';
 import { preserves_waypoint_order } from '../waypoint/preserves_waypoint_order.js';
 import { is_layout_milkrun_valid } from '../waypoint/milkrun_wall_reservation.js';
@@ -50,7 +51,7 @@ export function clone_baseline(containers) {
     return clone_containers(containers);
 }
 function evaluate_gates(containers, context, stability) {
-    const objective = sum_loose_item_scores(stability, containers, context.loose_items);
+    const objective = compute_reorder_objective(stability, containers, context.loose_items);
     const transport_floor_valid = stability.transport_score >= context.config.transport_stability_floor;
     const axle_valid = is_axle_load_valid({ ...context.env, containers }, context.config.axle_load_margin_percent);
     const waypoint_valid = is_waypoint_order_valid(containers, context);

package/build/core/move/apply_move.d.ts

@@ -1,4 +1,5 @@
 import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+export type CandidateSlotKind = 'empty_space' | 'supporter_top';
 export interface MoveCandidate {
     item_id: string;
     source_container_index: number;
@@ -8,6 +9,7 @@ export interface MoveCandidate {
         y: number;
         z: number;
     };
+    slot_kind?: CandidateSlotKind;
 }
 /**
  * Applies a move candidate to containers (mutates arrays in place).

package/build/core/move/apply_move.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply_move.d.ts","sourceRoot":"","sources":["../../../src/core/move/apply_move.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAE7F,MAAM,WAAW,aAAa;IAE1B,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB,EAAE,MAAM,CAAA;IAC9B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,YAAY,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACpD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACtB,UAAU,EAAE,mBAAmB,EAAE,EACjC,SAAS,EAAE,aAAa,GACzB,IAAI,CAgBN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAGzF"}
+{"version":3,"file":"apply_move.d.ts","sourceRoot":"","sources":["../../../src/core/move/apply_move.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAE7F,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,eAAe,CAAA;AAE/D,MAAM,WAAW,aAAa;IAE1B,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB,EAAE,MAAM,CAAA;IAC9B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,YAAY,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACjD,SAAS,CAAC,EAAE,iBAAiB,CAAA;CAChC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACtB,UAAU,EAAE,mBAAmB,EAAE,EACjC,SAAS,EAAE,aAAa,GACzB,IAAI,CAgBN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAGzF"}

package/build/core/strategies/reorder/BeamSearchReorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BeamSearchReorder.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/BeamSearchReorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAA;AAYhG;;GAEG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IAErD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAkBtD"}
+{"version":3,"file":"BeamSearchReorder.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/BeamSearchReorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAA;AAahG;;GAEG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IAErD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAkBtD"}

package/build/core/strategies/reorder/BeamSearchReorder.js

@@ -1,5 +1,6 @@
 import { generate_candidates } from '../../candidates/candidate_generator.js';
 import { candidate_context_for_loose } from '../../candidates/build_candidate_context.js';
+import { select_beam_expansion_candidates } from './select_beam_expansion_candidates.js';
 import { apply_move, clone_containers } from '../../move/apply_move.js';
 import { evaluate_trial_layout, evaluation_context_from_reorder } from '../../evaluation/state_evaluator.js';
 import { read_item_score } from '../../adapters/stability_adapter.js';
@@ -39,7 +40,7 @@ function expand_beam(request) {
 function append_beam_branches(beam_context) {
     const { reorder, evaluation, expanded, state, loose } = beam_context;
     const loose_ref = { ...loose, container_index: find_container_index(state.containers, loose.item_id) };
-    const candidates = generate_candidates(candidate_context_for_loose(reorder, state.containers, loose_ref)).slice(0, reorder.config.beam_top_k);
+    const candidates = select_beam_expansion_candidates(generate_candidates(candidate_context_for_loose(reorder, state.containers, loose_ref)), reorder.config.beam_top_k);
     for (const candidate of candidates) {
         const trial = clone_containers(state.containers);
         apply_move(trial, candidate);

package/build/core/strategies/reorder/select_beam_expansion_candidates.d.ts

@@ -0,0 +1,9 @@
+import type { MoveCandidate } from '../../move/apply_move.js';
+/**
+ * Selects beam expansions: ranked top_k plus every supporter-top slot.
+ * @param ranked - Candidates already ranked floor-first.
+ * @param top_k - Beam top-k from config.
+ * @returns Candidates for trial evaluation.
+ */
+export declare function select_beam_expansion_candidates(ranked: MoveCandidate[], top_k: number): MoveCandidate[];
+//# sourceMappingURL=select_beam_expansion_candidates.d.ts.map

package/build/core/strategies/reorder/select_beam_expansion_candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select_beam_expansion_candidates.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/select_beam_expansion_candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC5C,MAAM,EAAE,aAAa,EAAE,EACvB,KAAK,EAAE,MAAM,GACd,aAAa,EAAE,CAKjB"}

package/build/core/strategies/reorder/select_beam_expansion_candidates.js

@@ -0,0 +1,28 @@
+/**
+ * Selects beam expansions: ranked top_k plus every supporter-top slot.
+ * @param ranked - Candidates already ranked floor-first.
+ * @param top_k - Beam top-k from config.
+ * @returns Candidates for trial evaluation.
+ */
+export function select_beam_expansion_candidates(ranked, top_k) {
+    const leading = ranked.slice(0, top_k);
+    const supporter_top = ranked.filter(candidate => candidate.slot_kind === 'supporter_top');
+    return unique_move_positions([...leading, ...supporter_top]);
+}
+function unique_move_positions(candidates) {
+    const seen = new Set();
+    const unique = [];
+    for (const candidate of candidates) {
+        const key = position_key(candidate);
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(candidate);
+    }
+    return unique;
+}
+function position_key(candidate) {
+    const position = candidate.new_position;
+    return `${position.x}:${position.y}:${position.z}:${candidate.target_container_index}`;
+}

package/package.json

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