Mercuria

Mercuria is a world engine: a minimal static shell, a low-friction Node harness, and a CLI that can transform structured ranges into a live terrain for operational intelligence.

What ships

• mercuria build compacts an NHFN-style range into a smaller world file for the static app.
• mercuria harness serves the app and exposes a local API and event stream from one VPS-friendly process.
• app/ is the static Netlify shell.
• src/harness.mjs is the embeddable runtime surface exported by the package.

Quickstart

npm install -g @lmtlssss/mercuria
mercuria harness --world ./app/data/world.json --site-dir ./app --port 4177

Build a world file

mercuria build \
  --source /root/first-nations-dashboard-netlify/web/data/compiled/dashboard_dataset.json \
  --out ./app/data/world.json

Commands

• mercuria build
• mercuria harness
• mercuria serve
• mercuria command "show food gaps"

Deploy

The repository is set up as a static Netlify site with app/ as the publish directory.