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

package/build/core/geometry/box_geometry.js

@@ -1,9 +1,17 @@
+const GEOMETRY_EPSILON = 1e-6;
 /**
  * @param item - Cargo item with position and dimensions.
  * @returns Axis-aligned bounding box.
  */
 export function item_to_box(item) {
-    return { x: item.x, y: item.y, z: item.z, w: item.w, h: item.h, d: item.d };
+    return {
+        x: item.x,
+        y: item.y,
+        z: item.z,
+        w: item.width,
+        h: item.height,
+        d: item.depth
+    };
 }
 /**
  * @param left - First box.
@@ -29,5 +37,62 @@ export function has_overlap(candidate, others) {
  * @returns True when candidate rests on container floor.
  */
 export function is_on_floor(candidate) {
-    return candidate.y <= 1e-6;
+    return candidate.y <= GEOMETRY_EPSILON;
+}
+/**
+ * @param candidate - Candidate placement box.
+ * @param container - Container dimensions.
+ * @returns True when candidate fits inside container bounds.
+ */
+export function is_inside_container(candidate, container) {
+    if (candidate.x < -GEOMETRY_EPSILON || candidate.y < -GEOMETRY_EPSILON || candidate.z < -GEOMETRY_EPSILON) {
+        return false;
+    }
+    if (candidate.x + candidate.w > container.width + GEOMETRY_EPSILON) {
+        return false;
+    }
+    if (candidate.y + candidate.h > container.height + GEOMETRY_EPSILON) {
+        return false;
+    }
+    return candidate.z + candidate.d <= container.length + GEOMETRY_EPSILON;
+}
+/**
+ * @param candidate - Candidate placement box.
+ * @param supporters - Existing item boxes (excluding candidate).
+ * @returns True when bottom face is on floor or supporter tops.
+ */
+export function is_fully_supported(candidate, supporters) {
+    if (is_on_floor(candidate)) {
+        return true;
+    }
+    return sample_bottom_support_points(candidate).every(point => is_support_point_supported(point, supporters));
+}
+function sample_bottom_support_points(candidate) {
+    const { x, y, z, w, d } = candidate;
+    const mid_x = x + w / 2;
+    const mid_z = z + d / 2;
+    return [
+        { x, y, z },
+        { x: x + w, y, z },
+        { x, y, z: z + d },
+        { x: x + w, y, z: z + d },
+        { x: mid_x, y, z: mid_z }
+    ];
+}
+function is_support_point_supported(point, supporters) {
+    if (point.y <= GEOMETRY_EPSILON) {
+        return true;
+    }
+    return supporters.some(supporter => is_point_on_supporter_top(point, supporter));
+}
+function is_point_on_supporter_top(point, supporter) {
+    const top_y = supporter.y + supporter.h;
+    if (Math.abs(point.y - top_y) > GEOMETRY_EPSILON) {
+        return false;
+    }
+    const within_x = point.x >= supporter.x - GEOMETRY_EPSILON &&
+        point.x <= supporter.x + supporter.w + GEOMETRY_EPSILON;
+    const within_z = point.z >= supporter.z - GEOMETRY_EPSILON &&
+        point.z <= supporter.z + supporter.d + GEOMETRY_EPSILON;
+    return within_x && within_z;
 }

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

@@ -1,4 +1,4 @@
-import type { StabilizerContainer } from '../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
 export interface MoveCandidate {
     item_id: string;
     source_container_index: number;

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,kDAAkD,CAAA;AAE3F,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,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"}

package/build/core/move/apply_move.js

@@ -5,7 +5,7 @@
  */
 export function apply_move(containers, candidate) {
     const source = containers[candidate.source_container_index];
-    const item_index = source.items.findIndex(item => item._id === candidate.item_id);
+    const item_index = source.items.findIndex(item => item.item_id === candidate.item_id);
     if (item_index < 0) {
         return;
     }

package/build/core/orchestration/StabilizerFlow.d.ts

@@ -1,4 +1,5 @@
-import type { StabilizerInput, StabilizerCargoState } from '../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerInput } from '../validation/contract/stabilizer_input_schema.js';
+import type { StabilizerCargoState } from '../validation/contract/stabilizer_domain_schema.js';
 /**
  * Runs stabilizer flow on validated input.
  * @param input - Raw stabilizer input.

package/build/core/orchestration/StabilizerFlow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StabilizerFlow.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/StabilizerFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAA;AAO7G;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,oBAAoB,CAchF;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,OAAO,GAAG,oBAAoB,CAI1F"}
+{"version":3,"file":"StabilizerFlow.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/StabilizerFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAA;AACxF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAA;AAO9F;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,oBAAoB,CAiBhF;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,OAAO,GAAG,oBAAoB,CAI1F"}

package/build/core/orchestration/StabilizerFlow.js

@@ -1,4 +1,4 @@
-import { parse_stabilizer_input } from '../validation/parse_stabilizer_input.js';
+import { parse_stabilizer_input } from '../validation/contract/parse_stabilizer_input.js';
 import { read_stabilizer_config } from '../factory/read_stabilizer_config.js';
 import { create_reorder_strategy } from '../factory/strategy_factory.js';
 import { build_reorder_context } from './build_reorder_context.js';
@@ -9,7 +9,7 @@ import { stabilizer_logger } from '../logging/stabilizer_logger.js';
  * @returns Updated cargo_state.
  */
 export function run_stabilizer_flow(input) {
-    const config = read_stabilizer_config(input.config);
+    const config = read_stabilizer_config(input.config, input.cargo_state);
     const context = build_reorder_context(input, config);
     stabilizer_logger.debug('reorder_strategy=' + config.reorder_strategy);
     stabilizer_logger.debug('container_count=' + context.containers.length +

package/build/core/orchestration/build_milkrun_bands_from_config.d.ts

@@ -0,0 +1,13 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { StabilizerConfig } from '../validation/schemas/stabilizer_config_schema.js';
+import type { WaypointMode } from '../waypoint/WaypointMode.js';
+import type { MilkrunReservedBand } from '../waypoint/milkrun_wall_reservation_types.js';
+/**
+ * Builds milkrun reserved bands when enforcement is enabled in config.
+ * @param baseline_containers - Baseline container layout.
+ * @param waypoint_mode - Resolved waypoint mode.
+ * @param config - Parsed stabilizer config.
+ * @returns Reserved Z bands (empty when milkrun enforcement is disabled).
+ */
+export declare function build_milkrun_bands_from_config(baseline_containers: StabilizerContainer[], waypoint_mode: WaypointMode, config: StabilizerConfig): MilkrunReservedBand[];
+//# sourceMappingURL=build_milkrun_bands_from_config.d.ts.map

package/build/core/orchestration/build_milkrun_bands_from_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_milkrun_bands_from_config.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/build_milkrun_bands_from_config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAA;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAA;AAExF;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC3C,mBAAmB,EAAE,mBAAmB,EAAE,EAC1C,aAAa,EAAE,YAAY,EAC3B,MAAM,EAAE,gBAAgB,GACzB,mBAAmB,EAAE,CAMvB"}

package/build/core/orchestration/build_milkrun_bands_from_config.js

@@ -0,0 +1,14 @@
+import { build_milkrun_reserved_z_bands } from '../waypoint/milkrun_wall_reservation.js';
+/**
+ * Builds milkrun reserved bands when enforcement is enabled in config.
+ * @param baseline_containers - Baseline container layout.
+ * @param waypoint_mode - Resolved waypoint mode.
+ * @param config - Parsed stabilizer config.
+ * @returns Reserved Z bands (empty when milkrun enforcement is disabled).
+ */
+export function build_milkrun_bands_from_config(baseline_containers, waypoint_mode, config) {
+    const wall_count = config.enforce_milkrun_wall_reservation
+        ? config.number_of_wall_to_allocate_from_last_waypoints
+        : 0;
+    return build_milkrun_reserved_z_bands(baseline_containers, waypoint_mode, wall_count);
+}

package/build/core/orchestration/build_reorder_context.d.ts

@@ -1,4 +1,4 @@
-import type { StabilizerInput } from '../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerInput } from '../validation/contract/stabilizer_input_schema.js';
 import type { StabilizerConfig } from '../validation/schemas/stabilizer_config_schema.js';
 import type { ReorderContext } from '../strategies/reorder/ReorderStrategy.js';
 /**

package/build/core/orchestration/build_reorder_context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build_reorder_context.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/build_reorder_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAA;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAA;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAA;AAO9E;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,GACzB,cAAc,CAqBhB"}
+{"version":3,"file":"build_reorder_context.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/build_reorder_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAA;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAA;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAA;AAQ9E;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,GACzB,cAAc,CAsBhB"}

package/build/core/orchestration/build_reorder_context.js

@@ -1,8 +1,9 @@
 import { collect_loose_items } from '../filters/loose_item_filter.js';
 import { validate_waypoint_ids } from '../waypoint/validate_waypoint_ids.js';
 import { build_waypoint_zones } from '../waypoint/build_waypoint_zones.js';
+import { build_milkrun_bands_from_config } from './build_milkrun_bands_from_config.js';
+import { read_primary_env } from './read_primary_env.js';
 import { clone_containers } from '../move/apply_move.js';
-import { InvalidStabilizerInputError } from '../exceptions/InvalidStabilizerInputError.js';
 /**
  * Builds reorder context from validated stabilizer input.
  * @param input - Validated stabilizer input.
@@ -10,20 +11,19 @@ import { InvalidStabilizerInputError } from '../exceptions/InvalidStabilizerInpu
  * @returns Reorder context for strategy execution.
  */
 export function build_reorder_context(input, config) {
-    const env = input.cargo_state.envs[0];
-    if (!env) {
-        throw new InvalidStabilizerInputError('cargo_state.envs must contain at least one env');
-    }
+    const env = read_primary_env(input);
     const all_items = env.containers.flatMap(container => container.items);
     const waypoint_mode = validate_waypoint_ids(all_items);
     const loose_items = collect_loose_items(env.containers);
+    const baseline_containers = clone_containers(env.containers);
     return {
         env,
         containers: env.containers,
-        baseline_containers: clone_containers(env.containers),
+        baseline_containers,
         loose_items,
         config,
         waypoint_mode,
-        waypoint_zones: build_waypoint_zones(env.containers, waypoint_mode)
+        waypoint_zones: build_waypoint_zones(baseline_containers, waypoint_mode),
+        milkrun_reserved_z_bands: build_milkrun_bands_from_config(baseline_containers, waypoint_mode, config)
     };
 }

package/build/core/orchestration/read_primary_env.d.ts

@@ -0,0 +1,9 @@
+import type { StabilizerInput } from '../validation/contract/stabilizer_input_schema.js';
+import type { StabilizerEnv } from '../validation/contract/stabilizer_domain_schema.js';
+/**
+ * Reads the primary env from stabilizer input.
+ * @param input - Validated stabilizer input.
+ * @returns First cargo env.
+ */
+export declare function read_primary_env(input: StabilizerInput): StabilizerEnv;
+//# sourceMappingURL=read_primary_env.d.ts.map

package/build/core/orchestration/read_primary_env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_primary_env.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/read_primary_env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAA;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oDAAoD,CAAA;AAGvF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CAQtE"}

package/build/core/orchestration/read_primary_env.js

@@ -0,0 +1,13 @@
+import { InvalidStabilizerInputError } from '../exceptions/InvalidStabilizerInputError.js';
+/**
+ * Reads the primary env from stabilizer input.
+ * @param input - Validated stabilizer input.
+ * @returns First cargo env.
+ */
+export function read_primary_env(input) {
+    const env = input.cargo_state.envs[0];
+    if (!env) {
+        throw new InvalidStabilizerInputError('cargo_state.envs must contain at least one env');
+    }
+    return env;
+}

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

@@ -1,5 +1,5 @@
 import type { ReorderContext, ReorderStrategy } from './ReorderStrategy.js';
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 /**
  * Beam search reorder with configurable width and top-K expansion.
  */

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,qDAAqD,CAAA;AAY9F;;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;AAYhG;;GAEG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IAErD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAkBtD"}

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

@@ -54,14 +54,14 @@ function sort_loose_by_stability(context, eval_context) {
     const evaluation = evaluate_trial_layout(context.containers, eval_context);
     return [...context.loose_items].sort((left, right) => {
         const left_index = context.containers[left.container_index].items
-            .findIndex(item => item._id === left.item_id);
+            .findIndex(item => item.item_id === left.item_id);
         const right_index = context.containers[right.container_index].items
-            .findIndex(item => item._id === right.item_id);
+            .findIndex(item => item.item_id === right.item_id);
         const left_score = read_item_score(evaluation.stability, left.container_index, left_index);
         const right_score = read_item_score(evaluation.stability, right.container_index, right_index);
         return left_score - right_score;
     });
 }
 function find_container_index(containers, item_id) {
-    return containers.findIndex(container => container.items.some(item => item._id === item_id));
+    return containers.findIndex(container => container.items.some(item => item.item_id === item_id));
 }

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

@@ -1,5 +1,5 @@
 import type { ReorderContext, ReorderStrategy } from './ReorderStrategy.js';
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 /**
  * Genetic algorithm reorder optimizing loose-item stability sum.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"GeneticReorder.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/GeneticReorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAA;AAa9F;;GAEG;AACH,qBAAa,cAAe,YAAW,eAAe;IAElD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAgBtD"}
+{"version":3,"file":"GeneticReorder.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/GeneticReorder.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,cAAe,YAAW,eAAe;IAElD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAgBtD"}

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

@@ -1,5 +1,5 @@
 import type { ReorderContext, ReorderStrategy } from './ReorderStrategy.js';
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 /**
  * Single-pass gravity compaction: unstable loose items to lowest feasible floor slot.
  */

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

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

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

@@ -37,12 +37,12 @@ function sort_loose_by_stability(context, containers) {
     return context.loose_items
         .map(loose => {
         const item_index = containers[loose.container_index].items
-            .findIndex(item => item._id === loose.item_id);
+            .findIndex(item => item.item_id === loose.item_id);
         const score = read_item_score(evaluation.stability, loose.container_index, item_index);
         return { item_id: loose.item_id, container_index: loose.container_index, score };
     })
         .sort((left, right) => left.score - right.score);
 }
 function find_container_index(containers, item_id) {
-    return containers.findIndex(container => container.items.some(item => item._id === item_id));
+    return containers.findIndex(container => container.items.some(item => item.item_id === item_id));
 }

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

@@ -1,5 +1,5 @@
 import type { ReorderContext, ReorderStrategy } from './ReorderStrategy.js';
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 /**
  * Greedy iterative reorder: fix worst loose item until plateau or max iterations.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"GreedyReorder.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/GreedyReorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAA;AAK9F;;GAEG;AACH,qBAAa,aAAc,YAAW,eAAe;IAEjD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAiBtD"}
+{"version":3,"file":"GreedyReorder.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/GreedyReorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAA;AAKhG;;GAEG;AACH,qBAAa,aAAc,YAAW,eAAe;IAEjD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAiBtD"}

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

@@ -1,7 +1,8 @@
 import type { StabilizerConfig } from '../../validation/schemas/stabilizer_config_schema.js';
-import type { StabilizerContainer, StabilizerEnv } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer, StabilizerEnv } from '../../validation/contract/stabilizer_domain_schema.js';
 import type { LooseItemRef } from '../../filters/loose_item_filter.js';
 import type { WaypointMode, WaypointZone } from '../../waypoint/WaypointMode.js';
+import type { MilkrunReservedBand } from '../../waypoint/milkrun_wall_reservation.js';
 export interface ReorderContext {
     env: StabilizerEnv;
     containers: StabilizerContainer[];
@@ -10,6 +11,7 @@ export interface ReorderContext {
     config: StabilizerConfig;
     waypoint_mode: WaypointMode;
     waypoint_zones: WaypointZone[];
+    milkrun_reserved_z_bands: MilkrunReservedBand[];
 }
 export interface ReorderStrategy {
     run(context: ReorderContext): StabilizerContainer[];

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

@@ -1 +1 @@
-{"version":3,"file":"ReorderStrategy.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/ReorderStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAA;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAEhF,MAAM,WAAW,cAAc;IAE3B,GAAG,EAAE,aAAa,CAAA;IAClB,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,mBAAmB,EAAE,mBAAmB,EAAE,CAAA;IAC1C,WAAW,EAAE,YAAY,EAAE,CAAA;IAC3B,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,YAAY,CAAA;IAC3B,cAAc,EAAE,YAAY,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,eAAe;IAE5B,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE,CAAA;CACtD"}
+{"version":3,"file":"ReorderStrategy.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/ReorderStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uDAAuD,CAAA;AAC/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAA;AAErF,MAAM,WAAW,cAAc;IAE3B,GAAG,EAAE,aAAa,CAAA;IAClB,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,mBAAmB,EAAE,mBAAmB,EAAE,CAAA;IAC1C,WAAW,EAAE,YAAY,EAAE,CAAA;IAC3B,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,YAAY,CAAA;IAC3B,cAAc,EAAE,YAAY,EAAE,CAAA;IAC9B,wBAAwB,EAAE,mBAAmB,EAAE,CAAA;CAClD;AAED,MAAM,WAAW,eAAe;IAE5B,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE,CAAA;CACtD"}

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

@@ -1,5 +1,5 @@
 import type { ReorderContext, ReorderStrategy } from './ReorderStrategy.js';
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 /**
  * Simulated annealing reorder with hard gate rejection on invalid neighbors.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"SimulatedAnnealingReorder.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/SimulatedAnnealingReorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAA;AAyB9F;;GAEG;AACH,qBAAa,yBAA0B,YAAW,eAAe;IAE7D,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAqBtD"}
+{"version":3,"file":"SimulatedAnnealingReorder.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/SimulatedAnnealingReorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAA;AAyBhG;;GAEG;AACH,qBAAa,yBAA0B,YAAW,eAAe;IAE7D,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAqBtD"}

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

@@ -1,5 +1,5 @@
 import type { ReorderContext } from './ReorderStrategy.js';
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 import type { MoveCandidate } from '../../move/apply_move.js';
 /**
  * Proposes a random valid neighbor move for simulated annealing.

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

@@ -1 +1 @@
-{"version":3,"file":"anneal_helpers.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/anneal_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAA;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAI7D;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,EAAE,GAC/B,aAAa,GAAG,SAAS,CAgB3B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAWvE"}
+{"version":3,"file":"anneal_helpers.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/anneal_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAA;AAChG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAI7D;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,EAAE,GAC/B,aAAa,GAAG,SAAS,CAgB3B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAWvE"}

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

@@ -35,5 +35,5 @@ export function accept_move(delta, temperature) {
     return Math.random() < Math.exp(-delta / temperature);
 }
 function find_container_index(containers, item_id) {
-    return containers.findIndex(container => container.items.some(item => item._id === item_id));
+    return containers.findIndex(container => container.items.some(item => item.item_id === item_id));
 }

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

@@ -1,4 +1,4 @@
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 import type { ReorderContext } from './ReorderStrategy.js';
 import type { MoveCandidate } from '../../move/apply_move.js';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"apply_if_gates_pass.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/apply_if_gates_pass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAA;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAO7D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,EAAE,EAC9B,SAAS,EAAE,aAAa,GACzB,OAAO,CAWT"}
+{"version":3,"file":"apply_if_gates_pass.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/apply_if_gates_pass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAA;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAO7D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,EAAE,EAC9B,SAAS,EAAE,aAAa,GACzB,OAAO,CAWT"}

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

@@ -1,5 +1,5 @@
 import type { ReorderContext } from './ReorderStrategy.js';
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 import type { LooseItemRef } from '../../filters/loose_item_filter.js';
 import type { StateEvaluationContext } from '../../evaluation/evaluation_context.js';
 export interface BeamExpansionContext {

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

@@ -1 +1 @@
-{"version":3,"file":"beam_context.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/beam_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAA;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AAEpF,MAAM,WAAW,oBAAoB;IAEjC,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,sBAAsB,CAAA;IAClC,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,YAAY,CAAA;CACtB;AAED,MAAM,WAAW,SAAS;IAEtB,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;CACpB"}
+{"version":3,"file":"beam_context.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/beam_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAA;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AAEpF,MAAM,WAAW,oBAAoB;IAEjC,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,sBAAsB,CAAA;IAClC,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,YAAY,CAAA;CACtB;AAED,MAAM,WAAW,SAAS;IAEtB,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;CACpB"}

package/build/core/strategies/reorder/genetic/Chromosome.d.ts

@@ -1,6 +1,6 @@
 import type { MoveCandidate } from '../../../move/apply_move.js';
 import type { ReorderContext } from '../ReorderStrategy.js';
-import type { StabilizerContainer } from '../../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../../validation/contract/stabilizer_domain_schema.js';
 export interface ChromosomeGene {
     item_id: string;
     candidate: MoveCandidate;

package/build/core/strategies/reorder/genetic/Chromosome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chromosome.d.ts","sourceRoot":"","sources":["../../../../../src/core/strategies/reorder/genetic/Chromosome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAA;AAEjG,MAAM,WAAW,cAAc;IAE3B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,aAAa,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAE5B,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,cAAc,EACvB,eAAe,EAAE,MAAM,GACxB,eAAe,EAAE,CAQnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CAMlG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,GACtB,IAAI,CAeN;AAsBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,QAAQ,EAAE,eAAe,GAC1B,mBAAmB,EAAE,CAgBvB"}
+{"version":3,"file":"Chromosome.d.ts","sourceRoot":"","sources":["../../../../../src/core/strategies/reorder/genetic/Chromosome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0DAA0D,CAAA;AAEnG,MAAM,WAAW,cAAc;IAE3B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,aAAa,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAE5B,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,cAAc,EACvB,eAAe,EAAE,MAAM,GACxB,eAAe,EAAE,CAQnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CAMlG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,GACtB,IAAI,CAeN;AAsBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,QAAQ,EAAE,eAAe,GAC1B,mBAAmB,EAAE,CAgBvB"}

package/build/core/strategies/reorder/genetic/Chromosome.js

@@ -61,7 +61,7 @@ function build_identity_candidate(loose) {
 export function materialize_organism(baseline, organism) {
     const working = structuredClone(baseline);
     for (const gene of organism.genes) {
-        const source_index = working.findIndex(container => container.items.some(item => item._id === gene.item_id));
+        const source_index = working.findIndex(container => container.items.some(item => item.item_id === gene.item_id));
         if (source_index < 0) {
             continue;
         }
@@ -72,7 +72,7 @@ export function materialize_organism(baseline, organism) {
 }
 function apply_gene(containers, candidate) {
     const source = containers[candidate.source_container_index];
-    const item_index = source.items.findIndex(item => item._id === candidate.item_id);
+    const item_index = source.items.findIndex(item => item.item_id === candidate.item_id);
     if (item_index < 0) {
         return;
     }

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

@@ -1,5 +1,5 @@
 import type { ReorderContext } from './ReorderStrategy.js';
-import type { StabilizerContainer } from '../../validation/schemas/stabilizer_input_schema.js';
+import type { StabilizerContainer } from '../../validation/contract/stabilizer_domain_schema.js';
 import type { StateEvaluationContext } from '../../evaluation/evaluation_context.js';
 /**
  * Attempts one greedy improvement on the worst loose item.

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

@@ -1 +1 @@
-{"version":3,"file":"greedy_improvement.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/greedy_improvement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAA;AAE9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AAepF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,EAAE,EAC9B,YAAY,EAAE,sBAAsB,GACrC,OAAO,CAiBT"}
+{"version":3,"file":"greedy_improvement.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/greedy_improvement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAA;AAEhG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AAepF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,EAAE,EAC9B,YAAY,EAAE,sBAAsB,GACrC,OAAO,CAiBT"}

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

@@ -49,7 +49,7 @@ function find_worst_loose(context, containers, item_scores) {
     let worst_score = Number.POSITIVE_INFINITY;
     for (const loose of context.loose_items) {
         const item_index = containers[loose.container_index].items
-            .findIndex(item => item._id === loose.item_id);
+            .findIndex(item => item.item_id === loose.item_id);
         const score = item_scores[loose.container_index]?.[item_index] ?? 0;
         if (score < worst_score) {
             worst_score = score;
@@ -59,5 +59,5 @@ function find_worst_loose(context, containers, item_scores) {
     return worst;
 }
 function find_container_index(containers, item_id) {
-    return containers.findIndex(container => container.items.some(item => item._id === item_id));
+    return containers.findIndex(container => container.items.some(item => item.item_id === item_id));
 }

package/build/core/validation/contract/cargo_movement_wire_field_map.d.ts

@@ -0,0 +1,37 @@
+export declare const ITEM_WIRE_TO_CONTRACT: {
+    readonly _id: "item_id";
+    readonly groupId: "group_id";
+    readonly w: "width";
+    readonly h: "height";
+    readonly d: "depth";
+};
+/**
+ * Cargo-movement wire keys feeding each contract item field, in precedence
+ * order. Items are read-only for the stabilizer apart from their position, so
+ * these keys are read rather than renamed: the original wire record is
+ * retained in `attributes` and is what gets emitted back.
+ */
+export declare const ITEM_CONTRACT_WIRE_KEYS: Readonly<{
+    item_id: string[];
+    group_id: string[];
+    waypoint_id: string[];
+    width: string[];
+    height: string[];
+    depth: string[];
+    weight: string[];
+}>;
+/** Item fields the stabilizer mutates, and therefore must emit itself. */
+export declare const ITEM_POSITION_KEYS: string[];
+export declare const CONTAINER_WIRE_TO_CONTRACT: {
+    readonly sequencia: "sequence";
+    readonly largura: "width";
+    readonly altura: "height";
+    readonly comprimento: "length";
+};
+export declare const ENV_WIRE_TO_CONTRACT: {
+    readonly eixos: "axles";
+};
+export declare const CONTRACT_TO_ITEM_WIRE: Record<string, string>;
+export declare const CONTRACT_TO_CONTAINER_WIRE: Record<string, string>;
+export declare const CONTRACT_TO_ENV_WIRE: Record<string, string>;
+//# sourceMappingURL=cargo_movement_wire_field_map.d.ts.map

package/build/core/validation/contract/cargo_movement_wire_field_map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cargo_movement_wire_field_map.d.ts","sourceRoot":"","sources":["../../../../src/core/validation/contract/cargo_movement_wire_field_map.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;EAQlC,CAAA;AAEF,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,UAAkB,CAAA;AAEjD,eAAO,MAAM,0BAA0B;;;;;CAK7B,CAAA;AAEV,eAAO,MAAM,oBAAoB;;CAEvB,CAAA;AAEV,eAAO,MAAM,qBAAqB,wBAAoC,CAAA;AACtE,eAAO,MAAM,0BAA0B,wBAAyC,CAAA;AAChF,eAAO,MAAM,oBAAoB,wBAAmC,CAAA"}

package/build/core/validation/contract/cargo_movement_wire_field_map.js

@@ -0,0 +1,43 @@
+export const ITEM_WIRE_TO_CONTRACT = {
+    _id: 'item_id',
+    groupId: 'group_id',
+    w: 'width',
+    h: 'height',
+    d: 'depth'
+};
+/**
+ * Cargo-movement wire keys feeding each contract item field, in precedence
+ * order. Items are read-only for the stabilizer apart from their position, so
+ * these keys are read rather than renamed: the original wire record is
+ * retained in `attributes` and is what gets emitted back.
+ */
+export const ITEM_CONTRACT_WIRE_KEYS = Object.freeze({
+    item_id: ['item_id', '_id'],
+    group_id: ['groupId', 'group_id'],
+    waypoint_id: ['waypoint_id'],
+    width: ['w', 'width'],
+    height: ['h', 'height'],
+    depth: ['d', 'depth'],
+    weight: ['wg', 'peso', 'weight']
+});
+/** Item fields the stabilizer mutates, and therefore must emit itself. */
+export const ITEM_POSITION_KEYS = ['x', 'y', 'z'];
+export const CONTAINER_WIRE_TO_CONTRACT = {
+    sequencia: 'sequence',
+    largura: 'width',
+    altura: 'height',
+    comprimento: 'length'
+};
+export const ENV_WIRE_TO_CONTRACT = {
+    eixos: 'axles'
+};
+export const CONTRACT_TO_ITEM_WIRE = invert_map(ITEM_WIRE_TO_CONTRACT);
+export const CONTRACT_TO_CONTAINER_WIRE = invert_map(CONTAINER_WIRE_TO_CONTRACT);
+export const CONTRACT_TO_ENV_WIRE = invert_map(ENV_WIRE_TO_CONTRACT);
+function invert_map(source) {
+    const inverted = {};
+    for (const [wire_key, contract_key] of Object.entries(source)) {
+        inverted[contract_key] = wire_key;
+    }
+    return inverted;
+}

package/build/core/validation/contract/cargo_movement_wire_mapper.d.ts

@@ -0,0 +1,14 @@
+import type { StabilizerCargoState } from './stabilizer_domain_schema.js';
+/**
+ * Maps a cargo-movement wire payload to the English contract shape.
+ * @param input_data - Unknown CM wire payload.
+ * @returns Object ready for strict contract parsing.
+ */
+export declare function map_wire_input_to_contract(input_data: unknown): unknown;
+/**
+ * Maps an English contract cargo state back to cargo-movement wire shape.
+ * @param cargo_state - English contract cargo state.
+ * @returns CM wire cargo state.
+ */
+export declare function map_contract_to_wire_output(cargo_state: StabilizerCargoState): unknown;
+//# sourceMappingURL=cargo_movement_wire_mapper.d.ts.map

package/build/core/validation/contract/cargo_movement_wire_mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cargo_movement_wire_mapper.d.ts","sourceRoot":"","sources":["../../../../src/core/validation/contract/cargo_movement_wire_mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAOzE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAsBvE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,oBAAoB,GAAG,OAAO,CAGtF"}