firefrost-gaming/firefrost-operations-manual
3
0
Fork 0
Code Issues 146 Pull Requests Packages Projects Releases Wiki Activity
Files
e6d652e3d2223e68da96ba4ef78db4aae9c650ca
firefrost-operations-manual/docs/architecture/STATE-OF-THE-TRINITY.md
Claude aa93e01b87 docs(architecture): Create STATE-OF-THE-TRINITY.md — canonical sync doc 
Collaborative work between Chronicler #73 and Gemini.

Contains:
- Team & AI domains (Chroniclers, Catalysts, Emissaries)
- Complete server fleet with IPs and purposes
- Arbiter 3.5.0 overview (Node.js/Express, NOT PHP)
- Task #92 MCP Gateway architecture
- Holly's toolset (Discord IDs, LuckPerms, Pokerole)
- Standard operating procedures
- Subscription tiers (SOVEREIGN not Founder)
- Quick reference section

Single source of truth for cross-lineage synchronization.
Updated Catalyst PROJECT-INSTRUCTIONS.md to read this first.

Chronicler #73 + Gemini
2026-04-09 15:06:42 +00:00

7.5 KiB
Raw Blame History

Firefrost Gaming — Universal Architecture State

Version: 1.0
Date: April 9, 2026
Authors: Chronicler #73 + Gemini (Architectural Partner)
Purpose: Core context file for AI lineage synchronization (Chroniclers, Catalysts, Emissaries)

1. The Team & AI Domains

The Trinity (Human Partners)

Partner Title Domain Location
Michael Krause The Wizard Infrastructure, backend, architecture Circle Pines, MN (Central Time)
Holly The Catalyst Discord, LuckPerms, building, Pokerole Conception Bay South, NL (+2.5 hrs)
Meg The Emissary Community, social media, member experience Circle Pines, MN (Central Time)

AI Lineages

Lineage Human Partner Domain Focus Status
Chroniclers Michael Node.js/Express backend, Linux servers, Cloudflare Workers, system architecture, API design Active (70+ instances)
Catalysts Holly Discord hierarchy, LuckPerms permissions, Minecraft building, Pokerole TTRPG Initializing
Emissaries Meg Community management, social strategy, member experience Future

The Animal Consultants

Name Title Role
Jack Chief Medical Alert Officer Alerts take ABSOLUTE PRIORITY over all work
Oscar Chief Security Officer Catahoula Leopard Dog
Butter No Nutters CEO Persian-Maine Coon
Jasmine Chief of Personal Security —
Midnight Noir Chief of Rapid Response —
Skye Director of Logistics & Transportation Holly's dog in Newfoundland

2. The Server Fleet

Core Infrastructure

Server IP Purpose Notes
Command Center 63.143.34.217 Central brain — Arbiter 3.5.0, Gitea, n8n, Uptime Kuma, Vaultwarden Dallas
Panel VPS 45.94.168.138 Pterodactyl Panel — game server management panel.firefrostgaming.com
TX1 Dallas 38.68.14.26 Wings node — game servers, FoundryVTT 251GB RAM dedicated
NC1 Charlotte 216.239.104.130 Wings node — game servers 251GB RAM dedicated
Wiki VPS 64.50.188.14 Wiki.js (ports 3100/3101/3102), Nextcloud Login: architect not root
Dev Panel 64.50.188.128 Pterodactyl 1.12.2 + Blueprint beta — development/testing Chicago
Services VPS 38.68.14.188 Mailcow email server —

Web Properties

Service URL Platform
Website firefrostgaming.com 11ty + Cloudflare Pages
Docs CMS firefrostgaming.com/admin Decap CMS
Trinity Console discord-bot.firefrostgaming.com/admin Arbiter 3.5.0
Git git.firefrostgaming.com Gitea
Panel panel.firefrostgaming.com Pterodactyl

3. Arbiter 3.5.0 (The Backend)

Location: Command Center /opt/arbiter-3.0
Stack: Node.js + Express
Database: PostgreSQL (arbiter_db)

What Arbiter Handles

Function Description
Stripe Webhooks Subscription lifecycle (create, update, cancel)
Discord Bot Commands, role management, notifications
Trinity Console Admin dashboard (7 modules)
MCP Approvals Command approval workflow (Task #92 — planned)

Key Endpoints

  • /webhooks/stripe — Stripe event processing
  • /admin/* — Trinity Console routes
  • /api/* — Internal API

Restart command: systemctl restart arbiter-3

4. The MCP Gateway (Task #92)

Codename: Trinity Core
Hardware: Dedicated HP Laptop (shelf-mode, always-on)
OS: Ubuntu Server 24.04 LTS
Status: Phase 1 — Ubuntu installation (laptop wiped, ready to install)

Architecture

Claude.ai → MCP Request → Laptop (Cloudflare Tunnel) → SSH → Firefrost Servers
                                    ↓
                          Arbiter (Discord Approval)
                                    ↓
                          Human clicks "Approve"
                                    ↓
                          Command executes

Security Model

  • Cloudflare Tunnel: No incoming ports exposed
  • Cloudflare Access: Identity verification before traffic reaches laptop
  • SSH User: claude_executor with restricted sudo (NOT root)
  • Approval Loop: Destructive commands require Discord button approval
  • Audit Trail: All commands logged

5. Holly's Toolset

Discord Credentials

DISCORD_BOT_TOKEN: [See discord-automation skill]
GUILD_ID: 1260574715546701936
DISCORD_CLIENT_ID: 1487080166969577502

Key Discord Channel IDs

Channel ID Type
general-chat 1260574716058664962 Text
announcements 1403980849686515832 Announcement
📚-guides 1491804184356454430 Forum

LuckPerms

Pokerole

  • System: Pokemon TTRPG homebrew
  • Files: pokerole-project/ repos in Gitea
  • Holly's Role: Creative authority on mechanics and campaigns

6. Standard Operating Procedures

The Approval Loop (Task #92)

  1. AI sends command via MCP
  2. MCP server webhooks to Arbiter
  3. Arbiter posts approval button in #mcp-approvals
  4. Human clicks Approve/Deny
  5. Arbiter signals MCP server
  6. Command executes (or doesn't)

Note: This is planned architecture — not yet implemented.

Continuous Logging

  • All infrastructure changes must be committed to firefrost-operations-manual
  • Major decisions require Gemini consultation
  • Cross-lineage changes should be noted in SESSION-HANDOFF-NEXT.md

No Speculative Execution

  • AIs must not execute commands outside defined permission scope
  • When uncertain, ask the human partner
  • Destructive operations always require confirmation

Free Tier Handoffs (Catalysts)

Catalysts operate on Claude's free tier with limited context:

  • Handoff EARLY and OFTEN
  • Update docs/relationship/the-catalysts/SESSION-HANDOFF.md after every significant task
  • Commit before context runs out
  • Trust the lineage — next Catalyst continues your work

7. Subscription Tiers (Branding Reference)

Tier Price Type
Awakened $1 One-time (permanent)
Elemental $5/mo Monthly
Knight $10/mo Monthly
Master $15/mo Monthly
Legend $20/mo Monthly
Sovereign $50 One-time (permanent)

CRITICAL: The top tier is SOVEREIGN, never "Founder."

Fire/Frost are branding paths only — all subscribers access all servers.

8. Quick Reference

Gitea Access

  • URL: git.firefrostgaming.com
  • Token location: Project Instructions (lineage-specific)
  • Repos: firefrost-operations-manual, firefrost-services, firefrost-website

Emergency Contacts

Key Documentation

Document Purpose
SESSION-HANDOFF-NEXT.md Current state, what to do next
DOCUMENT-INDEX.md Map of the entire operations manual
docs/standards/ All FFG standards
docs/consultations/ Gemini consultation history

9. Version History

Version Date Author Changes
1.0 April 9, 2026 Chronicler #73 + Gemini Initial creation

Fire + Frost + Foundation = Where Love Builds Legacy 💙🔥❄️

Reference in New Issue View Git Blame Copy Permalink