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

package/build/core/evaluation/compare_search_states.js

@@ -0,0 +1,12 @@
+/**
+ * Ranks search states: lower axle excess first, then higher stability objective.
+ * @param left - Left state.
+ * @param right - Right state.
+ * @returns Negative when left ranks ahead of right.
+ */
+export function compare_search_states(left, right) {
+    if (left.axle_excess_kg !== right.axle_excess_kg) {
+        return left.axle_excess_kg - right.axle_excess_kg;
+    }
+    return right.objective - left.objective;
+}

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

@@ -0,0 +1,18 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { StabilityEvaluation } from '../adapters/stability_adapter.js';
+import type { StateEvaluationContext } from './evaluation_context.js';
+import type { EvaluationResult } from './evaluation_result.js';
+export interface SearchGateOutcome {
+    objective: number;
+    pass: boolean;
+    flags: Omit<EvaluationResult, 'stability' | 'objective' | 'all_gates_pass'>;
+}
+/**
+ * Computes reorder objective and legality flags for a layout.
+ * @param containers - Container layout.
+ * @param context - Evaluation context.
+ * @param stability - Transport stability evaluation.
+ * @returns Objective, pass flag, and gate fields.
+ */
+export declare function evaluate_search_gates(containers: StabilizerContainer[], context: StateEvaluationContext, stability: StabilityEvaluation): SearchGateOutcome;
+//# sourceMappingURL=evaluate_search_gates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate_search_gates.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/evaluate_search_gates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAM9D,MAAM,WAAW,iBAAiB;IAE9B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,WAAW,GAAG,gBAAgB,CAAC,CAAA;CAC9E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,sBAAsB,EAC/B,SAAS,EAAE,mBAAmB,GAC/B,iBAAiB,CAanB"}

package/build/core/evaluation/evaluate_search_gates.js

@@ -0,0 +1,30 @@
+import { compute_reorder_objective } from './compute_reorder_objective.js';
+import { evaluate_axle_load } from '../adapters/evaluate_axle_load.js';
+import { is_layout_milkrun_valid } from '../waypoint/milkrun_wall_reservation.js';
+import { is_waypoint_order_valid } from './is_waypoint_order_valid.js';
+/**
+ * Computes reorder objective and legality flags for a layout.
+ * @param containers - Container layout.
+ * @param context - Evaluation context.
+ * @param stability - Transport stability evaluation.
+ * @returns Objective, pass flag, and gate fields.
+ */
+export function evaluate_search_gates(containers, context, stability) {
+    const objective = compute_reorder_objective(stability, containers, context.loose_items);
+    const axle_load = evaluate_axle_load({ ...context.env, containers }, context.config.axle_load_margin_percent);
+    const flags = build_gate_flags({ containers, context, stability, axle_load });
+    return {
+        objective,
+        pass: flags.transport_floor_valid && flags.axle_valid && flags.waypoint_valid && flags.milkrun_valid,
+        flags
+    };
+}
+function build_gate_flags(input) {
+    return {
+        transport_floor_valid: input.stability.transport_score >= input.context.config.transport_stability_floor,
+        axle_valid: input.axle_load.valid,
+        waypoint_valid: is_waypoint_order_valid(input.containers, input.context),
+        milkrun_valid: is_layout_milkrun_valid(input.containers, input.context.milkrun_reserved_z_bands),
+        axle_excess_kg: input.axle_load.excess_kg
+    };
+}

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

@@ -0,0 +1,15 @@
+import type { StabilityEvaluation } from '../adapters/stability_adapter.js';
+/**
+ * Outcome of evaluating a layout against stabilizer gates.
+ */
+export interface EvaluationResult {
+    stability: StabilityEvaluation;
+    objective: number;
+    transport_floor_valid: boolean;
+    axle_valid: boolean;
+    waypoint_valid: boolean;
+    milkrun_valid: boolean;
+    all_gates_pass: boolean;
+    axle_excess_kg: number;
+}
+//# sourceMappingURL=evaluation_result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation_result.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/evaluation_result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAE3E;;GAEG;AACH,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;IACvB,cAAc,EAAE,MAAM,CAAA;CACzB"}

package/build/core/evaluation/evaluation_result.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,9 @@
+import type { EvaluationResult } from './evaluation_result.js';
+export declare const LEGAL_FITNESS_OFFSET = 1000000;
+/**
+ * Scores a genetic organism: legal layouts outrank every illegal one.
+ * @param evaluation - Layout evaluation.
+ * @returns Fitness; higher is better.
+ */
+export declare function genetic_fitness(evaluation: EvaluationResult): number;
+//# sourceMappingURL=genetic_fitness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"genetic_fitness.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/genetic_fitness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,eAAO,MAAM,oBAAoB,UAAY,CAAA;AAE7C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAWpE"}

package/build/core/evaluation/genetic_fitness.js

@@ -0,0 +1,16 @@
+import { is_non_axle_gates_pass } from './is_non_axle_gates_pass.js';
+export const LEGAL_FITNESS_OFFSET = 1_000_000;
+/**
+ * Scores a genetic organism: legal layouts outrank every illegal one.
+ * @param evaluation - Layout evaluation.
+ * @returns Fitness; higher is better.
+ */
+export function genetic_fitness(evaluation) {
+    if (!is_non_axle_gates_pass(evaluation)) {
+        return Number.NEGATIVE_INFINITY;
+    }
+    if (evaluation.axle_valid) {
+        return LEGAL_FITNESS_OFFSET + evaluation.objective;
+    }
+    return -evaluation.axle_excess_kg;
+}

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

@@ -0,0 +1,8 @@
+import type { EvaluationResult } from './evaluation_result.js';
+/**
+ * Returns true when waypoint, milkrun, and transport-floor gates pass.
+ * @param result - Evaluation result.
+ * @returns True when non-axle gates all pass.
+ */
+export declare function is_non_axle_gates_pass(result: EvaluationResult): boolean;
+//# sourceMappingURL=is_non_axle_gates_pass.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is_non_axle_gates_pass.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/is_non_axle_gates_pass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAGxE"}

package/build/core/evaluation/is_non_axle_gates_pass.js

@@ -0,0 +1,8 @@
+/**
+ * Returns true when waypoint, milkrun, and transport-floor gates pass.
+ * @param result - Evaluation result.
+ * @returns True when non-axle gates all pass.
+ */
+export function is_non_axle_gates_pass(result) {
+    return result.transport_floor_valid && result.waypoint_valid && result.milkrun_valid;
+}

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

@@ -0,0 +1,10 @@
+import type { EvaluationResult } from './evaluation_result.js';
+/**
+ * Decides whether a one-item trial may enter the search.
+ * Over parents may climb with strictly less axle excess; legal parents keep a hard axle gate.
+ * @param parent - Parent layout evaluation.
+ * @param child - Trial layout evaluation.
+ * @returns True when the trial is admissible.
+ */
+export declare function is_search_trial_admissible(parent: EvaluationResult, child: EvaluationResult): boolean;
+//# sourceMappingURL=is_search_trial_admissible.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is_search_trial_admissible.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/is_search_trial_admissible.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG9D;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,gBAAgB,GACxB,OAAO,CAWT"}

package/build/core/evaluation/is_search_trial_admissible.js

@@ -0,0 +1,17 @@
+import { is_non_axle_gates_pass } from './is_non_axle_gates_pass.js';
+/**
+ * Decides whether a one-item trial may enter the search.
+ * Over parents may climb with strictly less axle excess; legal parents keep a hard axle gate.
+ * @param parent - Parent layout evaluation.
+ * @param child - Trial layout evaluation.
+ * @returns True when the trial is admissible.
+ */
+export function is_search_trial_admissible(parent, child) {
+    if (!is_non_axle_gates_pass(child)) {
+        return false;
+    }
+    if (parent.axle_valid) {
+        return child.axle_valid;
+    }
+    return child.axle_excess_kg < parent.axle_excess_kg;
+}

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

@@ -0,0 +1,10 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { StateEvaluationContext } from './evaluation_context.js';
+/**
+ * Returns true when waypoint order is satisfied for the layout.
+ * @param containers - Container layout.
+ * @param context - Evaluation context.
+ * @returns True when waypoint mode is single or order is preserved.
+ */
+export declare function is_waypoint_order_valid(containers: StabilizerContainer[], context: StateEvaluationContext): boolean;
+//# sourceMappingURL=is_waypoint_order_valid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is_waypoint_order_valid.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/is_waypoint_order_valid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAGrE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,sBAAsB,GAChC,OAAO,CAeT"}

package/build/core/evaluation/is_waypoint_order_valid.js

@@ -0,0 +1,14 @@
+import { preserves_waypoint_order } from '../waypoint/preserves_waypoint_order.js';
+/**
+ * Returns true when waypoint order is satisfied for the layout.
+ * @param containers - Container layout.
+ * @param context - Evaluation context.
+ * @returns True when waypoint mode is single or order is preserved.
+ */
+export function is_waypoint_order_valid(containers, context) {
+    if (context.waypoint_mode.kind === 'SINGLE_WAYPOINT' ||
+        !context.config.preserve_tie_block_organization) {
+        return true;
+    }
+    return preserves_waypoint_order(context.baseline_containers, containers, context.waypoint_mode);
+}

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

@@ -1,16 +1,8 @@
 import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
-import { type StabilityEvaluation } from '../adapters/stability_adapter.js';
 import type { StateEvaluationContext } from './evaluation_context.js';
 import type { ReorderContext } from '../strategies/reorder/ReorderStrategy.js';
-export interface EvaluationResult {
-    stability: StabilityEvaluation;
-    objective: number;
-    transport_floor_valid: boolean;
-    axle_valid: boolean;
-    waypoint_valid: boolean;
-    milkrun_valid: boolean;
-    all_gates_pass: boolean;
-}
+import type { EvaluationResult } from './evaluation_result.js';
+export type { EvaluationResult };
 /**
  * Evaluates a container layout against all stabilizer gates.
  * @param containers - Container layout to evaluate.

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,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"}
+{"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;AAG7F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAA;AAI9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,YAAY,EAAE,gBAAgB,EAAE,CAAA;AAEhC;;;;;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;AAED;;;;;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,9 +1,8 @@
 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';
 import { clone_containers } from '../move/apply_move.js';
+import { evaluate_search_gates } from './evaluate_search_gates.js';
+import { is_waypoint_order_valid } from './is_waypoint_order_valid.js';
+import { is_layout_milkrun_valid } from '../waypoint/milkrun_wall_reservation.js';
 /**
  * Evaluates a container layout against all stabilizer gates.
  * @param containers - Container layout to evaluate.
@@ -15,7 +14,7 @@ export function evaluate_state(containers, context) {
     if (!stability) {
         return invalid_evaluation_result();
     }
-    const gates = evaluate_gates(containers, context, stability);
+    const gates = evaluate_search_gates(containers, context, stability);
     return { stability, objective: gates.objective, ...gates.flags, all_gates_pass: gates.pass };
 }
 /**
@@ -50,19 +49,6 @@ export function evaluation_context_from_reorder(context) {
 export function clone_baseline(containers) {
     return clone_containers(containers);
 }
-function evaluate_gates(containers, context, stability) {
-    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);
-    const milkrun_valid = is_layout_milkrun_valid(containers, context.milkrun_reserved_z_bands);
-    const flags = { transport_floor_valid, axle_valid, waypoint_valid, milkrun_valid };
-    return {
-        objective,
-        pass: transport_floor_valid && axle_valid && waypoint_valid && milkrun_valid,
-        flags
-    };
-}
 /**
  * Evaluates organization constraint gates without stability or axle checks.
  * @param containers - Container layout to evaluate.
@@ -75,13 +61,6 @@ export function evaluate_organization_gates(containers, context) {
         milkrun_valid: is_layout_milkrun_valid(containers, context.milkrun_reserved_z_bands)
     };
 }
-function is_waypoint_order_valid(containers, context) {
-    if (context.waypoint_mode.kind === 'SINGLE_WAYPOINT' ||
-        !context.config.preserve_tie_block_organization) {
-        return true;
-    }
-    return preserves_waypoint_order(context.baseline_containers, containers, context.waypoint_mode);
-}
 function invalid_evaluation_result() {
     return {
         stability: { item_scores: [], container_scores: [], transport_score: 0 },
@@ -90,6 +69,7 @@ function invalid_evaluation_result() {
         axle_valid: false,
         waypoint_valid: false,
         milkrun_valid: false,
-        all_gates_pass: false
+        all_gates_pass: false,
+        axle_excess_kg: Number.POSITIVE_INFINITY
     };
 }

package/build/core/factory/read_stabilizer_config.d.ts

@@ -1,10 +1,11 @@
 import { type StabilizerConfig } from '../validation/schemas/stabilizer_config_schema.js';
-import type { StabilizerCargoState } from '../validation/contract/stabilizer_domain_schema.js';
 /**
  * Reads stabilizer config from cargo-movement config and cargo profile algoritmo maps.
  * @param config - Top-level stabilizer input config object.
  * @param cargo_state - Cargo profile (optional) for merged algoritmo keys.
  * @returns Parsed stabilizer configuration.
  */
-export declare function read_stabilizer_config(config: Record<string, unknown> | undefined, cargo_state?: StabilizerCargoState): StabilizerConfig;
+export declare function read_stabilizer_config(config: Record<string, unknown> | undefined, cargo_state?: {
+    config?: unknown;
+}): StabilizerConfig;
 //# sourceMappingURL=read_stabilizer_config.d.ts.map

package/build/core/factory/read_stabilizer_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read_stabilizer_config.d.ts","sourceRoot":"","sources":["../../../src/core/factory/read_stabilizer_config.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,KAAK,gBAAgB,EACxB,MAAM,mDAAmD,CAAA;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAA;AAG9F;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,WAAW,CAAC,EAAE,oBAAoB,GACnC,gBAAgB,CAYlB"}
+{"version":3,"file":"read_stabilizer_config.d.ts","sourceRoot":"","sources":["../../../src/core/factory/read_stabilizer_config.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,KAAK,gBAAgB,EACxB,MAAM,mDAAmD,CAAA;AAG1D;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,WAAW,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,gBAAgB,CAYlB"}

package/build/core/factory/read_stabilizer_config_helpers.d.ts

@@ -1,11 +1,13 @@
-import type { StabilizerCargoState } from '../validation/contract/stabilizer_domain_schema.js';
+type CargoStateConfigHolder = {
+    config?: unknown;
+};
 /**
  * Merges root and cargo profile algoritmo maps (profile overrides root).
  * @param config - Root stabilizer input config.
  * @param cargo_state - Cargo profile state.
  * @returns Merged algoritmo map.
  */
-export declare function merge_algoritmo_maps(config: Record<string, unknown> | undefined, cargo_state?: StabilizerCargoState): Record<string, unknown>;
+export declare function merge_algoritmo_maps(config: Record<string, unknown> | undefined, cargo_state?: CargoStateConfigHolder): Record<string, unknown>;
 /**
  * Reads raw stabilizer config fields from merged algoritmo map.
  * @param algoritmo - Merged algoritmo configuration map.
@@ -26,4 +28,5 @@ export declare function read_raw_stabilizer_config(algoritmo: Record<string, unk
     beam_top_k: number;
     axle_load_margin_percent: number;
 };
+export {};
 //# sourceMappingURL=read_stabilizer_config_helpers.d.ts.map

package/build/core/factory/read_stabilizer_config_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read_stabilizer_config_helpers.d.ts","sourceRoot":"","sources":["../../../src/core/factory/read_stabilizer_config_helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAA;AAK9F;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,WAAW,CAAC,EAAE,oBAAoB,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;EAM5E"}
+{"version":3,"file":"read_stabilizer_config_helpers.d.ts","sourceRoot":"","sources":["../../../src/core/factory/read_stabilizer_config_helpers.ts"],"names":[],"mappings":"AAGA,KAAK,sBAAsB,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAKlD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,WAAW,CAAC,EAAE,sBAAsB,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;EAM5E"}

package/build/core/filters/collect_pinned_floor_tie_ratio_group_ids.js

@@ -32,7 +32,7 @@ function groups_with_full_floor_wall(counts) {
     return pinned;
 }
 function read_tie_ratio_orientation(item) {
-    const orientation = item.attributes?.tie_ratio_orientation;
+    const orientation = item.tie_ratio_orientation;
     return typeof orientation === 'string' ? orientation : undefined;
 }
 function is_tie_ratio_orientation(orientation) {

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

@@ -1,7 +1,7 @@
 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.
+ * True when the item rests on the floor (contract y is height after wire map).
+ * @param item - Stabilizer item in contract coordinates.
  * @returns True when height origin is on the floor.
  */
 export declare function is_item_on_cm_floor(item: StabilizerItem): boolean;

package/build/core/filters/is_item_on_cm_floor.js

@@ -1,9 +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.
+ * True when the item rests on the floor (contract y is height after wire map).
+ * @param item - Stabilizer item in contract 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;
+    return item.y <= CM_FLOOR_HEIGHT_EPSILON;
 }

package/build/core/geometry/has_penetrating_overlap.d.ts

@@ -1,7 +1,7 @@
 import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
 /**
- * True when any two items penetrate in the axle-calculator CM frame
- * (x + width, y + depth, z + height) by more than a face-touch epsilon.
+ * True when any two items penetrate in the contract frame
+ * (x + width, y + height, z + depth). Face-touch uses `@jetta/number-compare`.
  * @param containers - Layout to inspect.
  * @returns True when a pair occupies the same volume beyond float error.
  */

package/build/core/geometry/has_penetrating_overlap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"has_penetrating_overlap.d.ts","sourceRoot":"","sources":["../../../src/core/geometry/has_penetrating_overlap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,oDAAoD,CAAA;AAI7G;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAGlF"}
+{"version":3,"file":"has_penetrating_overlap.d.ts","sourceRoot":"","sources":["../../../src/core/geometry/has_penetrating_overlap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,oDAAoD,CAAA;AAE7G;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAGlF"}

package/build/core/geometry/has_penetrating_overlap.js

@@ -1,7 +1,7 @@
-const PENETRATION_EPSILON = 1e-6;
+import { lt } from '@jetta/number-compare';
 /**
- * True when any two items penetrate in the axle-calculator CM frame
- * (x + width, y + depth, z + height) by more than a face-touch epsilon.
+ * True when any two items penetrate in the contract frame
+ * (x + width, y + height, z + depth). Face-touch uses `@jetta/number-compare`.
  * @param containers - Layout to inspect.
  * @returns True when a pair occupies the same volume beyond float error.
  */
@@ -20,8 +20,8 @@ function container_has_penetrating_overlap(container) {
     return false;
 }
 function items_penetrate(left, right) {
-    return interval_penetration({ min: left.x, max: left.x + left.width }, { min: right.x, max: right.x + right.width }) && interval_penetration({ min: left.y, max: left.y + left.depth }, { min: right.y, max: right.y + right.depth }) && interval_penetration({ min: left.z, max: left.z + left.height }, { min: right.z, max: right.z + right.height });
+    return intervals_overlap({ min: left.x, max: left.x + left.width }, { min: right.x, max: right.x + right.width }) && intervals_overlap({ min: left.y, max: left.y + left.height }, { min: right.y, max: right.y + right.height }) && intervals_overlap({ min: left.z, max: left.z + left.depth }, { min: right.z, max: right.z + right.depth });
 }
-function interval_penetration(left, right) {
-    return Math.min(left.max, right.max) - Math.max(left.min, right.min) > PENETRATION_EPSILON;
+function intervals_overlap(left, right) {
+    return lt(left.min, right.max) && lt(right.min, left.max);
 }

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,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"}
+{"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,CAgBhF;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,OAAO,GAAG,oBAAoB,CAI1F"}

package/build/core/orchestration/StabilizerFlow.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, input.cargo_state);
+    const config = read_stabilizer_config(input.config);
     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/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;AAchG;;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;AAehG;;GAEG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IAErD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAoBtD"}

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

@@ -1,10 +1,11 @@
 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 { 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';
 import { select_surviving_beam } from './select_surviving_beam.js';
+import { append_admitted_trial } from './append_admitted_trial.js';
 /**
  * Beam search reorder with configurable width and top-K expansion.
  */
@@ -12,9 +13,11 @@ export class BeamSearchReorder {
     run(context) {
         const eval_context = evaluation_context_from_reorder(context);
         const sorted = sort_loose_by_stability(context, eval_context);
+        const root_eval = evaluate_trial_layout(context.containers, eval_context);
         let beam = [{
                 containers: clone_containers(context.containers),
-                objective: evaluate_trial_layout(context.containers, eval_context).objective
+                objective: root_eval.objective,
+                axle_excess_kg: root_eval.axle_excess_kg
             }];
         for (const loose of sorted) {
             beam = expand_beam({ reorder: context, evaluation: eval_context, beam, loose });
@@ -38,17 +41,12 @@ function expand_beam(request) {
     return select_surviving_beam(expanded, request.beam, request.reorder.config.beam_width);
 }
 function append_beam_branches(beam_context) {
-    const { reorder, evaluation, expanded, state, loose } = beam_context;
+    const { reorder, evaluation, state, loose } = beam_context;
     const loose_ref = { ...loose, container_index: find_container_index(state.containers, loose.item_id) };
+    const parent_eval = evaluate_trial_layout(state.containers, evaluation);
     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);
-        const result = evaluate_trial_layout(trial, evaluation);
-        if (!result.all_gates_pass) {
-            continue;
-        }
-        expanded.push({ containers: trial, objective: result.objective });
+        append_admitted_trial(beam_context, parent_eval, candidate);
     }
 }
 function sort_loose_by_stability(context, eval_context) {

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,uDAAuD,CAAA;AAahG;;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;AAchG;;GAEG;AACH,qBAAa,cAAe,YAAW,eAAe;IAElD,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAgBtD"}

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

@@ -1,5 +1,6 @@
 import { build_initial_population, crossover_organisms, materialize_organism, mutate_organism } from './genetic/Chromosome.js';
 import { evaluate_trial_layout, evaluation_context_from_reorder } from '../../evaluation/state_evaluator.js';
+import { genetic_fitness } from '../../evaluation/genetic_fitness.js';
 /**
  * Genetic algorithm reorder optimizing loose-item stability sum.
  */
@@ -39,5 +40,5 @@ function score_population(context, eval_context, population) {
 function score_organism(context, eval_context, organism) {
     const layout = materialize_organism(context.baseline_containers, organism);
     const evaluation = evaluate_trial_layout(layout, eval_context);
-    organism.fitness = evaluation.all_gates_pass ? evaluation.objective : Number.NEGATIVE_INFINITY;
+    organism.fitness = genetic_fitness(evaluation);
 }

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,uDAAuD,CAAA;AAyBhG;;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;AA0BhG;;GAEG;AACH,qBAAa,yBAA0B,YAAW,eAAe;IAE7D,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAqBtD"}

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

@@ -1,6 +1,7 @@
 import { apply_move, clone_containers } from '../../move/apply_move.js';
 import { evaluate_trial_layout, evaluation_context_from_reorder } from '../../evaluation/state_evaluator.js';
 import { accept_move, propose_neighbor } from './anneal_helpers.js';
+import { is_search_trial_admissible } from '../../evaluation/is_search_trial_admissible.js';
 /**
  * Simulated annealing reorder with hard gate rejection on invalid neighbors.
  */
@@ -10,7 +11,7 @@ export class SimulatedAnnealingReorder {
         const state = {
             working: clone_containers(context.containers),
             best: clone_containers(context.containers),
-            best_energy: energy(context.containers, eval_context)
+            best_energy: search_energy(context.containers, eval_context)
         };
         let temperature = 1.0;
         const cooling_rate = 0.995;
@@ -37,12 +38,16 @@ function anneal_step(step_context) {
 function evaluate_neighbor(step_context, neighbor) {
     const trial = clone_containers(step_context.state.working);
     apply_move(trial, neighbor);
+    const working_eval = evaluate_trial_layout(step_context.state.working, step_context.evaluation);
     const evaluation = evaluate_trial_layout(trial, step_context.evaluation);
-    if (!evaluation.all_gates_pass) {
+    if (!is_search_trial_admissible(working_eval, evaluation)) {
         return undefined;
     }
+    if (!working_eval.axle_valid) {
+        return evaluation.axle_excess_kg;
+    }
     const trial_energy = -evaluation.objective;
-    const delta = trial_energy - energy(step_context.state.working, step_context.evaluation);
+    const delta = trial_energy - search_energy(step_context.state.working, step_context.evaluation);
     if (!accept_move(delta, step_context.temperature)) {
         return undefined;
     }
@@ -56,6 +61,10 @@ function apply_accepted_neighbor(step_context, neighbor, trial_energy) {
     step_context.state.best = clone_containers(step_context.state.working);
     step_context.state.best_energy = trial_energy;
 }
-function energy(containers, eval_context) {
-    return -evaluate_trial_layout(containers, eval_context).objective;
+function search_energy(containers, eval_context) {
+    const evaluation = evaluate_trial_layout(containers, eval_context);
+    if (!evaluation.axle_valid) {
+        return evaluation.axle_excess_kg;
+    }
+    return -evaluation.objective;
 }

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

@@ -0,0 +1,11 @@
+import type { EvaluationResult } from '../../evaluation/evaluation_result.js';
+import type { MoveCandidate } from '../../move/apply_move.js';
+import type { BeamExpansionContext } from './beam_context.js';
+/**
+ * Evaluates one candidate and keeps it when search admission allows.
+ * @param beam_context - Beam expansion context.
+ * @param parent_eval - Parent layout evaluation.
+ * @param candidate - Move candidate.
+ */
+export declare function append_admitted_trial(beam_context: BeamExpansionContext, parent_eval: EvaluationResult, candidate: MoveCandidate): void;
+//# sourceMappingURL=append_admitted_trial.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"append_admitted_trial.d.ts","sourceRoot":"","sources":["../../../../src/core/strategies/reorder/append_admitted_trial.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAA;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAE7D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,YAAY,EAAE,oBAAoB,EAClC,WAAW,EAAE,gBAAgB,EAC7B,SAAS,EAAE,aAAa,GACzB,IAAI,CAcN"}

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

@@ -0,0 +1,22 @@
+import { apply_move, clone_containers } from '../../move/apply_move.js';
+import { evaluate_trial_layout } from '../../evaluation/state_evaluator.js';
+import { is_search_trial_admissible } from '../../evaluation/is_search_trial_admissible.js';
+/**
+ * Evaluates one candidate and keeps it when search admission allows.
+ * @param beam_context - Beam expansion context.
+ * @param parent_eval - Parent layout evaluation.
+ * @param candidate - Move candidate.
+ */
+export function append_admitted_trial(beam_context, parent_eval, candidate) {
+    const trial = clone_containers(beam_context.state.containers);
+    apply_move(trial, candidate);
+    const result = evaluate_trial_layout(trial, beam_context.evaluation);
+    if (!is_search_trial_admissible(parent_eval, result)) {
+        return;
+    }
+    beam_context.expanded.push({
+        containers: trial,
+        objective: result.objective,
+        axle_excess_kg: result.axle_excess_kg
+    });
+}