Add project-files directory with stable names for Claude Project sync

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**  

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.

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** 🔥❄️

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** 🔥❄️