Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LogisticSetup

Preliminary Setup Universe wrapper. The current demo is temporary; the full simulator is expected to be redesigned and rebuilt substantially from scratch.

  • Live prototype: https://logisticsetup.com/
  • Prototype release verified: 2026-07-26 (20260726T002235Z-478235af2650); check the URL for current availability
  • Field: Logistics and flow networks
  • Status: Greenfield planning wrapper with a preserved prototype snapshot

Vision

The intended LogisticSetup product is a discrete-event and network-flow simulator for facilities, vehicles, inventories, schedules, disruptions, routing policies, queues, and service constraints.

LogisticSetup is part of the Setup Universe: independently deployed scientific and systems workbenches intended to become interoperable. Over time, setups should be able to orchestrate or interface with one another through explicit, versioned, unit-aware ports without transferring ownership or copying private implementation state.

First accepted end-to-end slice: Build one source–hub–sink discrete-event network where capacity, queues, routing decisions, disruptions, and every completed delivery are causally inspectable.

Model boundary: LogisticSetup owns movement, inventory, queues, and service networks; EgoSetup owns agent/institution decisions; ComputationSetup owns optimization algorithms supplied through explicit interfaces.

Claim gate: No operational SLA, cost, capacity, resilience, service-time, or business-performance guarantee is allowed without validated data, assumptions, and uncertainty.

Important starting point

Read AGENTS.md before planning or implementing work.

The present browser demo should not constrain the next architecture. Before substantial implementation, this repository expects VISION.md, LOGISTICS_MODEL_CONTRACT.md, INTERFACE_CONTRACT.md, CLAIMS_AND_VALIDATION.md, and ACCEPTANCE_TESTS.md.

Prototype model boundary

The following describes only the current reference prototype, not the intended simulator.

Exact current scope: Parcels use shortest paths with congestion-weighted edge costs. Capacity sharing creates queues and rerouting at each hub.

Known limits:

  • Travel time is a stylized continuous flow model, not a carrier timetable.
  • Demand and service rates are stochastic but seeded for deterministic reset.
  • Costs include distance and live occupancy; inventory and pricing are outside the model.

Current prototype snapshot

prototype/ preserves the exact shared browser-prototype source associated with production release 20260726T002235Z-478235af2650. Its recorded deployed-source SHA-256 is 478235af26508aa70aa2af5f0196c9868b92ded1bed88106a9aa1a1cd86f8ba5.

The snapshot contains all current Setup Universe demos because that release uses one shared, host-routed runtime. It is immutable, reference-only prior art: do not build the new architecture inside it. Moving, archiving, or removing it requires explicit user authorization after an accepted successor and preserved provenance.

To run the snapshot locally:

npm run prototype:test
npm run prototype:check
npm run prototype:serve

Then open http://127.0.0.1:4173/?setup=logistic.

These commands validate only the legacy prototype. This wrapper intentionally has no future-product test suite until the greenfield implementation begins.

Setup Universe

PicSetup · ElectricalSetup · BiologicalSetup · GravitySetup · TwoPhotonLithography · EgoSetup · QuantumSetup · NoeticSetup · ComputationSetup · MolecularSetup

OpticalSetup remains in LucaGenchi/optics-sketch.

License

No open-source license has been selected yet.

About

Preliminary Setup Universe wrapper for LogisticSetup; current prototype preserved, full simulator to be rebuilt from scratch.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages