@net-mesh/deck 0.24.0 → 0.25.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 +53 -20
- package/package.json +10 -10
package/README.md
CHANGED
|
@@ -1,33 +1,66 @@
|
|
|
1
1
|
# @net-mesh/deck
|
|
2
2
|
|
|
3
|
-
The operator cyberdeck — terminal UI for the
|
|
3
|
+
The operator **cyberdeck** — a terminal UI for the NET mesh.
|
|
4
|
+
|
|
5
|
+
Live, streaming, low-latency visibility into MeshOS, MeshDB, RedEX, and Dataforts, with signed admin actions on top. Built with ratatui + crossterm. Matrix palette, neon-green on pitch black.
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
## Install
|
|
4
10
|
|
|
5
11
|
```sh
|
|
12
|
+
# npm (per-platform binaries included)
|
|
6
13
|
npm install -g @net-mesh/deck
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
`@net-mesh/deck` is a thin Node.js shim — installing it pulls in the right per-platform binary package as an `optionalDependency` (npm refuses to install packages that don't match the host's `os` / `cpu` / `libc`). The shim resolves the installed package at runtime and `exec`s the bundled `net-deck` binary.
|
|
17
|
+
|
|
18
|
+
## Run
|
|
19
|
+
|
|
20
|
+
```sh
|
|
7
21
|
net-deck
|
|
8
22
|
```
|
|
9
23
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
24
|
+
## Tabs
|
|
25
|
+
|
|
26
|
+
| Tab | What it shows |
|
|
27
|
+
|--------------|-------------------------------------------------------------------------------------|
|
|
28
|
+
| `NET.MAP` | Live mesh topology — nodes, RTT, health, avoid-lists, maintenance, replica heat. |
|
|
29
|
+
| `NODES` | Per-node inventory: CPU / mem / disk, saturation trend, capability set, versions. |
|
|
30
|
+
| `DAEMONS` | Per-daemon supervision — health, saturation, restarts, crash-loops, log tail. |
|
|
31
|
+
| `DATAFORTS` | Replica & placement: desired vs actual, migrations, pulls, eviction, 5-axis score. |
|
|
32
|
+
| `BLOBS` | Object inventory across every wired adapter — heat, ancestry, shard layout. |
|
|
33
|
+
| `MIGRATIONS` | In-flight + recent migrations with byte progress and stall detection. |
|
|
34
|
+
| `REPLICAS` | Replica density by artifact, drift, placement stability. |
|
|
35
|
+
| `GROUPS` | Replica / fork / standby groupings. |
|
|
36
|
+
| `SUBNETS` | Subnet membership and gateway routing. |
|
|
37
|
+
| `GATEWAYS` | Gateway daemons — bridges into the mesh from outside transports. |
|
|
38
|
+
| `AGGREGATORS`| Aggregator-daemon attach / scale state, remote-attach RPC tail. |
|
|
39
|
+
| `NRPC` | Live nRPC call tail — request / response / failure stream across the cluster. |
|
|
40
|
+
| `LOGS` | High-speed log matrix — node → daemon → line, with filter + follow. |
|
|
41
|
+
| `AUDIT` | RedEX-committed operator audit ledger. |
|
|
42
|
+
| `FAILURES` | Recent failures across daemons, migrations, blob pulls. |
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
## Admin surface — signed ops
|
|
48
|
+
|
|
49
|
+
Every admin action propagates as a signed event on the admin chain via RedEX:
|
|
50
|
+
|
|
51
|
+
- drain / cordon / uncordon node
|
|
52
|
+
- enter / exit maintenance
|
|
53
|
+
- drop replicas, invalidate placement
|
|
54
|
+
- restart daemons, clear avoid lists
|
|
55
|
+
- ICE: force-drain, force-evict, force-restart, force-cutover, freeze / thaw
|
|
15
56
|
|
|
16
|
-
|
|
57
|
+
Before an ICE action commits, Deck runs a **blast-radius** simulation —
|
|
58
|
+
*"This action affects 4 nodes, 12 replicas, and 2 daemons. Continue?"* — then signs with the operator key loaded from the maintenance node. Multi-operator signing and lockout timers are available for the high-authority break-glass paths.
|
|
17
59
|
|
|
18
|
-
|
|
19
|
-
- linux aarch64 (glibc + musl)
|
|
20
|
-
- macOS x86_64 + aarch64
|
|
21
|
-
- Windows x86_64 + aarch64
|
|
60
|
+
## Bookmarks (multi-cluster)
|
|
22
61
|
|
|
23
|
-
|
|
62
|
+
Saved cluster contexts live at `$XDG_CONFIG_HOME/deck/bookmarks.toml` (or the platform equivalent — see [`dirs`](https://docs.rs/dirs)). First-run with no config dir yields an empty store; a malformed file is surfaced via stderr.
|
|
24
63
|
|
|
25
|
-
|
|
26
|
-
- **cargo-binstall** — `cargo binstall net-deck` (downloads the
|
|
27
|
-
prebuilt tarball from GitHub Releases, no compile)
|
|
28
|
-
- **GitHub Releases** — download the tarball / zip directly from
|
|
29
|
-
[the releases page](https://github.com/ai-2070/net/releases)
|
|
30
|
-
- **PyPI** — `pip install net-deck`
|
|
64
|
+
## License
|
|
31
65
|
|
|
32
|
-
|
|
33
|
-
full surface.
|
|
66
|
+
Apache-2.0.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@net-mesh/deck",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.25.0",
|
|
4
4
|
"description": "net-deck — operator cyberdeck (terminal UI) for the Net mesh",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -23,17 +23,17 @@
|
|
|
23
23
|
"LICENSE"
|
|
24
24
|
],
|
|
25
25
|
"engines": {
|
|
26
|
-
"node": ">=
|
|
26
|
+
"node": ">=20"
|
|
27
27
|
},
|
|
28
28
|
"//": "Per-platform binary packages are listed as optionalDependencies. npm fetches only the one whose `os`/`cpu`/`libc` constraints match the install host; bin/net-deck.js resolves whichever landed at runtime and execs the bundled binary.",
|
|
29
29
|
"optionalDependencies": {
|
|
30
|
-
"@net-mesh/deck-linux-x64-gnu": "0.
|
|
31
|
-
"@net-mesh/deck-linux-x64-musl": "0.
|
|
32
|
-
"@net-mesh/deck-linux-arm64-gnu": "0.
|
|
33
|
-
"@net-mesh/deck-linux-arm64-musl": "0.
|
|
34
|
-
"@net-mesh/deck-darwin-x64": "0.
|
|
35
|
-
"@net-mesh/deck-darwin-arm64": "0.
|
|
36
|
-
"@net-mesh/deck-win32-x64": "0.
|
|
37
|
-
"@net-mesh/deck-win32-arm64": "0.
|
|
30
|
+
"@net-mesh/deck-linux-x64-gnu": "0.25.0",
|
|
31
|
+
"@net-mesh/deck-linux-x64-musl": "0.25.0",
|
|
32
|
+
"@net-mesh/deck-linux-arm64-gnu": "0.25.0",
|
|
33
|
+
"@net-mesh/deck-linux-arm64-musl": "0.25.0",
|
|
34
|
+
"@net-mesh/deck-darwin-x64": "0.25.0",
|
|
35
|
+
"@net-mesh/deck-darwin-arm64": "0.25.0",
|
|
36
|
+
"@net-mesh/deck-win32-x64": "0.25.0",
|
|
37
|
+
"@net-mesh/deck-win32-arm64": "0.25.0"
|
|
38
38
|
}
|
|
39
39
|
}
|