chore: bootstrap lean sysadmin-chronicles repo

Import the runnable game code, content, docs, scripts, and repo guidance while leaving local agent state, dependency installs, build output, and backup copies out of the published tree.
2026-05-02 11:49:07 -04:00
commit 0265afa054
252 changed files with 37574 additions and 0 deletions
@@ -0,0 +1,41 @@
+{
+  "id": "build_machine",
+  "domain": "sc-build-machine",
+  "hostname": "vulcan",
+  "distro": "arch",
+  "role": "Build/package/update quest target VM",
+  "display_name": "Build Machine (vulcan)",
+  "profile_type": "headless_server",
+  "resource_budget": {
+    "ram_mb": 384,
+    "vcpus": 2,
+    "disk_gb": 10,
+    "note": "Slightly more CPU for build tasks. Still headless."
+  },
+  "network": {
+    "mode": "quest",
+    "libvirt_network": "sc-internal",
+    "optional_outbound": "sc-pkg-mirror",
+    "note": "Selective outbound access to package mirror for update quests."
+  },
+  "ssh_user": "player",
+  "ssh_key": "~/.ssh/sc_host_key",
+  "snapshots": {
+    "baseline": "baseline.clean",
+    "recovery": "baseline.recovery",
+    "checkpoint_prefix": "checkpoint.shift-",
+    "max_checkpoints": 5
+  },
+  "guest_helper": {
+    "name": "ops-telemetry-cache",
+    "path": "/usr/local/bin/ops-telemetry-cache",
+    "trusted": false
+  },
+  "display": {
+    "type": "vnc",
+    "fallback": "spice"
+  },
+  "always_live": false,
+  "quests": ["Q006", "Q008"],
+  "note": "Arch Linux build machine. Named vulcan — the forge. Handles package/build/update quests."
+}
@@ -0,0 +1,40 @@
+{
+  "id": "web_server",
+  "domain": "sc-web-server",
+  "hostname": "hermes",
+  "distro": "debian",
+  "role": "Web/service quest target VM",
+  "display_name": "Web Server (hermes)",
+  "profile_type": "headless_server",
+  "resource_budget": {
+    "ram_mb": 256,
+    "vcpus": 1,
+    "disk_gb": 6,
+    "note": "Lightweight headless Debian server. No desktop, no graphical tools needed."
+  },
+  "network": {
+    "mode": "quest",
+    "libvirt_network": "sc-internal"
+  },
+  "ssh_user": "player",
+  "ssh_key": "~/.ssh/sc_host_key",
+  "snapshots": {
+    "baseline": "baseline.clean",
+    "recovery": "baseline.recovery",
+    "checkpoint_prefix": "checkpoint.shift-",
+    "max_checkpoints": 5
+  },
+  "guest_helper": {
+    "name": "yardd",
+    "path": "/usr/local/bin/yardd",
+    "trusted": false
+  },
+  "display": {
+    "type": "vnc",
+    "fallback": "spice",
+    "note": "VNC preferred for headless terminal. Fallback to SPICE if VNC unavailable."
+  },
+  "always_live": false,
+  "quests": ["Q002", "Q003", "Q004", "Q005", "Q007"],
+  "note": "Primary target VM for web service quests. Hosted on Debian. Named hermes after the messenger."
+}
@@ -0,0 +1,40 @@
+{
+  "id": "workstation",
+  "domain": "sc-workstation",
+  "hostname": "ares",
+  "distro": "debian",
+  "role": "Player desktop workstation with browser HUD, terminal, and SSH entry point",
+  "display_name": "Workstation (ares)",
+  "profile_type": "desktop_xfce",
+  "resource_budget": {
+    "ram_mb": 768,
+    "vcpus": 1,
+    "disk_gb": 12,
+    "note": "Lightweight XFCE desktop with Chromium HUD and Tilix terminal."
+  },
+  "network": {
+    "mode": "quest",
+    "libvirt_network": "sc-internal"
+  },
+  "ssh_user": "player",
+  "management_user": "opsbridge",
+  "ssh_key": "~/.ssh/sc_host_key",
+  "snapshots": {
+    "baseline": "baseline.day-one",
+    "recovery": "baseline.recovery",
+    "checkpoint_prefix": "checkpoint.shift-",
+    "max_checkpoints": 5
+  },
+  "guest_helper": {
+    "name": "atlas-index",
+    "path": "/usr/local/bin/atlas-index",
+    "trusted": false
+  },
+  "display": {
+    "type": "spice",
+    "video": "virtio",
+    "note": "Player uses the real XFCE workstation desktop through SPICE with virtio video. QXL is available as the spice-qxl build mode for compatibility testing."
+  },
+  "always_live": true,
+  "note": "The workstation VM stays live during gameplay. The browser opens the host-served HUD and Tilix provides real terminal access to the lab VMs."
+}