@jetta/cargo-stabilizer 0.1.0-9 → 0.1.0

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,17 +1,23 @@
-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.
  * @returns Raw config object for schema parsing.
  */
 export declare function read_raw_stabilizer_config(algoritmo: Record<string, unknown>): {
+    preserve_tie_block_organization: boolean;
+    pin_tie_ratio_blocks: boolean;
+    enforce_milkrun_wall_reservation: boolean;
+    number_of_wall_to_allocate_from_last_waypoints: number;
     reorder_strategy: string;
     transport_stability_floor: number;
     max_iteration: number;
@@ -21,8 +27,6 @@ export declare function read_raw_stabilizer_config(algoritmo: Record<string, unk
     beam_width: number;
     beam_top_k: number;
     axle_load_margin_percent: number;
-    preserve_tie_block_organization: boolean;
-    enforce_milkrun_wall_reservation: boolean;
-    number_of_wall_to_allocate_from_last_waypoints: 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;;;;;;;;;;;;;EAwB5E"}
+{"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/factory/read_stabilizer_config_helpers.js

@@ -19,6 +19,12 @@ export function merge_algoritmo_maps(config, cargo_state) {
  * @returns Raw config object for schema parsing.
  */
 export function read_raw_stabilizer_config(algoritmo) {
+    return {
+        ...read_search_raw(algoritmo),
+        ...read_organization_raw(algoritmo)
+    };
+}
+function read_search_raw(algoritmo) {
     return {
         reorder_strategy: read_config_string(algoritmo, 'reorder_strategy', REORDER_STRATEGY.GRAVITY),
         transport_stability_floor: read_config_number(algoritmo, 'transport_stability_floor', 0),
@@ -28,8 +34,13 @@ export function read_raw_stabilizer_config(algoritmo) {
         genetic_mutation_rate: read_config_number(algoritmo, 'genetic_mutation_rate', 0.15),
         beam_width: read_config_number(algoritmo, 'beam_width', 5),
         beam_top_k: read_config_number(algoritmo, 'beam_top_k', 3),
-        axle_load_margin_percent: read_config_number(algoritmo, 'folga_de_peso_nos_eixos', 0),
+        axle_load_margin_percent: read_config_number(algoritmo, 'folga_de_peso_nos_eixos', 0)
+    };
+}
+function read_organization_raw(algoritmo) {
+    return {
         preserve_tie_block_organization: read_config_boolean(algoritmo, 'preserve_tie_block_organization', true),
+        pin_tie_ratio_blocks: read_config_boolean(algoritmo, 'pin_tie_ratio_blocks', false),
         enforce_milkrun_wall_reservation: read_config_boolean(algoritmo, 'enforce_milkrun_wall_reservation', false),
         number_of_wall_to_allocate_from_last_waypoints: read_milkrun_wall_count(algoritmo)
     };

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

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

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

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

package/build/core/filters/collect_movable_items.js

@@ -0,0 +1,53 @@
+import { collect_pinned_floor_tie_ratio_group_ids } from './collect_pinned_floor_tie_ratio_group_ids.js';
+import { is_item_on_cm_floor } from './is_item_on_cm_floor.js';
+/**
+ * Collects items the stabilizer may move.
+ * @param containers - Container list from env.
+ * @param pin_tie_ratio_blocks - When true, skip floor five-slot 3_2/2_3 walls.
+ * @returns Movable item references with container index.
+ */
+export function collect_movable_items(containers, pin_tie_ratio_blocks) {
+    const pinned_groups = pin_tie_ratio_blocks
+        ? collect_pinned_floor_tie_ratio_group_ids(flatten_container_items(containers))
+        : new Set();
+    return collect_items_except_pinned(containers, pinned_groups);
+}
+/**
+ * @param item - Item record.
+ * @param pinned_group_ids - Floor five-slot 3_2/2_3 group ids.
+ * @returns True when the item is a floor member of a pinned wall.
+ */
+export function is_tie_ratio_block_item(item, pinned_group_ids) {
+    if (item.group_id == null || !is_item_on_cm_floor(item)) {
+        return false;
+    }
+    return pinned_group_ids.has(item.group_id);
+}
+function collect_items_except_pinned(containers, pinned_groups) {
+    const movable = [];
+    for (let container_index = 0; container_index < containers.length; container_index++) {
+        movable.push(...collect_container_movable_items(containers[container_index].items, container_index, pinned_groups));
+    }
+    return movable;
+}
+function collect_container_movable_items(items, container_index, pinned_groups) {
+    const movable = [];
+    for (const item of items) {
+        if (is_tie_ratio_block_item(item, pinned_groups)) {
+            continue;
+        }
+        movable.push({
+            item_id: item.item_id,
+            container_index,
+            item
+        });
+    }
+    return movable;
+}
+function flatten_container_items(containers) {
+    const items = [];
+    for (const container of containers) {
+        items.push(...container.items);
+    }
+    return items;
+}

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

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

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

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

package/build/core/filters/collect_pinned_floor_tie_ratio_group_ids.js

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

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

@@ -0,0 +1,8 @@
+import type { StabilizerItem } from '../validation/contract/stabilizer_domain_schema.js';
+/**
+ * True when the item rests on the 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;
+//# sourceMappingURL=is_item_on_cm_floor.d.ts.map

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

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

package/build/core/filters/is_item_on_cm_floor.js

@@ -0,0 +1,9 @@
+const CM_FLOOR_HEIGHT_EPSILON = 1e-6;
+/**
+ * True when the item rests on the 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.y <= CM_FLOOR_HEIGHT_EPSILON;
+}

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

@@ -0,0 +1,9 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+/**
+ * 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.
+ */
+export declare function has_penetrating_overlap(containers: StabilizerContainer[]): boolean;
+//# sourceMappingURL=has_penetrating_overlap.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,27 @@
+import { lt } from '@jetta/number-compare';
+/**
+ * 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.
+ */
+export function has_penetrating_overlap(containers) {
+    return containers.some(container => container_has_penetrating_overlap(container));
+}
+function container_has_penetrating_overlap(container) {
+    const items = container.items;
+    for (let i = 0; i < items.length; i++) {
+        for (let j = i + 1; j < items.length; j++) {
+            if (items_penetrate(items[i], items[j])) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function items_penetrate(left, right) {
+    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 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/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,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"}
+{"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,CAqBhB"}