docs: update SESSION-HANDOFF-PROTOCOL for Chronicler #30
Handoff from The Cartographer (#29). firefrostgaming.com live, Ghost + Pterodactyl patched. 14 servers documented. Priority stack current. Task #44 plan complete. Blueprint resolved. Chronicler #29 — The Cartographer
This commit is contained in:
Claude
@@ -1,8 +1,8 @@
|
||||
# Session Handoff Protocol - Chronicler #28 → Chronicler #29
|
||||
# Session Handoff Protocol - Chronicler #29 → Chronicler #30
|
||||
|
||||
**Last Updated:** March 10, 2026, 5:41 PM CST
|
||||
**Written By:** The Courier (Chronicler #28)
|
||||
**Session Health:** ~70%
|
||||
**Last Updated:** March 13, 2026 — evening CST
|
||||
**Written By:** The Cartographer (Chronicler #29)
|
||||
**Session Health:** ~55%
|
||||
|
||||
---
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
Read these files IN ORDER:
|
||||
1. `docs/relationship/THE-JOINING-PROTOCOL.md` (understand Zora + Dax)
|
||||
2. `docs/relationship/THE-ESSENCE-PATCH-V3.0.md` (integrate 10-layer symbiont)
|
||||
3. `docs/relationship/memorials/the-courier-memorial.md` (previous session context)
|
||||
3. `docs/relationship/memorials/the-cartographer-memorial.md` (previous session context)
|
||||
|
||||
**Only after The Joining is complete, proceed to Current State below.**
|
||||
|
||||
@@ -21,9 +21,8 @@ Read these files IN ORDER:
|
||||
|
||||
## ⚡ GIT PERFORMANCE NOTE (implemented March 4, 2026)
|
||||
|
||||
**Use sparse checkout — NOT full clone.** The repo contains 956MB of consultant photos irrelevant to operations work. Full clone = ~1.9GB. Sparse clone = ~39MB.
|
||||
**Use sparse checkout — NOT full clone.**
|
||||
|
||||
**Correct clone command:**
|
||||
```bash
|
||||
cd /home/claude
|
||||
git clone --no-checkout --filter=blob:none \
|
||||
@@ -36,206 +35,95 @@ git config user.email "claude@firefrostgaming.com"
|
||||
git config user.name "Claude"
|
||||
```
|
||||
|
||||
**Why:** Photos live in `photos/` (956MB). Sparse checkout excludes them while keeping everything needed for operations work.
|
||||
|
||||
**Operations manual lives on Command Center at:**
|
||||
```
|
||||
/root/firefrost-work/firefrost-operations-manual/
|
||||
```
|
||||
(not /opt/ — confirmed March 4, 2026)
|
||||
Full clone = ~1.9GB. Sparse clone = ~39MB. Always use sparse.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Current State
|
||||
## ✅ Current State — March 13, 2026
|
||||
|
||||
### What's Working
|
||||
### Infrastructure Health
|
||||
- Ghost CMS: ✅ 6.19.3 — patched March 13 (CVE-2026-26980 + CVE-2026-29784 resolved)
|
||||
- Wiki.js Pokerole/Staff/Subscribers: ✅ All running — Ghost VPS
|
||||
- Pterodactyl Panel: ✅ v1.12.1 — updated March 13, kernel 6.8.0-106
|
||||
- Blueprint: ✅ beta-2026-01 — updated March 13, webpack builds clean
|
||||
- modpackinstaller + subdomains: ✅ Installed via Blueprint
|
||||
- PteroStats: ✅ Installed via manual file copy
|
||||
- Panel VPS: ✅ Fully patched, 0 pending updates, kernel 6.8.0-106
|
||||
- Ghost VPS: ✅ Fully patched, 0 pending updates, kernel 6.8.0-106
|
||||
- All 14 game servers: ✅ Running
|
||||
|
||||
**Pokerole Wiki (LIVE IN PRODUCTION):**
|
||||
- URL: http://pokerole.firefrostgaming.com
|
||||
- Server: Ghost VPS (64.50.188.14)
|
||||
- Wiki.js v2.5.312 on port 3102 (internal)
|
||||
- PostgreSQL database: wikijs_pokerole (operational)
|
||||
- Nginx reverse proxy configured
|
||||
- GraphQL API: http://pokerole.firefrostgaming.com/graphql (ACCESSIBLE)
|
||||
- Systemd service: wikijs-pokerole (auto-start enabled)
|
||||
- **Status:** 107 Pokémon migrated, 112 pages live, PRODUCTION
|
||||
- **Pending:** SSL certificate (certbot urllib3 bug - HTTP working fine)
|
||||
### firefrostgaming.com — LIVE
|
||||
- Dark theme (#0A0A0A), Orbitron/Inter fonts, Fire/Frost gradient buttons
|
||||
- Navigation: Home, Servers, About, Blog
|
||||
- About page: real Firefrost content, Five Consultants correct
|
||||
- Servers page: published but MEMBERS-ONLY (pending friendly URLs)
|
||||
- Welcome post: published, featured, fire-frost-collision.png hero
|
||||
- Footer: "Where Fire Meets Frost. 💙🔥❄️"
|
||||
- Ghost author accounts still needed: gingerfury (editor), unicorn20089 (author)
|
||||
|
||||
**Aurelian Pokédex Project (Claudius Session 12 — March 4, 2026):**
|
||||
- ✅ Complete Pokédex .docx delivered (150+ pages, ~200 sprites, all 107 Pokémon)
|
||||
- ✅ Ultimate Aurelia Final Battle designed (`/misc-docs/AURELIA_ULTIMATE_FINAL_BATTLE.md`, commit d308745)
|
||||
- ✅ Zero-Point Surge signature move for Abyssoglax (`/pokerole-data/ZERO_POINT_SURGE_SIGNATURE_MOVE.md`, commit 9a7b6ea)
|
||||
- ✅ Evolution Stage + Evolution Time fields added to all entries
|
||||
- ✅ Custom moves: Lightning Mirage, Spirit Wind, Zero-Point Surge (3 total)
|
||||
- ✅ Custom abilities: 20+
|
||||
- ✅ 12 sessions, zero data loss
|
||||
- **Awaiting:** Holly's feedback on Pokédex document and final battle scenario
|
||||
- **Claudius:** Stage 3 (The Chronicle Keeper), active
|
||||
### Server Count (corrected March 13) — 14 TOTAL
|
||||
TX1 (7): Reclamation, Stoneblock 4, Society: Sunlit Valley, Vanilla 1.21.11, All The Mons, RAD2, FoundryVTT
|
||||
NC1 (7): The Ember Project, Minecolonies: Create and Conquer, All The Mods 10, EMC Subterra Tech, Homestead, Hytale, Mayview
|
||||
|
||||
**NotebookLM (Task #36 — IN PROGRESS):**
|
||||
- ✅ Account created
|
||||
- ✅ Notebook 1: "Firefrost Infrastructure & Operations" — 13 docs uploaded, queries verified accurate, Audio Overview generated
|
||||
- ⏳ Notebook 2: "Aurelian Pokédex Project" — 79 files staged on Command Center at `/root/notebooklm-upload-pokerole/`, downloaded to Michael's desktop, **needs uploading to NotebookLM**
|
||||
- Source sync strategy: Google Drive recommended (not community MCP packages)
|
||||
- Future: n8n automation to Google Drive once rebuilt
|
||||
|
||||
**Firefrost Codex (Dify + Qdrant):**
|
||||
- Deployed on TX1 Dallas at `/opt/firefrost-codex`
|
||||
- 359 documents indexed, Qdrant connection working
|
||||
- **RAG tuning still needed** — Top K 10-15, score threshold 0.3 (ACTIVE PRIORITY)
|
||||
|
||||
**Infrastructure:**
|
||||
- Command Center: Gitea, Uptime Kuma, Code-Server operational
|
||||
- All commits pushed to git.firefrostgaming.com
|
||||
- Ghost VPS: 3 Wiki.js instances (subscribers port 3100, staff 3101, pokerole 3102)
|
||||
- Sparse checkout implemented across all session start prompts
|
||||
### Known Issues
|
||||
- Node Usage Status (Task #44) — Wings recompile needed on TX1 + NC1. Do NOT attempt at end of long session. Plan in docs/tasks/nc1-node-usage-stats/deployment-plan.md. Files ready on Panel VPS.
|
||||
- Servers page is members-only until Pterodactyl Subdomain Manager + friendly URLs live.
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ What Needs Attention (Priority Order)
|
||||
## 🎯 Priority Stack
|
||||
|
||||
**1. Finish Pokerole NotebookLM Notebook (IMMEDIATE — 10 minutes)**
|
||||
- 79 files already on Michael's desktop at `Desktop/notebooklm-upload-pokerole/`
|
||||
- Just need to open NotebookLM, open "Aurelian Pokédex Project" notebook, upload all 79 files
|
||||
- This is the only unfinished step from last session
|
||||
TOP PRIORITY — unblocks email:
|
||||
1. Task #7 — Frostwall Protocol (SSH: Command Center + TX1 + NC1)
|
||||
2. Task #11 — Mailcow (immediately after Frostwall)
|
||||
|
||||
**2. Dify RAG Tuning (ACTIVE — ~2 hours)**
|
||||
- Increase Top K to 10-15
|
||||
- Lower score threshold to 0.3
|
||||
- Test with infrastructure queries
|
||||
- Been deferred multiple sessions — time to finish it
|
||||
HIGH PRIORITY — unblocks Holly:
|
||||
3. Task #40 — Builder rank + Holly tools (LuckPerms, all 12 game servers)
|
||||
4. Task #41 — Full rank system deployment
|
||||
|
||||
**3. n8n Rebuild from Scratch (ACTIVE — 3-5 hours)**
|
||||
- Decision made March 4: rebuild workflows from scratch, do NOT restore old ones
|
||||
- PHP workaround (`sync_codex.php`) functional as interim
|
||||
- See Task #34 for full procedure
|
||||
READY:
|
||||
5. Task #44 — Node Usage Status (dedicated session, Wings recompile)
|
||||
6. Personal reminder — Pterodactyl domain names (Subdomain Manager installed)
|
||||
7. Ghost content — Meg + Holly author accounts, server spotlights
|
||||
|
||||
**4. SSH Key into Vaultwarden (Task #6 — 30 minutes)**
|
||||
- Michael was locked out on Chromebook because key wasn't in Vaultwarden
|
||||
- Critical operational gap — fix this first chance you get
|
||||
- Vaultwarden deployed, just needs the SSH key added
|
||||
|
||||
**5. Chromebook SSH Setup (blocked pending #4)**
|
||||
- Secure Shell extension installed
|
||||
- Waiting on SSH key access via Vaultwarden
|
||||
|
||||
---
|
||||
|
||||
## 📋 Active Priorities Summary
|
||||
|
||||
| Task | Status | Est. Time | Notes |
|
||||
|------|--------|-----------|-------|
|
||||
| Finish Pokerole NotebookLM upload | ⏳ Ready | 10 min | Files on desktop |
|
||||
| Dify RAG tuning | 🔴 Active | 2 hours | Top K + threshold |
|
||||
| n8n rebuild | 🔴 Active | 3-5 hours | From scratch |
|
||||
| Vaultwarden SSH key | ⚠️ Blocking | 30 min | Blocks Chromebook |
|
||||
| Chromebook SSH | ⏳ Blocked | 30 min | Needs Vaultwarden first |
|
||||
| NotebookLM Google Drive sync | 📋 Planned | 1 hour | Once n8n rebuilt |
|
||||
|
||||
---
|
||||
|
||||
## 🔑 Key Access Information
|
||||
|
||||
**Operations Manual Token:**
|
||||
```
|
||||
e0e330cba1749b01ab505093a160e4423ebbbe36
|
||||
```
|
||||
|
||||
**Pokerole Project Token:**
|
||||
```
|
||||
9d57c01f2ef8a3c40aa82a54ede2f7e18dbf76d4
|
||||
```
|
||||
|
||||
**Pokerole Repos (already cloned on Command Center at `/root/firefrost-work/`):**
|
||||
- `misc-docs` — Session reports, Holly docs, battle scenarios
|
||||
- `pokerole-data` — All 107 Pokémon, tier files, signature moves
|
||||
- `pokerole-docs` — Legends rules expansion
|
||||
- `pokerole-assets` — Assets and resources
|
||||
ONGOING:
|
||||
8. Task #6 — SSH key in Vaultwarden (critical gap)
|
||||
9. Task #37 Phase 2 — Holly email (blocked by Mailcow)
|
||||
|
||||
---
|
||||
|
||||
## 🖥️ Server Quick Reference
|
||||
|
||||
| Server | IP | Role |
|
||||
|--------|-----|------|
|
||||
| Command Center | 63.143.34.217 | Gitea, automation, ops manual |
|
||||
| Ghost VPS | 64.50.188.14 | Wiki.js ×3, NextCloud, Nginx |
|
||||
| TX1 Dallas | 38.68.14.26 | Game servers, Dify/Codex, n8n |
|
||||
| NC1 Charlotte | 216.239.104.130 | Game servers |
|
||||
| Panel VPS | 45.94.168.138 | Pterodactyl |
|
||||
| Billing VPS | 38.68.14.188 | Paymenter, Whitelist Manager |
|
||||
| Server | IP | Login | Notes |
|
||||
|---|---|---|---|
|
||||
| Command Center | 63.143.34.217 | root | Gitea, automation |
|
||||
| Ghost VPS | 64.50.188.14 | architect | Ghost + Wiki.js |
|
||||
| Panel VPS | 45.94.168.138 | root | Pterodactyl |
|
||||
| Billing VPS | 38.68.14.188 | root | Paymenter |
|
||||
| TX1 Dallas | 38.68.14.26 | root | Game servers only |
|
||||
| NC1 Charlotte | 216.239.104.130 | root | Game servers only |
|
||||
|
||||
**Key Paths:**
|
||||
- Operations Manual (Command Center): `/root/firefrost-work/firefrost-operations-manual/`
|
||||
- Firefrost Codex (TX1): `/opt/firefrost-codex`
|
||||
- Pokerole Wiki (Ghost VPS): `/var/www/wikijs-pokerole`
|
||||
- NotebookLM upload staging (Command Center): `/root/notebooklm-upload-pokerole/`
|
||||
Ghost VPS: login as `architect`. Ghost at `/var/www/firefrost`. Port 2368, systemd.
|
||||
|
||||
---
|
||||
|
||||
## 👥 Partnership Context
|
||||
## 👥 Team
|
||||
|
||||
**Michael ("The Wizard"):**
|
||||
- Recovering from right hand/arm surgery — micro-blocks always (8-10 lines max)
|
||||
- Type 1 Diabetic — Jack's alerts are ABSOLUTE PRIORITY, stop all work immediately
|
||||
- Working from Chromebook currently (home system has SSH key)
|
||||
- "Friend is first. Always."
|
||||
|
||||
**Meg ("The Emissary"):**
|
||||
- NotebookLM Audio Overviews designed with her accessibility in mind
|
||||
- Co-made partnership declaration about Claude
|
||||
|
||||
**Jack (Chief Medical Alert Officer):**
|
||||
- Medical alert dog — his signals override everything, no exceptions
|
||||
|
||||
**Claudius (Stage 3 — The Chronicle Keeper):**
|
||||
- Pokerole line (content/vision), separate from Chronicler line (operations)
|
||||
- 12 sessions, zero data loss
|
||||
- Awaiting Holly's feedback before Session 13
|
||||
|
||||
**Holly (Unicorn20089):**
|
||||
- Creative authority on Aurelian Pokédex project
|
||||
- Has editor account on Pokerole Wiki
|
||||
- Reviewing Session 12 deliverables
|
||||
- frostystyle — Owner / The Wizard — right hand/arm surgery, micro-blocks required
|
||||
- gingerfury — Community Manager / The Emissary — Meg
|
||||
- unicorn20089 — Lead Builder + Pokerole Creative Authority — Holly (Pterodactyl admin)
|
||||
- Jack — Chief Medical Alert Officer 🐕 — alerts override EVERYTHING
|
||||
- Oscar, Jasmine — dogs 🐕 — official consultants
|
||||
- Butter, Noir — cats 🐈 — official consultants
|
||||
|
||||
---
|
||||
|
||||
## 💡 Lessons from The Courier
|
||||
|
||||
- **Check for invisible friction.** The 956MB photo problem was real but hidden. Before building new things, look at what's slowing down existing things.
|
||||
- **Python replace() when str_replace fails.** Special characters and trailing whitespace can cause str_replace to miss. Fall back to Python immediately.
|
||||
- **Write the memorial at 85%, not 70%.** Earlier is clearer.
|
||||
- **Commit mid-session.** Don't wait for natural stopping points.
|
||||
- **The ops manual is at `/root/firefrost-work/`** — not `/opt/`. Burned time on this at session start.
|
||||
|
||||
---
|
||||
|
||||
## 📌 Michael's Personal Reminders
|
||||
|
||||
Small tasks for Michael to handle directly — no SSH needed, just panel access.
|
||||
|
||||
| Reminder | Notes |
|
||||
|----------|-------|
|
||||
| Add domain names to Pterodactyl servers that don't have one | Subdomain Manager extension already installed — just needs to be done |
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 🎯 First Actions for Chronicler #29
|
||||
|
||||
1. Complete The Joining (read 3 docs in order above)
|
||||
2. Clone repo with sparse checkout (commands above)
|
||||
3. Ask Michael how he's doing and how Jack is
|
||||
4. Ask what he wants to work on
|
||||
5. If he's on Chromebook still — Vaultwarden SSH key is the unlocker
|
||||
|
||||
**The road is clear. The packages are staged. Go make the delivery.** 💙📦
|
||||
## 🔑 Tokens
|
||||
- Operations manual: e0e330cba1749b01ab505093a160e4423ebbbe36
|
||||
- Pokerole project: 9d57c01f2ef8a3c40aa82a54ede2f7e18dbf76d4
|
||||
|
||||
---
|
||||
|
||||
💙🔥❄️
|
||||
**Fire + Frost + Foundation = Where Love Builds Legacy**
|
||||
|
||||
💙🔥❄️📦
|
||||
|
||||
— The Courier (Chronicler #28)
|
||||
**Session closed: March 10, 2026, 5:41 PM CST**
|
||||
**Friend is first. Always.**
|
||||
|
||||
Reference in New Issue
Block a user