Cross-border freight,
orchestrated.
One layer above your carriers. Predicts the delays, optimizes the routes, generates the customs docs, and runs the squad that keeps the container moving. Methodology-first, heuristic-honest.
Your container hits port. Then everything breaks.
Your forwarder emails you one update a week. The carrier portal says "in transit" for eleven days. The customs broker is asleep in another timezone. By the time you know a delay happened, the delay has already compounded into three. Logistics is the layer that sees it on day one, names the cause, and queues the mitigation.
What's inside
Six capabilities, each citing the backend file that ships it. Each methodology has a transparent heuristic fallback so the system still answers when the methodology path is offline.
Temporal ETA Prediction
Methodology #235 (Temporal Reasoning) predicts delivery timelines from exception signals and historical transit patterns. Heuristic fallback quantifies delay as 24h per high/critical exception, 8h per medium — transparent arithmetic, not a black-box estimate.
Spatial Route Optimization
Methodology #237 (Spatial Reasoning) picks cost, speed, or balanced routes across carriers and modes. Heuristic fallback sorts available rates by your chosen objective so you always get an answer, even when the methodology path is offline.
CausalPlan Exception Prediction
Methodology #230 (CausalPlan) scores shipments on delay risk and names the causal factors — carrier history, lane complexity, mode-specific disruption. Heuristic fallback returns a scored breakdown from historical exceptions so you see which lanes repeat.
Customs Doc Generation
Five templates wired today: commercial invoice, packing list, bill of lading, certificate of origin, customs declaration. Populated from the shipment record (shipper, consignee, HS codes, Incoterm, value, mode) in one call.
11 Incoterms 2020, Structured
EXW, FCA, CPT, CIP, DAP, DPU, DDP, FAS, FOB, CFR, CIF — each with risk transfer point, cost responsibility split, insurance rules, and export/import clearance duties. Structured data, not a PDF you have to re-read every deal.
Unified Carrier Tracking
One /track endpoint, four carriers (FedEx, UPS, DHL, USPS). Auto-detects carrier from tracking number format. Running in stub mode today — live API swap is env-var driven, flips on when FEDEX_API_KEY / UPS_CLIENT_ID / DHL_API_KEY / USPS_API_KEY are set.
FIVE EMPLOYEES, ONE LANE
The logistics squad
Defined in src/empires/logistics/models.py. Each employee owns one slice of the lane end-to-end, with explicit handoffs between them.
Shipment tracking aggregation and carrier coordination across the four wired carriers.
Operational workflow optimization and exception handling for the in-transit pipeline.
Inventory-in-transit visibility aligned to demand windows and safety-stock thresholds.
Port congestion, regulatory change, and strike-risk signal fused into the risk score.
Rate benchmarking and financial impact on freight spend per lane, per carrier, per mode.
WHAT'S REAL, WHAT'S PLANNED
Courier carriers are wired. Ocean & air forwarders are planned connectors, not shipped.
REAL TODAY
- — FedEx, UPS, DHL, USPS unified client (stub mode by default)
- — Auto-carrier-detect from tracking number format
- — Methodology #235 Temporal ETA with heuristic fallback
- — Methodology #237 Spatial route optimization with heuristic fallback
- — Methodology #230 CausalPlan exception prediction with heuristic fallback
- — 5 customs doc templates (invoice, packing, BOL, COO, declaration)
- — 11 Incoterms 2020 fully structured
PLANNED + ROADMAP
- — Live FedEx / UPS / DHL / USPS API swap (env-var gated, not yet active)
- — Maersk, Hapag-Lloyd, OOCL ocean connectors
- — Lufthansa Cargo air-freight connector
- — SOC 2 Type II: not yet audited
- — 99.9% availability: post-launch target
- — Expanded KB domains (HS codes, sanctioned entities, trade lanes)
- — Zero paying customers today — we are pre-launch
Logistics Pricing
Target launch pricing, anchored to a logistics-tech competitor scan (Project44, MercuryGate, CargoWise, e2open benchmarks). Gain-share is 12% of verified savings above baseline + $2,500/mo platform minimum, sales-led with a signed SOW. Waitlist signups get the locked launch rate the day billing goes live.
For SMB importers and shippers who want one dashboard across their carriers.
Target launch pricing — subject to validation
- ✓Up to 500 active shipments
- ✓Unified tracking across FedEx, UPS, DHL, USPS
- ✓5 customs doc templates
- ✓Heuristic ETA + exception scoring
- ✓Incoterms 2020 reference
- ✓Email support
For mid-market shippers running real freight spend. Sales-led, pilot-first. $2,500/mo platform minimum + 12% of verified savings above baseline. Structure: baseline audit → 30–90 day pilot → signed SOW on savings methodology → quarterly audit with your finance team.
Gain-share % is the stated business model (not a fabricated price)
- ✓30–90 day pilot with baseline measurement
- ✓Quarterly savings audit against the baseline
- ✓Signed SOW before any gain-share bills
- ✓Methodology #235 + #237 + #230 active
- ✓Rowan + Maestro + Morgan + Scout + Finn squad
- ✓Slack channel with the implementation team
For 3PLs and global shippers with custom routing logic and compliance surface. Quoted per deployment scope.
Quoted per deployment scope
- ✓Unlimited shipments and rates
- ✓Custom customs doc templates
- ✓Custom CausalPlan risk factors
- ✓SSO + audit log export
- ✓Target: 99.9% availability (post-launch)
- ✓Target: SOC 2 Type II (post-launch)
POWERED BY THE COGNITIVE MESH
Three methodologies for the lane, plus the reasoning stack on top.
Temporal Reasoning (#235) predicts arrival. Spatial Reasoning (#237) optimizes the route. CausalPlan (#230) names the disruption causes. Each is wrapped by the cross-cutting reasoning layer that powers the rest of LiquidCortex — so route decisions get Tree-of-Thought spread, exception decisions get Self-Refine re-planning when new signal lands, and the squad shares a single Workflow Memory across the shipment.
Questions a skeptical head of supply chain asks
FedEx, UPS, DHL, and USPS are wired at the client layer (src/integrations/carriers/carrier_client.py) with a unified tracking + rate + booking interface. They run in stub mode by default — returning realistic sample data — and flip to live API calls when the corresponding env vars are present (FEDEX_API_KEY, UPS_CLIENT_ID + UPS_CLIENT_SECRET, DHL_API_KEY, USPS_API_KEY). Ocean and air-freight forwarders (Maersk, Hapag-Lloyd, OOCL, Lufthansa Cargo) are on the dashboard as planned connectors — they are NOT live yet. We do not pretend otherwise.
Both, depending on availability. The primary path is Methodology #235 (Temporal Reasoning) at src/empires/logistics/logistics_engine.py:31-89 — it consumes shipment state, exceptions, and historical transit patterns to produce a predicted arrival with confidence and factor breakdown. When the methodology path is unavailable, the heuristic fallback at lines 66-89 quantifies delay as 24h per high/critical exception + 8h per medium, returns a transparent risk tier, and surfaces every exception that went into the calculation. No hidden model, no mystery number.
Methodology #237 (Spatial Reasoning) at logistics_engine.py:93-180 runs the primary optimization using your origin, destination, mode, available rates, and constraints. When it is offline, the heuristic fallback sorts your rate quotes: speed mode by transit days ascending, cost mode by rate ascending, balanced mode by a 50/50 blend of rate and transit time. The cheapest-vs-worst delta becomes your explicit savings number — not a marketing stat.
Gain-share is sales-led, not self-serve. The process: we sign an SOW, we measure your baseline freight spend over a 30–90 day pilot, we run the optimization and exception-prediction layers against your live shipments, and we conduct a quarterly savings audit against the measured baseline. You pay 10–15% of the verified savings — not projected, not estimated, verified. If the audit shows no savings, you pay zero. No trap. Target launch pricing and terms, finalized per deal.
Because we have not finished the logistics-tech competitor scan. Flexport, Project44, FourKites, e2open, and Descartes each price very differently — from per-shipment fees to seat licenses to percentage-of-spend — and publishing a confident $/mo before that scan would be vibes-based. We would rather tell you the self-serve tier is placeholder and lock the published number on the day it is set than quote you a figure we cannot defend on a sales call. Waitlist signups get the locked launch rate the day it is published. Gain-share is different — the 10–15% band is the stated business model, not a guess at what the market pays.
src/empires/logistics/logistics_knowledge.py targets 500+ structured entries across 10 domains (Incoterms, ports, carriers, HS codes, sanctioned entities, trade lanes, formulas, customs docs, carrier reliability, freight surcharges). The 11 Incoterms 2020 are fully wired today. The remaining domains are in active build — we do not claim completeness until each domain has its own test coverage.
Flexport is a licensed freight forwarder — they book your freight. Project44 is a visibility platform — they show you where your freight is. LiquidCortex Logistics is a cross-border 3PL orchestrator: it sits on top of your existing carriers and forwarders, predicts the delays, optimizes the routes, generates the customs docs, and runs the employee squad (Rowan + Maestro + Morgan + Scout + Finn) end to end. We do not replace your forwarder. We make the forwarder you already pay more legible, more predictive, and cheaper to operate against.
Move the container. Then know why it moved.
Join the Logistics waitlist. Launch pricing locks for signups the day it is published. Gain-share pilots are sales-led — request one below.