@jetta/cargo-stabilizer 0.1.0-10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.md +144 -0
  3. package/build/core/adapters/axle_adapter.d.ts +16 -0
  4. package/build/core/adapters/axle_adapter.d.ts.map +1 -0
  5. package/build/core/adapters/axle_adapter.js +35 -0
  6. package/build/core/adapters/build_axle_request.d.ts +15 -0
  7. package/build/core/adapters/build_axle_request.d.ts.map +1 -0
  8. package/build/core/adapters/build_axle_request.js +39 -0
  9. package/build/core/adapters/coordinate_mapper.d.ts +36 -0
  10. package/build/core/adapters/coordinate_mapper.d.ts.map +1 -0
  11. package/build/core/adapters/coordinate_mapper.js +40 -0
  12. package/build/core/adapters/empty_space_adapter.d.ts +10 -0
  13. package/build/core/adapters/empty_space_adapter.d.ts.map +1 -0
  14. package/build/core/adapters/empty_space_adapter.js +24 -0
  15. package/build/core/adapters/map_item_to_positioned_cube.d.ts +9 -0
  16. package/build/core/adapters/map_item_to_positioned_cube.d.ts.map +1 -0
  17. package/build/core/adapters/map_item_to_positioned_cube.js +16 -0
  18. package/build/core/adapters/run_axle_calculator.d.ts +16 -0
  19. package/build/core/adapters/run_axle_calculator.d.ts.map +1 -0
  20. package/build/core/adapters/run_axle_calculator.js +32 -0
  21. package/build/core/adapters/stability_adapter.d.ts +36 -0
  22. package/build/core/adapters/stability_adapter.d.ts.map +1 -0
  23. package/build/core/adapters/stability_adapter.js +61 -0
  24. package/build/core/candidates/build_candidate_context.d.ts +13 -0
  25. package/build/core/candidates/build_candidate_context.d.ts.map +1 -0
  26. package/build/core/candidates/build_candidate_context.js +17 -0
  27. package/build/core/candidates/candidate_context.d.ts +13 -0
  28. package/build/core/candidates/candidate_context.d.ts.map +1 -0
  29. package/build/core/candidates/candidate_context.js +1 -0
  30. package/build/core/candidates/candidate_generator.d.ts +9 -0
  31. package/build/core/candidates/candidate_generator.d.ts.map +1 -0
  32. package/build/core/candidates/candidate_generator.js +42 -0
  33. package/build/core/candidates/candidate_validation.d.ts +14 -0
  34. package/build/core/candidates/candidate_validation.d.ts.map +1 -0
  35. package/build/core/candidates/candidate_validation.js +72 -0
  36. package/build/core/candidates/collect_container_slots.d.ts +16 -0
  37. package/build/core/candidates/collect_container_slots.d.ts.map +1 -0
  38. package/build/core/candidates/collect_container_slots.js +20 -0
  39. package/build/core/candidates/enumerate_empty_space_slots.d.ts +15 -0
  40. package/build/core/candidates/enumerate_empty_space_slots.d.ts.map +1 -0
  41. package/build/core/candidates/enumerate_empty_space_slots.js +44 -0
  42. package/build/core/candidates/enumerate_supporter_top_slots.d.ts +11 -0
  43. package/build/core/candidates/enumerate_supporter_top_slots.d.ts.map +1 -0
  44. package/build/core/candidates/enumerate_supporter_top_slots.js +36 -0
  45. package/build/core/candidates/is_elevated_on_supporter_origin.d.ts +14 -0
  46. package/build/core/candidates/is_elevated_on_supporter_origin.d.ts.map +1 -0
  47. package/build/core/candidates/is_elevated_on_supporter_origin.js +28 -0
  48. package/build/core/candidates/rank_candidates.d.ts +9 -0
  49. package/build/core/candidates/rank_candidates.d.ts.map +1 -0
  50. package/build/core/candidates/rank_candidates.js +22 -0
  51. package/build/core/constants/ReorderStrategy.d.ts +11 -0
  52. package/build/core/constants/ReorderStrategy.d.ts.map +1 -0
  53. package/build/core/constants/ReorderStrategy.js +9 -0
  54. package/build/core/constants/TieRatioOrientation.d.ts +6 -0
  55. package/build/core/constants/TieRatioOrientation.d.ts.map +1 -0
  56. package/build/core/constants/TieRatioOrientation.js +5 -0
  57. package/build/core/evaluation/compute_reorder_objective.d.ts +13 -0
  58. package/build/core/evaluation/compute_reorder_objective.d.ts.map +1 -0
  59. package/build/core/evaluation/compute_reorder_objective.js +13 -0
  60. package/build/core/evaluation/evaluation_context.d.ts +14 -0
  61. package/build/core/evaluation/evaluation_context.d.ts.map +1 -0
  62. package/build/core/evaluation/evaluation_context.js +1 -0
  63. package/build/core/evaluation/state_evaluator.d.ts +50 -0
  64. package/build/core/evaluation/state_evaluator.d.ts.map +1 -0
  65. package/build/core/evaluation/state_evaluator.js +95 -0
  66. package/build/core/exceptions/AxleCalculationError.d.ts +4 -0
  67. package/build/core/exceptions/AxleCalculationError.d.ts.map +1 -0
  68. package/build/core/exceptions/AxleCalculationError.js +6 -0
  69. package/build/core/exceptions/InvalidStabilizerInputError.d.ts +4 -0
  70. package/build/core/exceptions/InvalidStabilizerInputError.d.ts.map +1 -0
  71. package/build/core/exceptions/InvalidStabilizerInputError.js +6 -0
  72. package/build/core/exceptions/InvalidStabilizerOutputError.d.ts +4 -0
  73. package/build/core/exceptions/InvalidStabilizerOutputError.d.ts.map +1 -0
  74. package/build/core/exceptions/InvalidStabilizerOutputError.js +6 -0
  75. package/build/core/exceptions/MixedWaypointIdError.d.ts +4 -0
  76. package/build/core/exceptions/MixedWaypointIdError.d.ts.map +1 -0
  77. package/build/core/exceptions/MixedWaypointIdError.js +6 -0
  78. package/build/core/exceptions/UnknownReorderStrategyError.d.ts +4 -0
  79. package/build/core/exceptions/UnknownReorderStrategyError.d.ts.map +1 -0
  80. package/build/core/exceptions/UnknownReorderStrategyError.js +6 -0
  81. package/build/core/factory/read_stabilizer_config.d.ts +10 -0
  82. package/build/core/factory/read_stabilizer_config.d.ts.map +1 -0
  83. package/build/core/factory/read_stabilizer_config.js +26 -0
  84. package/build/core/factory/read_stabilizer_config_helpers.d.ts +29 -0
  85. package/build/core/factory/read_stabilizer_config_helpers.d.ts.map +1 -0
  86. package/build/core/factory/read_stabilizer_config_helpers.js +73 -0
  87. package/build/core/factory/strategy_factory.d.ts +9 -0
  88. package/build/core/factory/strategy_factory.d.ts.map +1 -0
  89. package/build/core/factory/strategy_factory.js +29 -0
  90. package/build/core/filters/collect_movable_items.d.ts +18 -0
  91. package/build/core/filters/collect_movable_items.d.ts.map +1 -0
  92. package/build/core/filters/collect_movable_items.js +72 -0
  93. package/build/core/filters/loose_item_filter.d.ts +20 -0
  94. package/build/core/filters/loose_item_filter.d.ts.map +1 -0
  95. package/build/core/filters/loose_item_filter.js +28 -0
  96. package/build/core/geometry/box_geometry.d.ts +48 -0
  97. package/build/core/geometry/box_geometry.d.ts.map +1 -0
  98. package/build/core/geometry/box_geometry.js +98 -0
  99. package/build/core/logging/stabilizer_logger.d.ts +3 -0
  100. package/build/core/logging/stabilizer_logger.d.ts.map +1 -0
  101. package/build/core/logging/stabilizer_logger.js +2 -0
  102. package/build/core/move/apply_move.d.ts +26 -0
  103. package/build/core/move/apply_move.d.ts.map +1 -0
  104. package/build/core/move/apply_move.js +26 -0
  105. package/build/core/orchestration/StabilizerFlow.d.ts +15 -0
  106. package/build/core/orchestration/StabilizerFlow.d.ts.map +1 -0
  107. package/build/core/orchestration/StabilizerFlow.js +29 -0
  108. package/build/core/orchestration/build_milkrun_bands_from_config.d.ts +13 -0
  109. package/build/core/orchestration/build_milkrun_bands_from_config.d.ts.map +1 -0
  110. package/build/core/orchestration/build_milkrun_bands_from_config.js +14 -0
  111. package/build/core/orchestration/build_reorder_context.d.ts +11 -0
  112. package/build/core/orchestration/build_reorder_context.d.ts.map +1 -0
  113. package/build/core/orchestration/build_reorder_context.js +27 -0
  114. package/build/core/orchestration/read_primary_env.d.ts +9 -0
  115. package/build/core/orchestration/read_primary_env.d.ts.map +1 -0
  116. package/build/core/orchestration/read_primary_env.js +13 -0
  117. package/build/core/strategies/reorder/BeamSearchReorder.d.ts +9 -0
  118. package/build/core/strategies/reorder/BeamSearchReorder.d.ts.map +1 -0
  119. package/build/core/strategies/reorder/BeamSearchReorder.js +68 -0
  120. package/build/core/strategies/reorder/GeneticReorder.d.ts +9 -0
  121. package/build/core/strategies/reorder/GeneticReorder.d.ts.map +1 -0
  122. package/build/core/strategies/reorder/GeneticReorder.js +43 -0
  123. package/build/core/strategies/reorder/GravityCompaction.d.ts +9 -0
  124. package/build/core/strategies/reorder/GravityCompaction.d.ts.map +1 -0
  125. package/build/core/strategies/reorder/GravityCompaction.js +48 -0
  126. package/build/core/strategies/reorder/GreedyReorder.d.ts +9 -0
  127. package/build/core/strategies/reorder/GreedyReorder.d.ts.map +1 -0
  128. package/build/core/strategies/reorder/GreedyReorder.js +20 -0
  129. package/build/core/strategies/reorder/ReorderStrategy.d.ts +19 -0
  130. package/build/core/strategies/reorder/ReorderStrategy.d.ts.map +1 -0
  131. package/build/core/strategies/reorder/ReorderStrategy.js +1 -0
  132. package/build/core/strategies/reorder/SimulatedAnnealingReorder.d.ts +9 -0
  133. package/build/core/strategies/reorder/SimulatedAnnealingReorder.d.ts.map +1 -0
  134. package/build/core/strategies/reorder/SimulatedAnnealingReorder.js +61 -0
  135. package/build/core/strategies/reorder/anneal_helpers.d.ts +18 -0
  136. package/build/core/strategies/reorder/anneal_helpers.d.ts.map +1 -0
  137. package/build/core/strategies/reorder/anneal_helpers.js +39 -0
  138. package/build/core/strategies/reorder/apply_if_gates_pass.d.ts +12 -0
  139. package/build/core/strategies/reorder/apply_if_gates_pass.d.ts.map +1 -0
  140. package/build/core/strategies/reorder/apply_if_gates_pass.js +19 -0
  141. package/build/core/strategies/reorder/beam_context.d.ts +16 -0
  142. package/build/core/strategies/reorder/beam_context.d.ts.map +1 -0
  143. package/build/core/strategies/reorder/beam_context.js +1 -0
  144. package/build/core/strategies/reorder/genetic/Chromosome.d.ts +39 -0
  145. package/build/core/strategies/reorder/genetic/Chromosome.d.ts.map +1 -0
  146. package/build/core/strategies/reorder/genetic/Chromosome.js +84 -0
  147. package/build/core/strategies/reorder/greedy_improvement.d.ts +12 -0
  148. package/build/core/strategies/reorder/greedy_improvement.d.ts.map +1 -0
  149. package/build/core/strategies/reorder/greedy_improvement.js +63 -0
  150. package/build/core/strategies/reorder/select_beam_expansion_candidates.d.ts +9 -0
  151. package/build/core/strategies/reorder/select_beam_expansion_candidates.d.ts.map +1 -0
  152. package/build/core/strategies/reorder/select_beam_expansion_candidates.js +28 -0
  153. package/build/core/validation/contract/cargo_movement_wire_field_map.d.ts +37 -0
  154. package/build/core/validation/contract/cargo_movement_wire_field_map.d.ts.map +1 -0
  155. package/build/core/validation/contract/cargo_movement_wire_field_map.js +43 -0
  156. package/build/core/validation/contract/cargo_movement_wire_mapper.d.ts +14 -0
  157. package/build/core/validation/contract/cargo_movement_wire_mapper.d.ts.map +1 -0
  158. package/build/core/validation/contract/cargo_movement_wire_mapper.js +34 -0
  159. package/build/core/validation/contract/format_zod_error.d.ts +8 -0
  160. package/build/core/validation/contract/format_zod_error.d.ts.map +1 -0
  161. package/build/core/validation/contract/format_zod_error.js +11 -0
  162. package/build/core/validation/contract/index.d.ts +9 -0
  163. package/build/core/validation/contract/index.d.ts.map +1 -0
  164. package/build/core/validation/contract/index.js +8 -0
  165. package/build/core/validation/contract/map_contract_to_wire_shape.d.ts +3 -0
  166. package/build/core/validation/contract/map_contract_to_wire_shape.d.ts.map +1 -0
  167. package/build/core/validation/contract/map_contract_to_wire_shape.js +42 -0
  168. package/build/core/validation/contract/map_wire_input_to_contract_shape.d.ts +2 -0
  169. package/build/core/validation/contract/map_wire_input_to_contract_shape.d.ts.map +1 -0
  170. package/build/core/validation/contract/map_wire_input_to_contract_shape.js +60 -0
  171. package/build/core/validation/contract/map_wire_item_to_contract.d.ts +12 -0
  172. package/build/core/validation/contract/map_wire_item_to_contract.d.ts.map +1 -0
  173. package/build/core/validation/contract/map_wire_item_to_contract.js +49 -0
  174. package/build/core/validation/contract/parse_stabilizer_input.d.ts +48 -0
  175. package/build/core/validation/contract/parse_stabilizer_input.d.ts.map +1 -0
  176. package/build/core/validation/contract/parse_stabilizer_input.js +26 -0
  177. package/build/core/validation/contract/parse_stabilizer_output.d.ts +50 -0
  178. package/build/core/validation/contract/parse_stabilizer_output.d.ts.map +1 -0
  179. package/build/core/validation/contract/parse_stabilizer_output.js +24 -0
  180. package/build/core/validation/contract/stabilizer_domain_schema.d.ts +101 -0
  181. package/build/core/validation/contract/stabilizer_domain_schema.d.ts.map +1 -0
  182. package/build/core/validation/contract/stabilizer_domain_schema.js +64 -0
  183. package/build/core/validation/contract/stabilizer_input_schema.d.ts +36 -0
  184. package/build/core/validation/contract/stabilizer_input_schema.d.ts.map +1 -0
  185. package/build/core/validation/contract/stabilizer_input_schema.js +11 -0
  186. package/build/core/validation/contract/stabilizer_output_schema.d.ts +76 -0
  187. package/build/core/validation/contract/stabilizer_output_schema.d.ts.map +1 -0
  188. package/build/core/validation/contract/stabilizer_output_schema.js +16 -0
  189. package/build/core/validation/contract/wire_mapper_record_utils.d.ts +34 -0
  190. package/build/core/validation/contract/wire_mapper_record_utils.d.ts.map +1 -0
  191. package/build/core/validation/contract/wire_mapper_record_utils.js +66 -0
  192. package/build/core/validation/schemas/stabilizer_config_schema.d.ts +20 -0
  193. package/build/core/validation/schemas/stabilizer_config_schema.d.ts.map +1 -0
  194. package/build/core/validation/schemas/stabilizer_config_schema.js +17 -0
  195. package/build/core/waypoint/WaypointMode.d.ts +16 -0
  196. package/build/core/waypoint/WaypointMode.d.ts.map +1 -0
  197. package/build/core/waypoint/WaypointMode.js +1 -0
  198. package/build/core/waypoint/build_waypoint_zones.d.ts +21 -0
  199. package/build/core/waypoint/build_waypoint_zones.d.ts.map +1 -0
  200. package/build/core/waypoint/build_waypoint_zones.js +48 -0
  201. package/build/core/waypoint/milkrun_wall_reservation.d.ts +24 -0
  202. package/build/core/waypoint/milkrun_wall_reservation.d.ts.map +1 -0
  203. package/build/core/waypoint/milkrun_wall_reservation.js +57 -0
  204. package/build/core/waypoint/milkrun_wall_reservation_helpers.d.ts +15 -0
  205. package/build/core/waypoint/milkrun_wall_reservation_helpers.d.ts.map +1 -0
  206. package/build/core/waypoint/milkrun_wall_reservation_helpers.js +48 -0
  207. package/build/core/waypoint/milkrun_wall_reservation_types.d.ts +16 -0
  208. package/build/core/waypoint/milkrun_wall_reservation_types.d.ts.map +1 -0
  209. package/build/core/waypoint/milkrun_wall_reservation_types.js +1 -0
  210. package/build/core/waypoint/preserves_waypoint_order.d.ts +24 -0
  211. package/build/core/waypoint/preserves_waypoint_order.d.ts.map +1 -0
  212. package/build/core/waypoint/preserves_waypoint_order.js +49 -0
  213. package/build/core/waypoint/validate_waypoint_ids.d.ts +16 -0
  214. package/build/core/waypoint/validate_waypoint_ids.d.ts.map +1 -0
  215. package/build/core/waypoint/validate_waypoint_ids.js +30 -0
  216. package/build/index.d.ts +27 -0
  217. package/build/index.d.ts.map +1 -0
  218. package/build/index.js +75 -0
  219. package/package.json +51 -0
package/build/index.js ADDED
@@ -0,0 +1,75 @@
1
+ import { Logger } from '@jetta/logger';
2
+ import { run_stabilizer_flow_from_unknown } from './core/orchestration/StabilizerFlow.js';
3
+ import { stabilizer_logger } from './core/logging/stabilizer_logger.js';
4
+ import { map_contract_to_wire_output, parse_stabilizer_output } from './core/validation/contract/index.js';
5
+ export { REORDER_STRATEGY, REORDER_STRATEGY_VALUES } from './core/constants/ReorderStrategy.js';
6
+ export { MixedWaypointIdError } from './core/exceptions/MixedWaypointIdError.js';
7
+ export { UnknownReorderStrategyError } from './core/exceptions/UnknownReorderStrategyError.js';
8
+ export { InvalidStabilizerInputError } from './core/exceptions/InvalidStabilizerInputError.js';
9
+ export { InvalidStabilizerOutputError } from './core/exceptions/InvalidStabilizerOutputError.js';
10
+ export { parse_stabilizer_input, safe_parse_stabilizer_input, parse_stabilizer_output, safe_parse_stabilizer_output, map_wire_input_to_contract, map_contract_to_wire_output } from './core/validation/contract/index.js';
11
+ const messages = [];
12
+ const UNKNOWN_IDENTITY = 'UNKNOWN';
13
+ /**
14
+ * Stabilizes cargo by reordering loose items (legacy CM-compatible response).
15
+ * @param input - Cargo-movement wire payload or English contract input.
16
+ * @returns Success or error response with CM wire cargo_state on success.
17
+ */
18
+ export async function stabilize(input) {
19
+ const identity = read_stabilizer_identity(input);
20
+ return Logger.run_with_cargo_info(identity.company, identity.cargo_id, () => run_stabilize(input));
21
+ }
22
+ function read_stabilizer_identity(input) {
23
+ if (typeof input !== 'object' || input === null) {
24
+ return { company: UNKNOWN_IDENTITY, cargo_id: UNKNOWN_IDENTITY };
25
+ }
26
+ const record = input;
27
+ return {
28
+ company: record.company !== undefined ? String(record.company) : UNKNOWN_IDENTITY,
29
+ cargo_id: record.id !== undefined ? String(record.id) : UNKNOWN_IDENTITY
30
+ };
31
+ }
32
+ function run_stabilize(input) {
33
+ stabilizer_logger.log('cargo-stabilizer started');
34
+ try {
35
+ const cargo_state = run_stabilizer_flow_from_unknown(input);
36
+ stabilizer_logger.log('cargo-stabilizer finished successfully');
37
+ return build_success_response(cargo_state);
38
+ }
39
+ catch (error) {
40
+ return build_error_response(error);
41
+ }
42
+ }
43
+ function build_success_response(cargo_state) {
44
+ const english_response = {
45
+ status: 'success',
46
+ data: cargo_state,
47
+ messages: [...messages]
48
+ };
49
+ const validated = parse_stabilizer_output(english_response);
50
+ if (validated.status !== 'success') {
51
+ throw new Error('Expected success response after stabilizer flow');
52
+ }
53
+ return {
54
+ status: 'success',
55
+ data: map_contract_to_wire_output(validated.data),
56
+ messages: validated.messages
57
+ };
58
+ }
59
+ function build_error_response(err) {
60
+ stabilizer_logger.warn('cargo-stabilizer finished with error');
61
+ stabilizer_logger.error(err.message);
62
+ if (err.stack) {
63
+ stabilizer_logger.error(err.stack);
64
+ }
65
+ const response = {
66
+ status: 'error',
67
+ data: err.message,
68
+ messages: [...messages, err.message]
69
+ };
70
+ parse_stabilizer_output(response);
71
+ return response;
72
+ }
73
+ export { run_stabilizer_flow_from_unknown } from './core/orchestration/StabilizerFlow.js';
74
+ export { create_reorder_strategy } from './core/factory/strategy_factory.js';
75
+ export { validate_waypoint_ids } from './core/waypoint/validate_waypoint_ids.js';
package/package.json ADDED
@@ -0,0 +1,51 @@
1
+ {
2
+ "name": "@jetta/cargo-stabilizer",
3
+ "version": "0.1.0-10",
4
+ "description": "Stable loose-item reorder library for cargo-movement (JET-2262)",
5
+ "main": "build/index.js",
6
+ "types": "build/index.d.ts",
7
+ "type": "module",
8
+ "engines": {
9
+ "node": ">=24"
10
+ },
11
+ "files": [
12
+ "build"
13
+ ],
14
+ "scripts": {
15
+ "audit": "npm audit --omit=dev",
16
+ "preversion": "git fetch --prune --tags",
17
+ "version": "npm run build",
18
+ "postversion": "git push origin HEAD --follow-tags",
19
+ "publish:alpha": "npm version --tag-version-prefix=alpha-v",
20
+ "publish:stable": "npm version",
21
+ "prerelease:alpha": "npm version prerelease --tag-version-prefix=alpha-v",
22
+ "coverage": "c8 --check-coverage --lines 80 --functions 80 --branches 80 --statements 80 --reporter=html --reporter=text npm run test",
23
+ "prebuild": "rm -rf build/*",
24
+ "build": "tsc",
25
+ "test": "tsx --import ./test/mocha_setup.ts ./node_modules/mocha/bin/mocha \"test/src/**/*.test.ts\"",
26
+ "lint": "eslint src test/src --ext .ts",
27
+ "lint:fix": "eslint src test/src --fix",
28
+ "lint:package": "publint --strict --pack npm",
29
+ "coverage:ci": "c8 --reporter=text --reporter=text-summary --check-coverage --lines 75 --functions 75 --branches 75 --statements 75 npm run test"
30
+ },
31
+ "dependencies": {
32
+ "@jetta/axle-load-calculator": "^0.1.3",
33
+ "@jetta/cargo-stability": "^2.0.1-3",
34
+ "@jetta/empty-spaces-manager": "^0.1.1-0",
35
+ "zod": "^4.4.3"
36
+ },
37
+ "devDependencies": {
38
+ "@types/chai": "^5.2.3",
39
+ "@types/mocha": "^10.0.10",
40
+ "@types/node": "^25.9.1",
41
+ "@typescript-eslint/eslint-plugin": "^8.59.4",
42
+ "@typescript-eslint/parser": "^8.59.4",
43
+ "c8": "^11.0.0",
44
+ "chai": "^6.2.2",
45
+ "eslint": "^9.39.4",
46
+ "mocha": "^11.7.6",
47
+ "publint": "^0.3.23",
48
+ "tsx": "^4.22.3",
49
+ "typescript": "^6.0.3"
50
+ }
51
+ }