docs(reference): import Dune: Awakening server-manager references
All checks were successful
CI / backend-types (push) Successful in 10s
CI / frontend-build (push) Successful in 15s
CI / agent-tests (push) Successful in 39s
CI / integration (push) Successful in 22s

Phase 2 references for the host-agent Dune adapter, moved out of volatile /tmp
into docs/reference-repos/ (per Commander). Three upstream projects, .git +
node_modules + compiled binaries stripped (16MB source). Nested AI-instruction
files (.claude/, CLAUDE.md) removed so they don't pollute Corrosion sessions.

- icehunter/    dune-admin (Go+React) — 4 control planes; SETUP_DOCKER.md is the
                closest analog to our agent's Dune docker control plane (compose
                lifecycle, docker logs, RabbitMQ-via-exec, dune Postgres schema)
- adainrivers/  Rust/Tauri desktop — SSH+k8s BattleGroup control, maintenance
                daemon, in-game admin console (Rust idiom reference)
- the4rchangel/ Node web UI replacing battlegroup.bat — matches the Commander's
                Hyper-V self-host path + game-config schema

See docs/reference-repos/README.md for the full index + how we use each.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Vantz Stockwell
2026-06-11 21:08:05 -04:00
parent 0715492ddf
commit 651a35d4be
1334 changed files with 238971 additions and 0 deletions

View File

@@ -0,0 +1,78 @@
# Building From Source
## Prerequisites
- Rust stable
- Node.js 22
- npm
- Git
Platform-specific desktop dependencies:
- Windows: WebView2 runtime
- Linux: WebKitGTK 4.1, AppIndicator, librsvg, patchelf, pkg-config, and OpenSSL development headers
- macOS: Xcode Command Line Tools
On Ubuntu 22.04, install the Linux desktop build dependencies with:
```bash
sudo apt-get update
sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf pkg-config libssl-dev
```
## Install Frontend Dependencies
```bash
cd app
npm ci
```
## Run Checks
```bash
cargo check --workspace
cargo test --workspace
cargo doc -p dune-manager-core --no-deps
cd app
npm run build
```
## Run In Development
```bash
cd app
npm run tauri -- dev
```
On Linux the app sets `WEBKIT_DISABLE_DMABUF_RENDERER=1` automatically to avoid
a WebKitGTK 4.1 crash on GNOME Wayland (`Error 71 dispatching to Wayland
display`). Export the variable yourself with a different value to override.
## Build A Local Production App
For a local production executable without updater signing or release bundling:
```bash
cd app
npm run tauri -- build --no-bundle
```
The executable is written under the workspace `target/release` directory.
## Build Installers
Release packaging is normally handled by GitHub Actions when a version tag is
pushed. Local full packaging may require platform-specific signing or installer
setup.
Common local bundle commands:
```bash
cd app
npm run tauri -- build --bundles nsis
npm run tauri -- build --bundles appimage,deb
npm run tauri -- build --bundles dmg
```
The app manages already-provisioned servers only. Building from source does not
add any server setup, provisioning, Hyper-V, or installer workflow to the app.

File diff suppressed because it is too large Load Diff