mercuria 0.1.0 → 0.3.0
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.
- package/README.md +47 -3
- package/app/app.js +915 -0
- package/app/data/world.json +118288 -0
- package/app/favicon.svg +5 -0
- package/app/index.html +144 -0
- package/app/styles.css +596 -0
- package/bin/mercuria.js +8 -0
- package/netlify.toml +16 -0
- package/package.json +48 -10
- package/scripts/build-nhfn-range.mjs +11 -0
- package/src/cli.mjs +73 -0
- package/src/harness.mjs +345 -0
- package/src/index.mjs +10 -0
- package/src/shared/commands.mjs +247 -0
- package/src/shared/oauth-store.mjs +78 -0
- package/src/shared/openai-auth.mjs +250 -0
- package/src/shared/world.mjs +450 -0
- package/index.js +0 -4
package/README.md
CHANGED
|
@@ -1,5 +1,49 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Mercuria
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
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.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## What ships
|
|
6
|
+
|
|
7
|
+
- `mercuria build` compacts an NHFN-style range into a smaller world file for the static app.
|
|
8
|
+
- `mercuria harness` serves the app and exposes a local API and event stream from one VPS-friendly process.
|
|
9
|
+
- the harness includes a manual-paste OpenAI OAuth flow for staff login on a headless VPS
|
|
10
|
+
- `app/` is the static Netlify shell.
|
|
11
|
+
- `src/harness.mjs` is the embeddable runtime surface exported by the package.
|
|
12
|
+
|
|
13
|
+
## Quickstart
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm install -g mercuria
|
|
17
|
+
mercuria harness --world ./app/data/world.json --site-dir ./app --port 4177
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## Build a world file
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
mercuria build \
|
|
24
|
+
--source /root/first-nations-dashboard-netlify/web/data/compiled/dashboard_dataset.json \
|
|
25
|
+
--out ./app/data/world.json
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Commands
|
|
29
|
+
|
|
30
|
+
- `mercuria build`
|
|
31
|
+
- `mercuria harness`
|
|
32
|
+
- `mercuria serve`
|
|
33
|
+
- `mercuria command "show food gaps"`
|
|
34
|
+
- `npm run verify:live`
|
|
35
|
+
- `npm run capture:live`
|
|
36
|
+
|
|
37
|
+
## Staff login
|
|
38
|
+
|
|
39
|
+
Mercuria follows the VPS-safe manual paste flow:
|
|
40
|
+
|
|
41
|
+
1. Click `Begin OpenAI sign-in`.
|
|
42
|
+
2. Sign in with OpenAI in the browser.
|
|
43
|
+
3. Copy the full redirect URL.
|
|
44
|
+
4. Paste it back into the Mercuria staff panel.
|
|
45
|
+
5. Complete the exchange on the harness.
|
|
46
|
+
|
|
47
|
+
## Deploy
|
|
48
|
+
|
|
49
|
+
The repository is set up as a static Netlify site with `app/` as the publish directory.
|