Skip to content

ROADMAP.adoc

Latest commit

 

History

History
75 lines (62 loc) · 3.21 KB

ROADMAP.adoc

File metadata and controls

75 lines (62 loc) · 3.21 KB
Raw

Game Server Admin (GSA) Roadmap

Current State

GSA is a universal game server probe, config management, and administration tool. 96% complete (v0.9.0). Gossamer GUI + Zig FFI + Idris2 ABI + VeriSimDB backing store.

Key capabilities delivered:

  • 40 exported FFI symbols (Zig 0.15.2, libgsa.so)

  • 13 FFI modules: lifecycle, probe, config_extract, a2ml_emit, verisimdb_client, server_actions, game_profiles, groove_client, steam_client, abi_layout, abi_serde, http_capability, cli

  • Protocol fingerprinting (8 protocols, 20+ known ports)

  • Config parsing (8 formats: XML, INI, JSON, ENV, YAML, TOML, Lua, KV)

  • 18 game profiles (A2ML files in profiles/)

  • 8 Gossamer GUI panels + 9 panel clades

  • VeriSimDB on 2 ports (main 8090, backup 8091 for game saves)

  • A2ML serialisation, parsing, and config diff

  • Groove voice alerting via .well-known

  • Server actions via Podman/Docker/systemd

  • Secret redaction in A2ML output and octad JSON

  • Chainguard Wolfi containers with quadlets

  • Idris2 ABI with 18 result codes

  • Desktop entry and icon assets (SVG + PNG)

  • Steam Web API client (vanity→Steam64 resolution, player summary, ownership check)

  • Nexus Setup GUI — 7-step provisioning wizard (profile → Steam resolve → config → SSH target → file staging → provision → verify)

  • CryoFall container stack (Containerfile, Quadlet, schema-driven provisioner, self-heal watchdog)

  • HTTP capability gateway (Phase 11) — capability-scoped REST surface over the FFI

  • Illustrated wiki + reference docs (Phase 12)

  • AffineScript TEA interface (src/ui/tea/gsa_gui.affine) — any-game admin surface over the libgsa FFI, profile-registry driven

Test suites: * Zig unit tests: 94, passing * Integration tests: 41 tests, passing * Smoke tests: 5, passing * E2E smoke tests: 8/8 against live VeriSimDB * Gossamer chain: 25/25 (verified 2026-07-07 — parser gaps closed, libgossamer.so 0.3.0 built)

v0.9.0 — Phases 1-12 (Complete)

  • ✓ Core Zig FFI library (lifecycle, error buffer, result codes)

  • ✓ Protocol probe engine (fingerprinting, known ports)

  • ✓ Config extraction (8 format parsers)

  • ✓ A2ML emit and diff

  • ✓ VeriSimDB HTTP client (Zig 0.15 fetch API)

  • ✓ Server actions (start/stop/restart/logs)

  • ✓ Game profile registry and parser

  • ✓ Groove client for voice alerting

  • ✓ Gossamer GUI panels (8 panels)

  • ✓ Panel clade system (9 base + game children)

  • ✓ Idris2 ABI definitions (Types, Foreign, Layout)

  • ✓ VeriSimDB dual-instance deployment (main + backup)

v0.95.0 — Phases 13-15 (In Progress)

  • ✓ E2E test suite against live VeriSimDB

  • ✓ Gossamer integration test chain

  • ✓ Ephapax parser completion (;, zero-arg calls, lambda blocks, let!) — verified against ephapax 0.1.0, 2026-07-07

  • ❏ Bitbucket mirror setup

v1.0.0 — Stable Release

  • ✓ Gossamer chain fully green — 25/25 verified 2026-07-07 (GTK dev libs installed, libgossamer.so 0.3.0 built)

  • ❏ Bitbucket mirror active

  • ❏ OpenSSF badge

  • ❏ Full documentation pass

Future

  • Additional game profiles beyond the current 18

  • Live server monitoring dashboard

  • Multi-server fleet management