@jetta/cargo-stabilizer 0.1.0-9 → 0.1.1

package/build/index.js

@@ -1,7 +1,7 @@
 import { Logger } from '@jetta/logger';
-import { run_stabilizer_flow_from_unknown } from './core/orchestration/StabilizerFlow.js';
+import { run_stabilizer_flow } from './core/orchestration/StabilizerFlow.js';
 import { stabilizer_logger } from './core/logging/stabilizer_logger.js';
-import { map_contract_to_wire_output, parse_stabilizer_output } from './core/validation/contract/index.js';
+import { parse_stabilizer_input, parse_stabilizer_output } from './core/validation/contract/index.js';
 export { REORDER_STRATEGY, REORDER_STRATEGY_VALUES } from './core/constants/ReorderStrategy.js';
 export { MixedWaypointIdError } from './core/exceptions/MixedWaypointIdError.js';
 export { UnknownReorderStrategyError } from './core/exceptions/UnknownReorderStrategyError.js';
@@ -11,13 +11,36 @@ export { parse_stabilizer_input, safe_parse_stabilizer_input, parse_stabilizer_o
 const messages = [];
 const UNKNOWN_IDENTITY = 'UNKNOWN';
 /**
- * Stabilizes cargo by reordering loose items (legacy CM-compatible response).
+ * Parses unknown wire or English input, then runs the typed stabilizer.
  * @param input - Cargo-movement wire payload or English contract input.
- * @returns Success or error response with CM wire cargo_state on success.
+ * @returns Success or error response with typed cargo_state on success.
  */
 export async function stabilize(input) {
     const identity = read_stabilizer_identity(input);
-    return Logger.run_with_cargo_info(identity.company, identity.cargo_id, () => run_stabilize(input));
+    return Logger.run_with_cargo_info(identity.company, identity.cargo_id, () => {
+        try {
+            return run_stabilize(parse_stabilizer_input(input));
+        }
+        catch (error) {
+            return build_error_response(error);
+        }
+    });
+}
+/**
+ * Runs stabilizer on a parsed contract input. `unknown` is not accepted.
+ * @param input - Validated stabilizer input.
+ * @returns Success or error response.
+ */
+export function run_stabilize(input) {
+    stabilizer_logger.log('cargo-stabilizer started');
+    try {
+        const cargo_state = run_stabilizer_flow(input);
+        stabilizer_logger.log('cargo-stabilizer finished successfully');
+        return build_success_response(cargo_state);
+    }
+    catch (error) {
+        return build_error_response(error);
+    }
 }
 function read_stabilizer_identity(input) {
     if (typeof input !== 'object' || input === null) {
@@ -29,17 +52,6 @@ function read_stabilizer_identity(input) {
         cargo_id: record.id !== undefined ? String(record.id) : UNKNOWN_IDENTITY
     };
 }
-function run_stabilize(input) {
-    stabilizer_logger.log('cargo-stabilizer started');
-    try {
-        const cargo_state = run_stabilizer_flow_from_unknown(input);
-        stabilizer_logger.log('cargo-stabilizer finished successfully');
-        return build_success_response(cargo_state);
-    }
-    catch (error) {
-        return build_error_response(error);
-    }
-}
 function build_success_response(cargo_state) {
     const english_response = {
         status: 'success',
@@ -50,11 +62,7 @@ function build_success_response(cargo_state) {
     if (validated.status !== 'success') {
         throw new Error('Expected success response after stabilizer flow');
     }
-    return {
-        status: 'success',
-        data: map_contract_to_wire_output(validated.data),
-        messages: validated.messages
-    };
+    return validated;
 }
 function build_error_response(err) {
     stabilizer_logger.warn('cargo-stabilizer finished with error');

package/package.json

@@ -1,20 +1,33 @@
 {
     "name": "@jetta/cargo-stabilizer",
-    "version": "0.1.0-9",
+    "version": "0.1.1",
     "description": "Stable loose-item reorder library for cargo-movement (JET-2262)",
     "main": "build/index.js",
     "types": "build/index.d.ts",
     "type": "module",
+    "exports": {
+        ".": {
+            "import": {
+                "types": "./build/index.d.ts",
+                "default": "./build/index.js"
+            }
+        }
+    },
     "engines": {
         "node": ">=24"
     },
     "files": [
         "build"
     ],
+    "private": false,
+    "publishConfig": {
+        "access": "public"
+    },
     "scripts": {
         "audit": "npm audit --omit=dev",
         "preversion": "git fetch --prune --tags",
-        "version": "npm run build",
+        "version": "npm run build && npm run lint:package",
+        "prepack": "npm run build && npm run lint:package",
         "postversion": "git push origin HEAD --follow-tags",
         "publish:alpha": "npm version --tag-version-prefix=alpha-v",
         "publish:stable": "npm version",
@@ -29,23 +42,25 @@
         "coverage:ci": "c8 --reporter=text --reporter=text-summary --check-coverage --lines 75 --functions 75 --branches 75 --statements 75 npm run test"
     },
     "dependencies": {
-        "@jetta/axle-load-calculator": "^0.1.3",
-        "@jetta/cargo-stability": "^2.0.1-3",
-        "@jetta/empty-spaces-manager": "^0.1.1-0",
+        "@jetta/axle-load-calculator": "^0.3.3",
+        "@jetta/cargo-stability": "^2.0.2",
+        "@jetta/empty-spaces-manager": "^0.1.1",
+        "@jetta/number-compare": "^3.0.3",
+        "@jetta/stacking-constraints": "^1.1.0",
         "zod": "^4.4.3"
     },
     "devDependencies": {
         "@types/chai": "^5.2.3",
         "@types/mocha": "^10.0.10",
-        "@types/node": "^25.9.1",
-        "@typescript-eslint/eslint-plugin": "^8.59.4",
-        "@typescript-eslint/parser": "^8.59.4",
-        "c8": "^11.0.0",
+        "@types/node": "^26.3.0",
+        "@typescript-eslint/eslint-plugin": "^8.68.0",
+        "@typescript-eslint/parser": "^8.68.0",
+        "c8": "^12.0.0",
         "chai": "^6.2.2",
-        "eslint": "^9.39.4",
-        "mocha": "^11.7.6",
-        "publint": "^0.3.23",
-        "tsx": "^4.22.3",
+        "eslint": "^10.9.1",
+        "mocha": "^11.8.0",
+        "publint": "^0.3.24",
+        "tsx": "^4.23.12",
         "typescript": "^6.0.3"
     }
 }

package/CHANGELOG.md

@@ -1,38 +0,0 @@
-# Changelog
-
-All notable changes to `@jetta/cargo-stabilizer` are documented in this file.
-
-Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
-
-## [Unreleased]
-
-### Added
-
-- Strict English internal I/O contract with bidirectional cargo-movement wire mapper (`map_wire_input_to_contract`, `map_contract_to_wire_output`).
-- Organization gates: waypoint Z zones, macro delivery order (`preserve_tie_block_organization`), and milkrun wall reservation (`enforce_milkrun_wall_reservation`).
-- Empty-space candidate discovery for floor and elevated slots via `@jetta/empty-spaces-manager`.
-- Supporter-top candidate slots aligned to each stacked item footprint, included in beam expansion (`top_k ∪ supporter_top`).
-- Elevated candidates must sit on a supporter `(x, z)` origin so stacked loose items copy the supporter footprint.
-- Public contract exports: `parse_stabilizer_input`, `parse_stabilizer_output`, `safe_parse_stabilizer_input`, `safe_parse_stabilizer_output`, and related domain types.
-
-### Changed
-
-- README documents I/O contract mapping, configuration keys, dependencies, and test/coverage commands.
-- Reorder objective is whole-cargo `transport_score`; loose-item score sum is only a tie-break. Axle, waypoint, and milkrun gates are unchanged.
-
-### Testing
-
-- Expanded Mocha suite to 126 tests mirroring `src/` under `test/src/`.
-- Local coverage gate at 80% on lines, functions, branches, and statements (`npm run coverage`).
-- CI coverage gate at 75% (`npm run coverage:ci`).
-- Mocha setup preloads core modules so c8 attributes coverage consistently across the full suite.
-
-## [0.1.0-3] - 2026-08-14
-
-### Added
-
-- Initial library scaffold (JET-2262).
-- Five config-selectable reorder strategies: gravity, greedy, beam search, simulated annealing, genetic.
-- Zod-validated input contract with `waypoint_id` rules and multi-container support.
-- Shared evaluator: cargo-stability transport gate, axle-load-calculator folga gate, waypoint order.
-- Public `stabilize()` API compatible with cargo-movement legacy response shape.