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

package/CHANGELOG.md

@@ -16,6 +16,7 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ### 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/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/package.json

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