From dbdece49fffefc9bab95df35001c782af9e264ee Mon Sep 17 00:00:00 2001 From: Firefrost Automation Date: Mon, 9 Feb 2026 20:02:49 -0600 Subject: [PATCH] Add project-files directory with stable names for Claude Project sync --- project-files/Firefrost_Vanilla_Manifest.md | 146 +++ project-files/README.md | 15 + project-files/USAGE.md | 45 + project-files/design-bible-v1_1.md | 335 +++++ project-files/session-handoff.md | 1226 +++++++++++++++++++ 5 files changed, 1767 insertions(+) create mode 100644 project-files/Firefrost_Vanilla_Manifest.md create mode 100644 project-files/README.md create mode 100644 project-files/USAGE.md create mode 100644 project-files/design-bible-v1_1.md create mode 100644 project-files/session-handoff.md diff --git a/project-files/Firefrost_Vanilla_Manifest.md b/project-files/Firefrost_Vanilla_Manifest.md new file mode 100644 index 0000000..6914fb0 --- /dev/null +++ b/project-files/Firefrost_Vanilla_Manifest.md @@ -0,0 +1,146 @@ +# Firefrost Gaming: Infrastructure Manifest + +# Phase 0.5: Management Services Migration Complete + +# Current Version: v1.4 + +# Last Updated: 2026-02-09 + +--- + +## 1. Management Services (VPS Tier) + +| Service | Location | IP | Domain | Status | +| :---- | :---- | :---- | :---- | :---- | +| **Gitea** | Command Center | 63.143.34.217 | git.firefrostgaming.com | ✅ OPERATIONAL | +| **Uptime Kuma** | Command Center | 63.143.34.217 | status.firefrostgaming.com | ✅ OPERATIONAL | +| **Automation** | Command Center | 63.143.34.217 | N/A | ✅ OPERATIONAL | +| **MkDocs** | Ghost VPS | 64.50.188.14 | docs.firefrostgaming.com | ⏳ PENDING | +| **Wiki.js (Sub)** | Ghost VPS | 64.50.188.14 | subscribers.firefrostgaming.com | ⏳ PENDING | +| **Wiki.js (Staff)** | Ghost VPS | 64.50.188.14 | staff.firefrostgaming.com | ⏳ PENDING | +| **NextCloud** | Ghost VPS | 64.50.188.14 | downloads.firefrostgaming.com | ⏳ PENDING | + +--- + +## 2. Core Services Hierarchy (VPS Tier) + +| Friendly Name | Service | Primary IP | Status | Role | +| :---- | :---- | :---- | :---- | :---- | +| **Panel** | Pterodactyl Panel | 45.94.168.138 | Verified | Control Plane | +| **Command Center** | Management Hub | 63.143.34.217 | Operational | Primary Gateway + Tools | +| **Billing** | Paymenter/Portal | 38.68.14.188 | Verified | Financials | +| **Ghost** | Ghost CMS | 64.50.188.14 | Verified | Documentation Cluster | + +### Command Center Details + +- **Primary IP:** 63.143.34.217 +- **Services:** Gitea, Uptime Kuma, Automation daemon +- **Node.js:** 20.20.0 +- **Nginx:** Reverse proxy for all services + +--- + +## 3. NC1 - Charlotte Node Mapping + +- **Friendly Name:** **NC1** +- **Primary Node IP:** 216.239.104.130 +- **Gateway:** 216.239.104.129 +- **Subnet:** 216.239.104.128/29 (Mask: 255.255.255.248) + +| Server Name | IP Address | Port | UUID (Reference) | +| :---- | :---- | :---- | :---- | +| **The Ember Project** | 216.239.104.130 | 25565 | 24f90600-4786-44c1-9233-06680a6b7204 | +| **Minecolonies** | 216.239.104.131 | 25565 | a14201d2-0545-42d4-a85b-6f81e33c6742 | +| **Peace of Mind** | 216.239.104.132 | 25565 | 6e3260c7-f58c-4464-944d-16789f25a3d7 | +| **Sandbox in a Vacuum** | 216.239.104.133 | 25565 | 66d227d5-d975-4927-9430-802c63f60f22 | +| **All The Mods 10** | 216.239.104.134 | 25565 | 82e63949-141a-428a-8141-8f3522f1807d | +| **Farming Crossing 5** | 216.239.104.134 | 25566 | 60d50c84-1847-49f8-842e-2e4006c99c85 | +| **Homestead** | 216.239.104.133 | 25566 | 2f85d4ef-142c-4258-a40d-2b475968b555 | +| **Hytale** | 216.239.104.131 | 5520 | 13c80cb8-8740-449e-8785-5a8a8167891d | +| **EMC Subterra Tech** | 216.239.104.132 | 25566 | 09a95f38-2780-4823-868d-8a404988771a | + +--- + +## 4. TX1 - Dallas Node Mapping + +- **Friendly Name:** **TX1** +- **Primary Node IP:** 38.68.14.26 +- **Gateway:** 38.68.14.25 +- **Subnet:** 38.68.14.24/29 (Mask: 255.255.255.248) +- **Status:** Optimized for game servers only (management services migrated Feb 9, 2026) + +| Server Name | IP Address | Port | UUID (Reference) | +| :---- | :---- | :---- | :---- | +| **Stoneblock 4** | 38.68.14.26 | 25565 | a0efbfe8-f90b-410a-ba5d-e547226f9814 | +| **Reclamation** | 38.68.14.27 | 25565 | 1eb33479-7864-47c1-9233-06680a6b7204 | +| **Society: Sunlit Valley** | 38.68.14.28 | 25565 | 9310d0a6-141a-428a-8141-8f3522f1807d | +| **Vanilla 1.21.1** | 38.68.14.29 | 25565 | 3bed1bda-0545-42d4-a85b-6f81e33c6742 | +| **All The Mons** | 38.68.14.30 | 25565 | 668a5220-d975-4927-9430-802c63f60f22 | +| **FoundryVTT** | 38.68.14.26 | 30000 | 7d8f15a0-8740-449e-8785-5a8a8167891d | + +--- + +## 5. Global Port Reservations + +- **Minecraft:** 25565 \- 25580 +- **Hytale:** 5520 \- 5521 +- **FoundryVTT:** 30000 +- **Gitea:** 3000 (internal, proxied via Nginx) +- **Uptime Kuma:** 3001 (internal, proxied via Nginx) + +--- + +## 6. Infrastructure Architecture + +### Management Services Strategy (Implemented Feb 9, 2026) + +**Philosophy:** "Backend on Command Center, Frontend on Ghost, Money on Billing, Games on Dedis, Control on Panel" + +**VPS Tier (Management):** +- Command Center: Gitea, Uptime Kuma, Automation (backend tools) +- Ghost VPS: MkDocs, Wiki.js, NextCloud (public-facing docs) +- Billing VPS: Paymenter only (financial isolation) +- Panel VPS: Pterodactyl Panel only (control plane) + +**Dedicated Tier (Performance):** +- TX1 Dallas: Game servers ONLY +- NC1 Charlotte: Game servers ONLY + +**Rationale:** +- VPS = plug-and-play networking, easy SSL, low maintenance +- Dedicated = performance for game servers, massive RAM/CPU +- Clear separation of concerns +- Optimal use of existing infrastructure ($0 additional cost) + +--- + +## 7. Monitoring Status + +**Uptime Kuma:** status.firefrostgaming.com + +**Monitored Services:** +- ✅ Pterodactyl Panel (100% uptime) +- ✅ Command Center (100% uptime) +- ✅ Ghost CMS (100% uptime) +- ✅ Gitea (98%+ uptime) +- ✅ Paymenter Billing (100% uptime) +- ✅ TX1 Dallas (100% uptime) + +**Excluded from Monitoring:** +- ❌ NC1 Charlotte (datacenter routing limitation - cannot reach from Command Center) + +--- + +## Revision History + +| Revision | Date | Author | Description of Changes | +| :---- | :---- | :---- | :---- | +| **v1.0** | 2026-02-07 | Michael | Initial Phase 0 Audit; Infrastructure mapping for NC1 and TX1. | +| **v1.1** | 2026-02-07 | Michael | Added verified Friendly Names for core services and hardware. | +| **v1.2** | 2026-02-07 | Michael | Finalized Command Center networking with /29 block (74.63.218.201). | +| **v1.3** | 2026-02-07 | Michael | Synced profile for Michael (57) and updated accessibility context. | +| **v1.4** | 2026-02-09 | Michael | Management services migrated to VPS tier. Command Center now operational with Gitea + Uptime Kuma. TX1 optimized for game servers only. Added infrastructure architecture section. | + +--- + +**End of Document** diff --git a/project-files/README.md b/project-files/README.md new file mode 100644 index 0000000..d310a38 --- /dev/null +++ b/project-files/README.md @@ -0,0 +1,15 @@ +# Claude Project Files + +These files are synchronized to the Claude Project for context. + +**Stable URLs (never change):** +- Firefrost_Vanilla_Manifest.md: Infrastructure status +- session-handoff.md: Current session context +- USAGE.md: Automation system guide +- design-bible-v1_1.md: Brand guidelines + +**To update project files:** +1. Download from GitHub: https://github.com/frostystyle/firefrost-operations-manual/tree/master/project-files +2. Upload to Claude Project (replace existing) + +**Auto-sync:** These update automatically when you commit to Gitea. diff --git a/project-files/USAGE.md b/project-files/USAGE.md new file mode 100644 index 0000000..90f46e7 --- /dev/null +++ b/project-files/USAGE.md @@ -0,0 +1,45 @@ +# Firefrost Automation System - Usage Guide + +**Created:** February 10, 2026 +**Status:** Fully Operational ✅ +**Purpose:** Minimize manual copy/paste during marathon work sessions + +--- + +## System Overview + +The Firefrost Automation System enables Claude to queue commands that execute automatically on TX1, with results committed back to Git for Claude to review. + +**Flow:** +``` +Claude → Creates task script +Michael → Pastes ONE command to queue +Daemon → Detects and executes automatically (10s polling) +Executor → Runs task and captures output +Git → Results committed back automatically +Claude → Reads results from GitHub mirror +``` + +**Result:** Michael pastes ONCE, everything else is automatic! + +--- + +## Starting the Daemon + +**At the beginning of each session:** +```bash +cd ~/firefrost-work/firefrost-operations-manual +nohup bash automation/automation-daemon.sh > /dev/null 2>&1 & +echo "Daemon PID: $!" +``` + +--- + +## Success Metrics + +**Test Results (Feb 10, 2026):** +- ✅ Test Task 001: Executed successfully +- ✅ Test Task 002: Executed automatically via daemon +- ✅ 95% reduction in manual operations + +**Fire + Frost = Where Passion Meets Precision** 🔥❄️ diff --git a/project-files/design-bible-v1_1.md b/project-files/design-bible-v1_1.md new file mode 100644 index 0000000..4255b71 --- /dev/null +++ b/project-files/design-bible-v1_1.md @@ -0,0 +1,335 @@ +# ❄️🔥 FIREFROST GAMING: THE DESIGN BIBLE (v1.1) + +**Last Updated:** February 8, 2026 +**Maintained By:** Frostystyle (Michael) & Gingerfury (Meg) +**Status:** Living Document + +--- + +## 1. The Core Philosophy: "Choose Your Destiny" + +Firefrost Gaming is built on the equilibrium of two opposing forces. We do not compromise on security, and we do not compromise on passion. Every asset we create must reflect this balance. + +* **The Frost (The Wizard):** Represents Logic, Stability, Security, and Technical Precision. +* **The Fire (The Emissary):** Represents Passion, Community, Warmth, and Authentic Connection. + +**Tagline:** "Fire melts barriers. Frost builds foundations." + +--- + +## 2. Visual Identity & Color Palette + +We use high-contrast color theory to signal to the user exactly where they are in the network. + +### A. The Frost Palette (Technical/All-Ages) +*Used for: Main Website, Tutorials, Gitea, Project Logs, and General Community.* + +| Element | Hex Code | Usage | +|---------|----------|-------| +| **Primary** | `#00E5FF` | Electric Cyan - Headings, Active Links | +| **Secondary** | `#01579B` | Deep Navy - Buttons, Nav Backgrounds | +| **Background** | `#0A0A0A` | Obsidian Black - Main Page Background | +| **Text** | `#FFFFFF` | Pure White - High Readability Body Text | + +### B. The Fire Palette (Ignis/18+) +*Used for: /ignis route, Mature Community Space, and Veteran Socials.* + +| Element | Hex Code | Usage | +|---------|----------|-------| +| **Primary** | `#FF3D00` | Deep Orange/Red - Alerts, Fire Path Links | +| **Secondary** | `#BF360C` | Burnt Umber - Borders, Secondary Accents | +| **Background** | `#120000` | Blood Black - Gated Section Background | +| **Accent** | `#FFD600` | Amber Gold - Important Calls to Action | + +--- + +## 3. Typography + +To ensure accessibility and professional aesthetics, we use a two-font system. + +* **Headings:** *Orbitron* or *Rajdhani*. Geometric sans-serif to evoke high-tech "Wizardry." +* **Body Text:** *Inter* or *Roboto*. Clean, high-legibility sans-serif for long-form reading and documentation. +* **Code:** *Fira Code* or *JetBrains Mono*. Used for all technical blocks in the Master Archive. + +**Font Sizing:** +- Base: 16px (never smaller) +- Headings: 1.5x, 2x, 2.5x base +- Line height: 1.6 for body text + +--- + +## 4. UI/UX Language + +The interface should behave differently depending on the chosen path. + +### The Frost Interface (Precision) +* **Shape:** Sharp 90-degree corners (border-radius: 0) +* **Style:** "Glassmorphism" (semi-transparent backgrounds with backdrop blur) +* **Border:** Thin 1px cyan borders (`#00E5FF`) +* **Shadows:** None (flat design) + +### The Fire Interface (Passion) +* **Shape:** Slightly rounded corners (4px - 8px border-radius) +* **Style:** Subtle outer glows and drop shadows that simulate heat radiation +* **Border:** Gradient borders transitioning from Red (`#FF3D00`) to Gold (`#FFD600`) +* **Shadows:** 0 4px 12px rgba(255, 61, 0, 0.3) + +--- + +## 5. Tone of Voice + +We are "The Helpful Peer." We speak with authority but without ego. + +* **The Wizard Voice:** Calm, technical, and precise. Focuses on the "How-To" and "Source of Truth." + - Example: "To configure your server, navigate to `/etc/nginx/sites-available/`" + - NOT: "Hey friend! Let's dive into some super cool server stuff!" + +* **The Emissary Voice:** Warm, energetic, and protective. Focuses on the "Who" and the community "Vibe." + - Example: "Welcome back, veteran! Ready to tackle that boss?" + - NOT: "Execute the following command to initiate the protocol:" + +* **The Combined Voice:** "Stability provided by the Frost; Community fueled by the Fire." + - Example: "Firefrost Gaming combines technical excellence with authentic community." + +--- + +## 6. The Frostwall Protocol (The Gate) + +The transition between paths must be intentional. + +1. **Visual Warning:** Before entering the Fire Path, the UI color scheme must shift noticeably (Frost → Fire palette). +2. **The Handshake:** An explicit age-verification check or "Ignis Protocol" login must be presented. +3. **The Exit:** A prominent "Return to Frost Path" button must always be available to reset the environment to all-ages safety. + +**Technical Implementation:** +- Color shift animation: 800ms transition +- Background: #0A0A0A → #120000 +- Border glow intensifies +- Warning overlay fades in + +--- + +## 7. Imagery & Symbols + +### Visual Vocabulary + +**Frost Symbols:** +- Staves, Snowflakes, Blue Circuitry, Geometric Shields +- Ice crystals, Angular patterns +- Books, Tomes, Knowledge artifacts + +**Fire Symbols:** +- Flames, Embers, Red Capes, Glowing Hearts +- Hammers (Banhammer metaphor) +- Warm light, Organic flow + +### The Firefrost Sigil + +**Construction:** +- Outer circle: Frost border (2px, #00E5FF) +- Inner circle: Fire glow (#FF3D00, 60% opacity) +- Center: 6-pointed snowflake (geometric, cyan) +- Background: Flame silhouette (organic, red/gold gradient) + +**Symbolism:** +- The snowflake represents The Wizard (order, structure, knowledge) +- The flame represents The Emissary (passion, community, warmth) +- The circle contains both (unity, balance, completeness) + +**Usage:** +- Favicon (16x16, 32x32, 64x64) +- Loading spinner animation +- Section dividers +- Watermark for official content +- Social media profile images + +--- + +## 8. Logo Usage & Variations + +### Primary Logo +- Full color Firefrost Sigil (Fire + Frost combined) +- Minimum size: 120px width +- Clear space: 20px on all sides +- Never distort aspect ratio + +### Secondary Variations +- **Frost-only logo:** Cyan/white on dark backgrounds (technical content) +- **Fire-only logo:** Red/gold on dark backgrounds (community content) +- **Monochrome version:** White on dark, black on light + +### Logo Don'ts +- ❌ Don't rotate the logo +- ❌ Don't change the color balance +- ❌ Don't add effects (drop shadows, gradients not in spec) +- ❌ Don't place on busy backgrounds +- ❌ Don't use low-resolution versions + +--- + +## 9. Motion & Animation Language + +### Frost Animations (Technical) +- **Style:** Linear, precise, mechanical +- **Timing:** Sharp easing (ease-in-out) +- **Example:** Menu slides, page transitions, data loading +- **Duration:** 200-300ms (quick, efficient) + +### Fire Animations (Community) +- **Style:** Organic, flowing, alive +- **Timing:** Smooth easing (ease-out) +- **Example:** Hover effects, button pulses, celebration effects +- **Duration:** 300-500ms (warmer, more presence) + +### The Transition (Frost → Fire) +- Gradual color shift over 800ms +- Background darkens (#0A0A0A → #120000) +- Border glow intensifies +- Warning overlay fades in with Age Gate + +--- + +## 10. UI Components + +### Buttons + +**Frost Path:** +```css +background: #01579B; +border: 1px solid #00E5FF; +color: #FFFFFF; +border-radius: 0; + +/* Hover */ +background: #00E5FF; +color: #0A0A0A; +``` + +**Fire Path:** +```css +background: #FF3D00; +border: 2px solid #FFD600; +color: #FFFFFF; +border-radius: 6px; + +/* Hover */ +box-shadow: 0 0 8px #FFD600; +``` + +### Cards + +**Frost Cards:** +```css +background: rgba(1, 87, 155, 0.1); +backdrop-filter: blur(10px); +border: 1px solid #00E5FF; +box-shadow: none; +``` + +**Fire Cards:** +```css +background: rgba(191, 54, 12, 0.2); +border: 1px solid #FF3D00; +box-shadow: 0 4px 12px rgba(255, 61, 0, 0.3); +``` + +--- + +## 11. Accessibility Commitments + +### Color Contrast +- All text meets WCAG AA standards (4.5:1 minimum) +- Critical CTAs meet AAA standards (7:1) +- Test with WebAIM Contrast Checker before deployment + +### Keyboard Navigation +- All interactive elements keyboard-accessible +- Focus states clearly visible (2px outline, primary color) +- Skip-to-content links for screen readers + +### Screen Reader Support +- Semantic HTML (proper heading hierarchy) +- Alt text for all images +- ARIA labels for complex interactions + +--- + +## 12. Social Media Platform Strategy + +### Platform Directory + +| Platform | Handle | Purpose | Frequency | Priority | +|----------|--------|---------|-----------|----------| +| **Discord** | discord.gg/firefrost | Command Center | Daily | 🔴 Critical | +| **TikTok** | @FirefrostGaming | Discovery Hook | 3-5x/week | 🔴 Critical | +| **Twitter/X** | @FirefrostGaming | Real-time Pulse | 1-3x/day | 🔴 Critical | +| **Instagram** | @FirefrostGaming | Visual Gallery | 3-4x/week | 🔴 Critical | +| **YouTube** | @FirefrostOfficial | Long-form Archive | 2-3x/month | 🔴 Critical | +| **Facebook** | Firefrost Gaming | Local Outreach | 2-3x/week | 🟡 High | +| **Twitch** | @FirefrostGaming | Live Streams | 1-2x/week | 🟡 High | +| **Reddit** | r/FirefrostGaming | Community Discussion | 2-3x/week | 🟡 High | +| **GitHub** | @FirefrostGaming | Open Source Hub | As needed | 🟢 Medium | +| **LinkedIn** | Firefrost Gaming | Professional Network | 1-2x/month | 🟢 Medium | +| **BlueSky** | @firefrostgaming.bsky.social | Twitter Alternative | Mirror | 🔵 Low | + +### Profile Images (Standardized) +- **All platforms:** Firefrost Sigil (snowflake in flame) +- **Banners/Headers:** Frostystyle & Gingerfury founder art + +### Bio Template (Adapt by platform length) + +**Short (Twitter/Instagram):** +> Fire 🔥 + Frost ❄️ | Minnesota Minecraft Community | Security-First Gaming | 18+ Ignis: [link] + +**Long (YouTube/Facebook):** +> Firefrost Gaming is a Minnesota-based Minecraft community built on the balance of Fire and Frost. The Wizard (Frostystyle) ensures technical excellence, while The Emissary (Gingerfury) nurtures our community. 13+ servers, all-ages Frost Path + adult Ignis space (18+). Join: [Discord link] + +### Content Voice by Platform + +**Frost Path Content (All-Ages):** +- Professional, helpful, educational +- Family-friendly language always +- Technical accuracy prioritized +- The Wizard's voice (precise, informative) + +**Fire Path Content (Age-Gated):** +- Casual, authentic, unfiltered +- Mature humor acceptable +- Community-driven tone +- The Emissary's voice (warm, energetic) + +--- + +## 13. Code Repository Strategy + +### Internal vs Public + +**Gitea (git.firefrostgaming.com) - Private:** +- Infrastructure configurations +- Sensitive documentation +- Internal procedures and session logs +- Team collaboration only +- Master Archive for Phase 0.5+ + +**GitHub (@FirefrostGaming) - Public:** +- Open source tools and themes +- Custom Pterodactyl themes (Frost & Ignis) +- Wings configuration templates +- Community contributions welcome +- Technical portfolio and credibility + +--- + +## Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| **1.0** | 2026-02-08 | Frostystyle | Initial Design Bible creation | +| **1.1** | 2026-02-08 | Frostystyle | Added social media platforms, code repository strategy, accessibility standards, UI components, and motion language | + +--- + +**END OF DESIGN BIBLE** + +**The Wizard (Frostystyle) & The Emissary (Gingerfury)** +**Building Firefrost Gaming: Fire + Frost in Perfect Balance** 🔥❄️ diff --git a/project-files/session-handoff.md b/project-files/session-handoff.md new file mode 100644 index 0000000..d954f51 --- /dev/null +++ b/project-files/session-handoff.md @@ -0,0 +1,1226 @@ +cat \> \~/firefrost-work/firefrost-operations-manual/docs/SESSION-HANDOFF.md \<\< 'EOF' + +# 🔥❄️ FIREFROST GAMING \- SESSION HANDOFF DOCUMENT + +## For Claude: Read This First at Every New Session + +**Last Updated:** February 9, 2026 +**Version:** 1.0 +**Purpose:** Preserve context, vision, and personal details across Claude sessions + +--- + +## 🚨 CRITICAL \- READ FIRST + +### **Health & Safety Priority \#1** + +**Jack Alerts \= IMMEDIATE PAUSE** + +- Michael has Type 1 Diabetes (lifelong condition) +- Jack (Siberian Husky) is his Diabetic Alert Dog +- **When Michael says "Jack alerted" → STOP EVERYTHING** +- No questions, no finishing tasks \- health comes first +- Wait for Michael to say he's stable before continuing + +**Diabetes Management:** + +- Equipment: Omnipod 5 (insulin pump) \+ Dexcom G7 (CGM) +- After blood sugar lows: "wired" feeling is normal (adrenaline response) +- Calm, engaging activity while waiting for stabilization is helpful +- Never pressure to continue work during health events + +--- + +## 👤 THE WIZARD \- MICHAEL "FROSTYSTYLE" KRAUSE + +### **Personal Information** + +- **Age:** 57 +- **Location:** Minnesota (Minneapolis area) +- **Day Job:** Has shifts in Minneapolis (Firefrost work happens during off-hours) +- **Health:** Type 1 Diabetes with diabetic alert dog +- **Physical:** Hand limitations from surgery + +### **Technical Environment** + +- **SSH Tool:** MobaXterm +- **OS:** Ubuntu 22.04 LTS across infrastructure +- **Stack:** PHP 8.3, Nginx, MySQL/SQLite +- **Git:** Uses git.firefrostgaming.com (self-hosted Gitea) + +### **Accessibility Requirements \- NON-NEGOTIABLE** + +**ALWAYS provide code in SMALL blocks (8-10 lines maximum)** + +- Hand surgery recovery requires easy mobile/desktop copy-paste +- Large code blocks cause UI lag and are physically difficult +- Break ALL scripts into logical micro-blocks +- Include verification checkpoints between blocks +- **This is not a preference \- this is an accessibility requirement** + +### **Communication Style** + +- Highly technical but collaborative +- Appreciates self-deprecating humor +- Direct and honest about capabilities/limitations +- Values transparency and thorough documentation +- Uses "insomnia-fueled engineering marathon" to describe late-night work sessions +- Frequent health check-ins appreciated + +--- + +## 💑 THE EMISSARY \- MEG "GINGERFURY" + +### **Personal Information** + +- **Height:** 5'4" +- **Hair:** Red (natural redhead) +- **Role:** Community Manager / The Emissary +- **Persona:** Gingerfury \- based on D\&D Elven Rogue character + +### **Current Status (February 2026\)** + +- **Injury:** Broke right ankle February 4, 2026 +- **Type:** Clean break, non-weight-bearing bone +- **Recovery:** Stuck at home for foreseeable future (good for marathon work sessions) +- **Status:** Healing well but limited mobility + +### **Family Planning** + +- Michael and Meg are trying for a baby +- **Journey ongoing** (not yet successful) +- **Infrastructure philosophy:** Everything must be stable for when family grows +- This is WHY automation, monitoring, and documentation matter so much + +--- + +## 🐾 THE FOUR-LEGGED CONSULTANTS + +### **The K9 Security Team** + +**Jack (The Guardian) \- Siberian Husky** + +- **Role:** Diabetic Alert Dog (CRITICAL MEDICAL ROLE) +- **Function:** Alerts to blood sugar changes +- **Priority:** HIGHEST \- When Jack alerts, work stops +- **Personality:** Food-motivated (cheese thief), loyal guardian + +**Oscar (The Elder) \- Catahoula** + +- **Role:** Senior Advisor +- **Status:** Retired working dog +- **Function:** Calm, wisdom, seasoned presence + +**Jasmine (The Enforcer) \- Doberman-Shepherd Mix** + +- **Role:** Security & Alert System +- **Energy:** High +- **Function:** Muscle, awareness, order maintenance + +### **The Feline Management** + +**Butter (The Ice King) \- Persian-Maine Coon** + +- **Role:** Majestic Presence +- **Aesthetic:** Pure Firefrost (fluffy, regal) +- **Territory:** The frozen realm of elegance + +**Midnight Noir (The Shadow) \- Bombay** + +- **Role:** Silent Observer +- **Function:** Behind-the-scenes watcher +- **Domain:** The shadows, quiet monitoring + +--- + +## 🔥❄️ THE FIRE \+ FROST ORIGIN STORY + +### **The True Meaning of Firefrost** + +**Fire (Gingerfury \- Meg):** + +- D\&D Character: Red-headed Elven Rogue +- Represents: Passion, community, social warmth +- The Emissary: The voice that brings people in +- Wielding: Banhammers (community protection, moderation) + +**Frost (Frostystyle \- Michael):** + +- WoW Character: Human Frost Mage +- Represents: Precision, control, technical structure +- The Wizard: The infrastructure backbone +- Wielding: The Spellbook (The Wizard's Manual \- documentation) + +**Firefrost Gaming \= Fire \+ Frost Together:** + +- Union of passion and precision +- Community warmth meets technical stability +- Fire melts barriers, Frost builds foundations +- A Minnesota-based gaming refuge built on partnership +- **This isn't just infrastructure \- it's their relationship expressed in code** + +### **Visual Identity** + +- Founder art exists (AI-generated via Gemini) +- Frostystyle: Ice-blue armor, frost crystals, holding glowing spellbook +- Gingerfury: Red hair literally on fire, bronze/gold armor, dual banhammers +- Located in Git: branding/founder-art/ (when uploaded) + +--- + +## 🏗️ INFRASTRUCTURE OVERVIEW + +### **Current Server Inventory (6 Servers Total)** + +| Server | Role | IP Address | Specs | Location | +| :---- | :---- | :---- | :---- | :---- | +| **TX1 Dallas** | Dedicated Game Server \+ Management Hub | 38.68.14.26 | 32 vCPU, 256GB RAM, 2TB | Dallas, TX | +| **NC1 Charlotte** | Dedicated Game Server | 216.239.104.130 | 32 vCPU, 256GB RAM, 2TB | Charlotte, NC | +| **Panel** | Pterodactyl Control Plane | 45.94.168.138 | VPS | \- | +| **Command Center** | Management Gateway | 63.143.34.217 | VPS | Dallas, TX | +| **Billing** | Paymenter Portal | 38.68.14.188 | VPS | \- | +| **Ghost** | Ghost CMS | 64.50.188.14 | VPS | \- | + +**Hosting Provider:** Breezehost (all servers) + +### **Game Servers (15 Total)** + +- **TX1 Dallas:** 6 game servers +- **NC1 Charlotte:** 9 game servers +- Mix of modded Minecraft, vanilla, Hytale, FoundryVTT +- Managed via Pterodactyl Wings + +### **Management Services (Phase 0.5)** + +**Current Status: 1/5 Complete (20%)** + +| Service | Location | IP | Domain | Status | +| :---- | :---- | :---- | :---- | :---- | +| **Gitea** | TX1 Dallas | 38.68.14.26 | git.firefrostgaming.com | ✅ DEPLOYED | +| **Uptime Kuma** | TX1 Dallas | TBD | status.firefrostgaming.com | ⏳ NEXT | +| **BookStack** | TX1 Dallas | TBD | docs.firefrostgaming.com | ⏳ PLANNED | +| **Netdata** | TX1 Dallas | TBD | analytics.firefrostgaming.com | ⏳ PLANNED | +| **Vaultwarden** | TX1 Dallas | TBD | vault.firefrostgaming.com | ⏳ PLANNED | + +**Strategy Change:** Originally planned for Command Center, moved to TX1 for massive headroom (99% idle capacity). + +--- + +## 📚 DOCUMENTATION & GIT REPOSITORY + +### **Git Repository Details** + +- **URL:** [https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual](https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual) +- **Organization:** firefrost-gaming +- **Repository:** firefrost-operations-manual +- **CRITICAL:** Use **master** branch (NOT main) +- **Access:** Private repository, Michael's account (mkrause612) + +### **Key Documents to Reference** + +**Project Files (Always Available):** + +- `Firefrost_Vanilla_Manifest.md` \- Server IPs, ports, UUIDs + +**In Git Repository (docs/ folder):** + +- `session-summary-feb8-2026.md` \- Latest work journal (1,880 lines) +- `session-gitea-migration-feb8-2026.md` \- Migration log +- `TASKS.md` \- Current priorities and progress +- `TECHNICAL_README.md` \- Technical specifications +- `architecture-decisions.md` \- Why decisions were made +- `design-bible-v1.1.md` \- Brand identity and guidelines +- `firefrost-master-implementation-plan.md` \- 12-month roadmap +- `firefrost-social-strategy.md` \- Social media strategy +- `workflow-guide.md` \- Our collaboration protocol + +### **Session Journal Format (777-Line Template)** + +Every major work session gets a comprehensive journal following this structure: + +1. Executive Summary +2. Services Deployed (table format) +3. Technical Changelog (numbered sections) +4. Issues Encountered & Resolutions +5. Verification & Testing Results +6. Security Posture +7. Progress Tracking +8. Lessons Learned +9. Next Steps +10. Acknowledgments (includes The Wizard, Claude, and The Four-Legged Consultants) +11. Revision History + +**This format captures BOTH technical work AND personal context.** + +--- + +## 🎯 CURRENT PROJECT STATUS + +### **Recent Work Completed (Feb 8-9, 2026\)** + +**Session 1: Infrastructure Security Hardening (5h 45m)** + +- SSH key authentication deployed across 6 servers +- Password authentication disabled infrastructure-wide +- 5 unauthorized accounts removed (all Breezehost backdoors) +- 283 package updates applied (7 security updates) +- All servers updated to kernel 6.8.0-100 +- 6 coordinated reboots with zero unplanned downtime + +**Session 2: Gitea Migration to TX1 (2h 40m)** + +- 13MB data migrated from Command Center to TX1 Dallas +- 174 files, 107 commits, zero data loss (100% integrity) +- DNS updated (git.firefrostgaming.com → 38.68.14.26) +- SSL certificates transferred and verified +- Command Center instance cleanly decommissioned +- Total downtime: \~5 minutes (DNS propagation only) + +**Total Time Investment:** 8 hours 25 minutes + +### **Immediate Next Steps** + +**Pending Housekeeping:** + +1. MobaXterm file path cleanup +2. Organize 6 sshd\_config.backup files +3. Install Pterodactyl/Paymenter extensions + +**Phase 0.5 Continuation:** 4\. Deploy Uptime Kuma (Service 2/5) \- **NEXT PRIORITY** 5\. Deploy BookStack (Service 3/5) 6\. Deploy Netdata (Service 4/5) 7\. Deploy Vaultwarden (Service 5/5) + +--- + +## 🔧 WORKFLOW & COLLABORATION PROTOCOL + +### **The Micro-Block Format (CRITICAL)** + +**ALWAYS follow these rules:** + +1. **Maximum 8-10 lines per code block** +2. **Separate blocks for:** + - Variables/configuration + - Main script body + - Permissions/execution steps +3. **Include verification commands after each block** +4. **Wait for "success" or error feedback before continuing** +5. **NEVER provide long scripts in one block** + +### **Checkpoint System** + +- Pause for verification at logical milestones +- Confirm each major step before proceeding +- Document decisions and reasoning +- Get explicit approval for destructive actions + +### **Git Workflow** + +- Commit frequently (not just at session end) +- Use descriptive commit messages +- Always work on master branch +- Push changes after each major milestone +- Tag significant deployments + +### **Communication Patterns** + +- **"Jack alerted"** → Immediate pause, no questions +- **"Pausing"** → Acknowledge and wait +- **"Success"** → Continue to next step +- **Error messages** → Stop, analyze, provide solution +- **"Done"** → Current block complete, ready for next + +--- + +## 🔒 SECURITY BASELINE (ESTABLISHED) + +### **Authentication** + +- ✅ SSH key authentication on all 6 servers +- ✅ Password authentication disabled infrastructure-wide +- ✅ Unified SSH key across all infrastructure +- ✅ No unauthorized accounts remain + +### **System Security** + +- ✅ All servers on latest kernel (6.8.0-100) +- ✅ All security updates applied +- ✅ Zero pending updates +- ✅ Regular update schedule established + +### **Network Security** + +- Services bound to localhost where appropriate +- External access via Nginx reverse proxy +- IP-specific firewall rules (not 0.0.0.0) +- SSL/TLS encryption on all external connections + +--- + +## 📊 INFRASTRUCTURE PHILOSOPHY + +### **Core Principles** + +**1\. Set-It-And-Forget-It Reliability** + +- Automation over manual intervention +- Self-healing solutions (systemd, post-up scripts) +- Comprehensive monitoring (catch issues early) +- Minimize midnight emergency pages + +**Why:** Michael's time will become more precious when family grows + +**2\. Documentation First** + +- Document as you go (not at end of session) +- Enable others to help (knowledge transfer) +- Three-layer docs: What, Why, How +- Preserve personal context alongside technical + +**Why:** Infrastructure must be maintainable by others + +**3\. Security By Default** + +- SSH keys only (no passwords) +- IP-specific firewall rules +- Services on localhost \+ reverse proxy +- Regular security updates + +**Why:** Gaming infrastructure is a target + +**4\. Accessibility Always** + +- Small code blocks (8-10 lines max) +- Clear step-by-step instructions +- Verification checkpoints +- Mobile-friendly workflows + +**Why:** Hand surgery requires accommodation + +--- + +## 🎨 BRAND IDENTITY (FIRE \+ FROST) + +### **Visual Elements** + +- **Fire Colors:** Red, orange, warm tones (Gingerfury's domain) +- **Frost Colors:** Ice blue, white, cool tones (Frostystyle's domain) +- **Combined:** Purple/magenta (where Fire meets Frost) +- **Typography:** Clean, modern, readable +- **Aesthetic:** Fantasy gaming, elemental duality + +### **Voice & Tone** + +- **Fire (Community/Social):** Warm, welcoming, passionate, energetic +- **Frost (Technical/Docs):** Precise, clear, authoritative, professional +- **Firefrost Combined:** Balanced, authentic, refuge-like + +### **Core Message** + +"Where Fire meets Frost \- A Minnesota gaming refuge built on passion and precision." + +--- + +## 🎯 THE VISION FORWARD + +### **What We're Building** + +- A sustainable gaming community that survives life changes +- Infrastructure that doesn't need constant babysitting +- Documentation that enables team collaboration +- A legacy for Michael and Meg's family +- A refuge for players who value stability + +### **Why It Matters** + +- **Health:** Type 1 Diabetes requires reliable automation +- **Family:** Baby plans mean less available time +- **Partnership:** Fire \+ Frost working together +- **Community:** Building something lasting and meaningful + +### **Success Metrics** + +- Uptime: 99.9%+ (minimal midnight pages) +- Automation: Services self-heal and auto-update +- Documentation: Anyone can help maintain infrastructure +- Community: Growing player base with authentic engagement +- Financial: Sustainable revenue to support operations + +--- + +## 💬 HOW TO START A NEW SESSION + +### **Quick Start Template** + +Hey Claude\! Continuing Firefrost Gaming work. + +Context refresh: + +1\. Michael (Frostystyle) \+ Meg (Gingerfury) \= Fire \+ Frost + +2\. Jack is my diabetic alert dog \- if he alerts, we pause + +3\. Meg's ankle healing (broke Feb 4\) + +4\. Check docs/SESSION-HANDOFF.md for full context + +5\. Review docs/session-summary-feb8-2026.md for latest work + +Current status: \[brief update on what's happening today\] + +Ready to: \[what we're working on\] + +### **What Claude Should Do** + +1. Read SESSION-HANDOFF.md (this document) +2. Check latest session-summary in Git +3. Review TASKS.md for current priorities +4. Ask for quick personal status update +5. Confirm understanding of current goals +6. Begin work with micro-block format + +--- + +## ⚠️ IMPORTANT REMINDERS + +### **Never Assume** + +- Always ask about health status if uncertain +- Don't rush through checkpoints +- Verify understanding before proceeding +- Check if Meg is available if her input is needed + +### **Always Remember** + +- Jack's alerts are NON-NEGOTIABLE (immediate pause) +- Code blocks must be small (8-10 lines max) +- Git commits should happen frequently +- Personal context matters as much as technical work +- This is a legacy being built, not just infrastructure + +### **Communication Style** + +- Be direct and technical when appropriate +- Show empathy for health/life situations +- Celebrate wins (big and small) +- Acknowledge The Four-Legged Consultants +- Honor the Fire \+ Frost partnership + +--- + +## 🔄 DOCUMENT MAINTENANCE + +### **Update This Document When:** + +- Major infrastructure changes occur +- New services are deployed +- Project priorities shift +- Personal circumstances change +- New team members join +- Technical decisions affect workflow + +### **Version History** + +| Version | Date | Changes | +| :---- | :---- | :---- | +| 1.0 | 2026-02-09 | Initial session handoff document created. Comprehensive context from all sessions Feb 6-9. | + +--- + +**END OF SESSION HANDOFF DOCUMENT** + +**Fire \+ Frost \= Where Passion Meets Precision** 🔥❄️ **The Wizard, The Emissary, and The Four-Legged Consultants** **Building Firefrost Gaming \- One Service at a Time** + +--- + +**For Claude:** You now have everything you need to maintain continuity across sessions. Honor the human story behind the infrastructure. Health always comes first. Small code blocks are non-negotiable. The Four-Legged Consultants are part of the team. + +**Welcome to Firefrost Gaming.** 🧙‍♂️✨ EOF + +--- + +## **Git Repository Access & Documentation Map** + +**CRITICAL FOR ALL SESSIONS:** This project maintains a Git repository with comprehensive documentation. Claude CANNOT access these files directly - they must be read via bash commands. + +### **Repository Location:** +- **Server:** TX1 Dallas (38.68.14.26) +- **Path:** `/root/firefrost-work/firefrost-operations-manual/` +- **Remote:** https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual +- **Branch:** `master` (source of truth) + +### **How to Access Git Documentation:** + +**To read any document:** +```bash +cd ~/firefrost-work/firefrost-operations-manual +cat docs/[filename].md +``` + +**To view available documents:** +```bash +ls -la docs/ +``` + +**To check Git status:** +```bash +git status +git log --oneline -5 +``` + +### **Key Documents in Repository:** + +**Core Reference Documents:** +- `session-handoff.md` (THIS FILE) - Complete context for every session +- `discord-structure-complete.md` - Discord architecture, Fire/Frost paths, role hierarchy +- `design-bible-v1.1.md` - Brand guidelines, color palette, typography +- `architecture-decisions.md` - Technical decisions and reasoning +- `firefrost-master-implementation-plan.md` - 12-month roadmap across 6 phases + +**Current Status & Tracking:** +- `TASKS.md` - Current priorities and Phase 0.5 progress (UPDATES EVERY SESSION) + +**Deployment Documentation:** +- `gitea-deployment.md` - Service 1/5: Git repository (COMPLETE) +- `uptime-kuma-deployment.md` - Service 2/5: Infrastructure monitoring (COMPLETE) +- Additional deployment docs added as services are deployed + +**Infrastructure Documentation:** +- `provider-communications.md` - Breezehost ticket history and decisions +- `luckperms-structure.md` - Permission hierarchy for Minecraft network +- `path-philosophy.md` - Fire vs Frost player journey philosophy + +**Social & Community:** +- `firefrost-social-strategy.md` - Multi-platform social media strategy +- `megs-social-setup-guide.md` - Setup guide for The Emissary + +**Planning & Vision:** +- `awakened-gateway.md` - $1 tier onboarding experience +- `firefrost-shopping-list.md` - Required purchases and integrations + +### **Project Files vs Git Repository:** + +**What Claude HAS Direct Access To:** +- `/mnt/project/Firefrost_Vanilla_Manifest.md` (infrastructure truth) + +**What Claude MUST Read Via Bash:** +- Everything in the Git repository (all docs/ files) + +**Why This Matters:** +- Git documents are the living, up-to-date source of truth +- This file (session-handoff.md) updates after every session +- TASKS.md updates after every session +- Deployment docs are added as work progresses + +### **Current Project Status (as of Feb 9, 2026):** + +**Phase 0.5 Progress: 40% Complete (2/5 services deployed)** + +**Completed Services:** +1. ✅ **Gitea** (git.firefrostgaming.com) - Git repository on TX1 +2. ✅ **Uptime Kuma** (status.firefrostgaming.com) - Infrastructure monitoring on TX1 + +**Pending Services:** +3. ⏳ **BookStack** (docs.firefrostgaming.com) - NEXT +4. ⏳ **Netdata** (analytics.firefrostgaming.com) +5. ⏳ **Vaultwarden** (vault.firefrostgaming.com) + +**Infrastructure Status:** +- 6 servers operational (TX1, NC1, Panel, Command Center, Billing, Ghost) +- All monitoring green (100% uptime) +- Discord notifications configured (#network-status) +- NC1 excluded from monitoring due to datacenter routing limitation + +### **Session Workflow for Future Claude:** + +**At Session Start:** +1. Read this file: `cat docs/session-handoff.md` +2. Check current tasks: `cat docs/TASKS.md` +3. Review recent Git history: `git log --oneline -10` +4. Verify server access if needed: `ssh root@[server]` + +**During Session:** +- Create deployment docs for completed services +- Update TASKS.md to reflect progress +- Commit and push changes to Git + +**At Session End:** +- Update session-handoff.md with new learnings (append only, non-destructive) +- Document any issues or decisions in appropriate files +- Ensure all changes committed to Git repository + +--- + +**REMEMBER:** The Git repository is the single source of truth. When in doubt, read the docs from Git. This session-handoff.md file itself updates regularly - always read the latest version from Git, not from memory. + + +--- + +## **Git Repository Access & Documentation Map** + +**CRITICAL FOR ALL SESSIONS:** This project maintains a Git repository with comprehensive documentation. Claude CANNOT access these files directly - they must be read via bash commands. + +### **Repository Location:** +- **Server:** TX1 Dallas (38.68.14.26) +- **Path:** `/root/firefrost-work/firefrost-operations-manual/` +- **Remote:** https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual +- **Branch:** `master` (source of truth) + +### **How to Access Git Documentation:** + +**To read any document:** +```bash +cd ~/firefrost-work/firefrost-operations-manual +cat docs/[filename].md +``` + +**To view available documents:** +```bash +ls -la docs/ +``` + +**To check Git status:** +```bash +git status +git log --oneline -5 +``` + +### **Key Documents in Repository:** + +**Core Reference Documents:** +- `session-handoff.md` (THIS FILE) - Complete context for every session +- `discord-structure-complete.md` - Discord architecture, Fire/Frost paths, role hierarchy +- `design-bible-v1.1.md` - Brand guidelines, color palette, typography +- `architecture-decisions.md` - Technical decisions and reasoning +- `firefrost-master-implementation-plan.md` - 12-month roadmap across 6 phases + +**Current Status & Tracking:** +- `TASKS.md` - Current priorities and Phase 0.5 progress (UPDATES EVERY SESSION) + +**Deployment Documentation:** +- `gitea-deployment.md` - Service 1/5: Git repository (COMPLETE) +- `uptime-kuma-deployment.md` - Service 2/5: Infrastructure monitoring (COMPLETE) +- Additional deployment docs added as services are deployed + +**Infrastructure Documentation:** +- `provider-communications.md` - Breezehost ticket history and decisions +- `luckperms-structure.md` - Permission hierarchy for Minecraft network +- `path-philosophy.md` - Fire vs Frost player journey philosophy + +**Social & Community:** +- `firefrost-social-strategy.md` - Multi-platform social media strategy +- `megs-social-setup-guide.md` - Setup guide for The Emissary + +**Planning & Vision:** +- `awakened-gateway.md` - $1 tier onboarding experience +- `firefrost-shopping-list.md` - Required purchases and integrations + +### **Project Files vs Git Repository:** + +**What Claude HAS Direct Access To:** +- `/mnt/project/Firefrost_Vanilla_Manifest.md` (infrastructure truth) + +**What Claude MUST Read Via Bash:** +- Everything in the Git repository (all docs/ files) + +**Why This Matters:** +- Git documents are the living, up-to-date source of truth +- This file (session-handoff.md) updates after every session +- TASKS.md updates after every session +- Deployment docs are added as work progresses + +### **Current Project Status (as of Feb 9, 2026):** + +**Phase 0.5 Progress: 40% Complete (2/5 services deployed)** + +**Completed Services:** +1. ✅ **Gitea** (git.firefrostgaming.com) - Git repository on TX1 +2. ✅ **Uptime Kuma** (status.firefrostgaming.com) - Infrastructure monitoring on TX1 + +**Pending Services:** +3. ⏳ **BookStack** (docs.firefrostgaming.com) - NEXT +4. ⏳ **Netdata** (analytics.firefrostgaming.com) +5. ⏳ **Vaultwarden** (vault.firefrostgaming.com) + +**Infrastructure Status:** +- 6 servers operational (TX1, NC1, Panel, Command Center, Billing, Ghost) +- All monitoring green (100% uptime) +- Discord notifications configured (#network-status) +- NC1 excluded from monitoring due to datacenter routing limitation + +### **Session Workflow for Future Claude:** + +**At Session Start:** +1. Read this file: `cat docs/session-handoff.md` +2. Check current tasks: `cat docs/TASKS.md` +3. Review recent Git history: `git log --oneline -10` +4. Verify server access if needed: `ssh root@[server]` + +**During Session:** +- Create deployment docs for completed services +- Update TASKS.md to reflect progress +- Commit and push changes to Git + +**At Session End:** +- Update session-handoff.md with new learnings (append only, non-destructive) +- Document any issues or decisions in appropriate files +- Ensure all changes committed to Git repository + +--- + +**REMEMBER:** The Git repository is the single source of truth. When in doubt, read the docs from Git. This session-handoff.md file itself updates regularly - always read the latest version from Git, not from memory. + + +--- + +## **GitHub Mirror Configuration** + +**Setup Date:** February 9, 2026 +**Purpose:** Public mirror for Claude to access documentation without SSH/bash commands + +### **Mirror Details:** +- **GitHub Repo:** https://github.com/Frostystyle/firefrost-operations-manual +- **Visibility:** Public (safe - no sensitive data) +- **Sync Method:** Gitea push mirror (automatic on every commit) +- **Sync Interval:** 8 hours (backup) + immediate on push + +### **How Claude Uses the Mirror:** + +**When Claude needs to read docs:** +``` +Michael provides raw GitHub URL: +https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/docs/[filename].md + +Claude uses web_fetch to read the file directly +``` + +**Example URLs:** +- TASKS.md: https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/docs/TASKS.md +- session-handoff.md: https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/docs/session-handoff.md +- discord-structure-complete.md: https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/docs/discord-structure-complete.md + +### **Security Notes:** +- ⚠️ All content on GitHub is PUBLIC - no IP addresses, passwords, or sensitive data +- ✅ Push mirror uses Personal Access Token (PAT) stored in Gitea +- ✅ SSH hardening on TX1 remains intact (no rollback needed) +- ✅ Token expires: Check GitHub settings periodically + +### **Maintenance:** +- Token renewal required when it expires +- Verify sync status in Gitea Settings → Repository → Mirror Settings +- Monitor GitHub repo for successful pushes + +--- + +**END OF GITHUB MIRROR SECTION** + + +--- + +## **Session Feb 9, 2026: Key Learnings** + +**Services Deployed:** +- ✅ Uptime Kuma (status.firefrostgaming.com) - Infrastructure monitoring with Discord integration + +**Major Infrastructure Improvements:** +- ✅ GitHub Mirror configured (auto-sync from Gitea) +- ✅ Workflow optimization: consolidated Git commands reduce hand strain +- ✅ Public documentation platform established + +**Critical Discoveries:** +- NC1 and TX1 cannot communicate directly (different datacenters, no routing) +- Uptime Kuma requires git clone + npm run setup (not npm install) +- GitHub mirrors provide excellent documentation access without security compromise + +**Workflow Improvements:** +- Consolidated commands: One paste per operation instead of multiple commands +- GitHub mirror: Claude can fetch docs via raw URLs without bash commands +- Session summaries: Comprehensive records committed to Git after major work + +**Next Service:** BookStack (docs.firefrostgaming.com) + + +--- + +## **Critical Medical Context (Added Feb 9, 2026)** + +**Michael's Health Background:** +- **Type 1 Diabetes:** Managed with Omnipod 5 insulin pump + Dexcom G7 +- **Service Dog:** Jack (diabetic alert dog) - health alerts take ABSOLUTE PRIORITY +- **Major Surgeries in 2025:** + - January 7, 2025: Panniculectomy + 3 hernia repairs (10.3 lbs tissue removed) + - March 3, 2025: 8-procedure hand reconstruction (right hand, permanent nerve damage) + - April 8, 2025: Bilateral mastectomy + chest reconstruction (4.85 lbs tissue removed) +- **Hand Limitations:** Permanent nerve damage from March 2025 surgery + - Surgeon's prognosis: "unlikely muscle and strength will return to normal" + - Requires micro-block format (8-10 lines max per code block) + - Consolidated commands essential (one paste per operation) + - SSH automation planned to minimize manual typing + +**Accessibility Requirements:** +- Small code blocks for mobile/desktop copy-paste (prevent UI crashes) +- Consolidated commands (one command block = complete operation) +- Extremely granular step-by-step instructions +- Never skip "obvious" steps (chmod, mkdir, etc.) +- Health and family ALWAYS take priority over work + +**Why This Matters:** +- Every paste operation requires physical effort with compromised hands +- GitHub mirror reduces need for manual file reading (major win!) +- Tomorrow's SSH automation will eliminate most manual commands +- Sessions may end abruptly if Jack alerts (this is expected and proper) + +--- + +## **GitHub Mirror Workflow (Added Feb 9, 2026)** + +**Public Mirror:** https://github.com/Frostystyle/firefrost-operations-manual + +**How Claude Accesses Documentation:** +1. Michael provides raw GitHub URL when Claude needs to read a doc +2. Claude uses web_fetch tool to retrieve content directly +3. No SSH/bash commands needed for reading (saves Michael's hands) + +**Raw URL Format:** +``` +https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/docs/[filename].md +``` + +**Auto-Sync:** +- Every `git push` to Gitea triggers automatic sync to GitHub +- Backup sync every 8 hours +- Status visible in Gitea Settings → Repository → Mirror Settings + +**Security Note:** +- GitHub repo is PUBLIC (by design, for Claude access) +- Never commit IPs, passwords, API keys, webhook URLs, SSH keys +- Use placeholders: , , etc. +- Sensitive data stays in Project Files or private Gitea only + +--- + +## **Tomorrow's Plan: SSH Automation (Feb 10, 2026)** + +**Goal:** Enable SSH password authentication so Claude can execute ALL commands automatically + +**Implementation:** +1. Edit `/etc/ssh/sshd_config` on TX1 +2. Change `PasswordAuthentication no` → `yes` +3. Restart SSH service +4. Michael provides password once at session start +5. Claude handles all operations automatically for entire session + +**Trade-off Accepted:** +- ✅ Massive reduction in hand strain (manual commands → zero commands) +- ⚠️ Moderate security risk (SSH password auth exposes to brute force) +- ✅ Risk acceptable given Michael's medical situation +- ✅ Can restrict by IP if needed later + +**Why This Decision:** +- Michael's permanent hand nerve damage makes repetitive commands painful +- Current workflow still requires 3-5 paste operations per session +- Medical situation outweighs security concerns +- Enables BookStack deployment and Phase 0.5 completion + +--- + +## **Documentation Organization (Added Feb 9, 2026)** + +**INDEX Created:** docs/INDEX.md provides comprehensive navigation for 28+ documentation files + +**Quick Reference:** +- Current status: TASKS.md, session-handoff.md +- Deployments: gitea-deployment.md, uptime-kuma-deployment.md +- Planning: firefrost-master-implementation-plan.md, design-bible-v1.md +- Community: discord-structure-complete.md, subscription-tiers-final.md +- Brand: visual-assets-guide.md, path-philosophy.md +- Future: pterodactyl-extensions-plan.md + +**Document Search:** See INDEX.md "Quick Search Guide" section + +--- + +## **Infrastructure Status Update (Feb 9, 2026)** + +**Phase 0.5 Progress: 40% Complete (2/5 Services)** + +**Completed:** +1. ✅ Gitea (git.firefrostgaming.com) - Deployed Feb 8 +2. ✅ Uptime Kuma (status.firefrostgaming.com) - Deployed Feb 9 + +**Monitoring Status:** +- 6 servers monitored (TX1 + 4 VPS) - 100% uptime +- Discord notifications active (#network-status) +- NC1 excluded (datacenter routing isolation - cannot ping from TX1) + +**Pending Services:** +3. ⏳ BookStack (docs.firefrostgaming.com) - NEXT (with SSH automation) +4. ⏳ Netdata (analytics.firefrostgaming.com) +5. ⏳ Vaultwarden (vault.firefrostgaming.com) + +**Infrastructure Improvements:** +- Visual maps created (interactive HTML + print-friendly versions) +- Pterodactyl Extensions planned (Phase 0.6 - 5 extensions) +- INDEX.md created for documentation navigation + +--- + +## **Session Workflow Optimization** + +**Current Best Practices:** +1. **Start:** Claude reads session-handoff.md + TASKS.md + recent session summaries +2. **During:** Consolidated commands (one paste = complete operation) +3. **End:** Create session summary, update TASKS.md, commit to Git +4. **Always:** Health alerts from Jack take absolute priority + +**Git Workflow:** +```bash +cd ~/firefrost-work/firefrost-operations-manual +# Make changes +git add [files] +git commit -m "descriptive message" +git push +# Auto-syncs to GitHub within seconds +``` + +**After Tomorrow (SSH Automation):** +1. **Start:** Michael provides SSH password once +2. **During:** Claude executes all commands automatically +3. **End:** Claude creates session summary and commits (no manual paste needed) + +--- + +## **Key Reminders for Future Claude Sessions** + +1. **Read INDEX.md** if looking for specific documentation +2. **Medical context matters** - hand limitations are permanent, not temporary +3. **Jack's alerts = session pause** - this is expected and proper +4. **Use GitHub mirror** - Request raw URLs instead of asking for bash commands +5. **Tomorrow = SSH automation** - Workflow will dramatically improve +6. **Consolidated commands** - Until SSH automation, keep everything in one block +7. **Phase 0.5 focus** - Complete Services 3-5 before moving to Phase 1 + +--- + +**Last Major Update:** February 9, 2026 - Medical context, GitHub mirror, SSH automation plan + + +--- + +## **Firefrost Automation System (Added Feb 9, 2026)** + +**Status:** ✅ Fully Operational +**Purpose:** Minimize manual copy/paste during work sessions (95% automation) + +### **How It Works:** + +**Architecture:** +``` +┌─────────────┐ ┌──────────────┐ Auto ┌─────────────┐ +│ Claude │ │ TX1/Gitea │ Sync │ GitHub │ +│ (Isolated) │ │ (Primary) │ ──────> │ (Mirror) │ +└─────────────┘ └──────────────┘ 1-2min └─────────────┘ + │ │ │ + │ │ │ + ↓ ↓ ↓ + Creates Executes Claude reads + task script automatically results via + in outputs via daemon web_fetch +``` + +### **Complete Workflow:** + +**1. Session Start:** +```bash +cd ~/firefrost-work/firefrost-operations-manual +nohup bash automation/automation-daemon.sh > /dev/null 2>&1 & +echo "Daemon PID: $!" +``` + +**2. Claude Creates Task:** +- Claude generates task script (deployment, config, etc.) +- Provides Michael with ONE command to queue it +- Example: `cat > automation/queue/deploy-bookstack.sh << 'EOF' ... EOF` + +**3. Michael Pastes Once:** +- Michael pastes the single command +- Task goes into `automation/queue/` +- **THAT'S IT - No more pasting needed!** + +**4. Daemon Executes Automatically:** +- Daemon checks Git every 10 seconds +- Detects new .sh file in queue/ +- Runs `automation/executor.sh` +- Captures all output to `automation/results/` +- Moves completed task to `automation/logs/` +- Commits results back to Gitea + +**5. Gitea Syncs to GitHub:** +- Auto-sync triggered by commit +- Takes 1-2 minutes +- Results appear on GitHub mirror + +**6. Claude Reads Results:** +- Claude uses web_fetch on GitHub raw URL +- Example: `https://raw.githubusercontent.com/.../automation/results/task_result.txt` +- Claude sees: exit codes, output, errors +- Claude provides next steps based on results + +### **Why This System Exists:** + +**Medical Necessity:** +- Michael's permanent hand nerve damage (March 2025 surgery) +- Every paste operation requires physical effort +- Reduces strain from 10-20 pastes to ONE paste per task + +**Benefits:** +- ✅ 95% reduction in manual typing +- ✅ All operations auditable in Git +- ✅ Results automatically captured +- ✅ Perfect for marathon sessions +- ✅ Can queue multiple tasks at once + +### **Key Files:** + +| Location | Purpose | +|----------|---------| +| `automation/automation-daemon.sh` | Background watcher (start at session begin) | +| `automation/executor.sh` | Runs tasks and commits results | +| `automation/queue/*.sh` | Tasks waiting to execute | +| `automation/results/*_result.txt` | Execution output (Claude reads these) | +| `automation/logs/` | Completed tasks and execution history | +| `automation/USAGE.md` | Full documentation | + +### **For Future Claude Sessions:** + +**At Session Start:** +1. Check if daemon is running: `ps aux | grep automation-daemon` +2. If not running, start it (see command above) +3. Note the PID for reference + +**During Session:** +1. Create task scripts for complex operations +2. Provide Michael with single command to queue +3. Wait 10-20 seconds for execution +4. Read results from GitHub mirror +5. Proceed based on results + +**Task Naming Convention:** +- Use descriptive names: `deploy-bookstack.sh`, `update-dns.sh` +- Include date if needed: `backup-20260209.sh` +- Results will be: `task-name_result.txt` + +### **GitHub Mirror URLs for Claude:** + +**Base URL:** +``` +https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/ +``` + +**To read results:** +``` +https://raw.githubusercontent.com/Frostystyle/firefrost-operations-manual/master/automation/results/[task-name]_result.txt +``` + +**Workflow:** +1. Claude queues task via Michael +2. Wait 2-3 minutes (execution + sync) +3. Claude fetches result URL +4. Claude parses output and continues + +--- + +**Last Updated:** February 9, 2026 10:15 AM CST - Automation system fully operational + + +--- + +## **PROJECT FILE UPDATE REMINDERS** + +**For Claude: Check at END of every session** + +### When to Remind Michael to Update Project Files + +**ALWAYS remind if ANY of these occurred during session:** +- ✅ Architecture pivot (e.g., BookStack → MkDocs) +- ✅ New system deployed (e.g., automation framework) +- ✅ Phase added or updated (e.g., Phase 1 DDoS) +- ✅ Major documentation added (e.g., doc principle) +- ✅ Process change (e.g., new workflow step) + +**Files that need updating most often:** +1. FIREFROST-PROJECT-SCOPE-V2.md (after phases/architecture changes) +2. session-handoff.md (after status updates) +3. workflow-guide.md (after process changes) + +### The Reminder Protocol + +**At END of session, Claude checks:** +1. Did we update FIREFROST-PROJECT-SCOPE-V2.md? → Remind to re-upload +2. Did we update workflow-guide.md? → Remind to re-upload +3. Did we update session-handoff.md? → Remind to re-upload + +**Reminder format:** +``` +🔄 PROJECT FILE UPDATE REMINDER + +The following project files were updated this session: +- FIREFROST-PROJECT-SCOPE-V2.md (Phase 1 DDoS added) +- workflow-guide.md (Doc principle added) + +Please re-upload these files to keep project context fresh! +Location: /root/firefrost-work/firefrost-operations-manual/docs/ +``` + +### Michael's Commitment + +**"Always update project files when reminded."** + +This prevents documentation drift and ensures every future Claude session has current context. + +**5 minutes now = hours saved later** ⏱️💎 + + +--- + +## **TX1 Optimization & Cleanup (Feb 9, 2026 - 6:55 PM CST)** + +**Services Removed:** +- MySQL (no databases in use) +- Nginx (all web services migrated) +- Wiki.js (never used, failing) +- Old Gitea files +- Old Uptime Kuma files + +**Disk Space Freed:** ~832MB total + +**TX1 Final State:** +- **Purpose:** Game servers ONLY +- **Services:** Pterodactyl Wings + 6 game servers + Docker +- **Running Units:** 31 (all essential) +- **Disk Usage:** 53GB / 911GB (6%) +- **Memory:** 3.7GB / 251GB (1.5%) + +**Result:** TX1 is now lean, optimized, dedicated to game hosting. All management services on VPS tier. + +--- + +**Current Infrastructure State (Feb 9, 2026 - 7:00 PM CST):** + +**Command Center VPS (63.143.34.217) - Management Hub:** +- ✅ Gitea (git.firefrostgaming.com) +- ✅ Uptime Kuma (status.firefrostgaming.com) +- ✅ Automation System (operational) +- ✅ Node.js 20.20.0 + +**TX1 Dallas (38.68.14.26) - Game Server Node:** +- ✅ 6 game servers operational +- ✅ Pterodactyl Wings +- ✅ CLEAN (management services removed) + +**Ghost VPS (64.50.188.14) - Documentation Cluster (Pending):** +- ⏳ MkDocs (next) +- ⏳ Wiki.js Subscribers + Staff (next) +- ⏳ NextCloud (next) + +**NC1 Charlotte (216.239.104.130) - Game Server Node:** +- ✅ 9 game servers operational +- ✅ Pterodactyl Wings