217 lines
7.7 KiB
Markdown
217 lines
7.7 KiB
Markdown
# 📋 ZeroLagHub - Quick Status Reference (March 1, 2026)
|
||
|
||
**Use This For**: Quick check of what's been done recently and what needs attention
|
||
|
||
---
|
||
|
||
## ✅ What Was Completed (February 7-8, 2026)
|
||
|
||
### **1. Customer ID Standardization**
|
||
- **Decision**: Use Prisma CUID (`User.id`) everywhere
|
||
- **Impact**: No more mixed ID formats
|
||
- **Action Needed**: Frontend stop hardcoding `u-dev-001`
|
||
- **Docs**: `zlh-grind/SCRATCH/2026-02-07_customer-id-schema.md`
|
||
|
||
### **2. Prometheus + Grafana Live**
|
||
- **Status**: ✅ COMPLETE
|
||
- **Working**: HTTP service discovery, all containers being scraped
|
||
- **Next**: API metrics endpoint for portal
|
||
- **Docs**: `zlh-grind/SCRATCH/2026-02-07_prometheus-grafana.md`
|
||
|
||
### **3. Host Controls Added**
|
||
- **Backend**: ✅ Done (Start/Stop/Restart Host)
|
||
- **Frontend**: 📋 Needs wiring
|
||
- **Safety**: Delete failsafe kept
|
||
- **Docs**: `zlh-grind/SCRATCH/2026-02-07_host-controls-and-delete-failsafe.md`
|
||
|
||
---
|
||
|
||
## ✅ What Was Completed (February 21, 2026)
|
||
|
||
### **4. Game.js Implementation**
|
||
- **Status**: ✅ COMPLETE
|
||
- **What**: Dedicated game telemetry router
|
||
- **Endpoint**: `GET /api/game/servers/:vmid/players`
|
||
- **Integration**: Agent poller + Redis caching
|
||
|
||
### **5. Player Button UI Fix**
|
||
- **Status**: ✅ RESOLVED
|
||
- **Issue**: Button not rendering (flex-wrap collapse)
|
||
- **Solution**: Layout restructure + shrink-0
|
||
|
||
### **6. Engine Abstraction Strategy**
|
||
- **Decision**: Design now, implement when adding game #2
|
||
- **Action**: Add `engineType` DB field (default 'minecraft')
|
||
- **Defer**: Engine classes until Rust/Terraria development
|
||
- **Rationale**: Avoid premature abstraction
|
||
|
||
### **7. Agent Phase 1 Feature Set**
|
||
- **Status**: ✅ COMPLETE (shipped Feb 21-22)
|
||
- **Mod management**: GET/POST/PATCH/DELETE `/game/mods/*`
|
||
- **Process metrics**: `GET /metrics/process`
|
||
- **Readiness probe**: Minecraft start/restart race mitigation
|
||
- **Update system**: `ZLH_AGENT_UPDATE_MODE=notify|auto|off`
|
||
- **Docs**: `Agent_Endpoint_Specifications_Phase1.md`
|
||
|
||
---
|
||
|
||
## ✅ What Was Completed (February 22, 2026)
|
||
|
||
### **8. NeoForge Artifact Support**
|
||
- **Status**: ✅ COMPLETE (artifact tree expanded)
|
||
- **Versions**: 1.21.1, 1.21.4, 1.21.11
|
||
- **Contract**: `neoforge-installer.jar` normalized filename
|
||
- **Rationale**: 1.21.1 has 16,000+ mods; dominant NeoForge ecosystem
|
||
|
||
### **9. Artifact Resolver Strategy Decided**
|
||
- **Status**: ✅ DECIDED
|
||
- **Phase 1**: `zlh-artifactd` as Modrinth/NeoForge proxy — no local mod storage, no catalog maintenance
|
||
- **Phase 2**: Caching layer based on real usage patterns
|
||
- **Phase 3**: Full orchestrator (game jars + runtimes + mods unified)
|
||
- **Rationale**: Single-operator sustainability; ship value at each stage
|
||
|
||
### **10. Mod Platform Decision**
|
||
- **Status**: ✅ DECIDED
|
||
- **Primary source**: Modrinth API (`api.modrinth.com/v2`) — open, no key, hash provided, NeoForge filter support
|
||
- **CurseForge**: Manual SFTP upload by user (hostile download flow, defer)
|
||
- **Curated catalog**: Abandoned — Modrinth IS the catalog
|
||
|
||
---
|
||
|
||
## ✅ What Was Completed (February 23, 2026)
|
||
|
||
### **11. Mod System Now Operational**
|
||
- **Status**: ✅ COMPLETE — full lifecycle confirmed end-to-end
|
||
- **API**: Modrinth search, install/list/enable/disable/delete behind auth + ownership
|
||
- **Frontend**: Mod search drawer, installed panel, enable/disable/delete, toast notifications
|
||
- **Engine metadata bug fixed**: `engineType`/`engineVersion` contract corrected
|
||
- **Docs**: `Session_Summaries/2026-02-23_Mod-System-Operational.md`
|
||
|
||
---
|
||
|
||
## ✅ What Was Completed (March 1, 2026)
|
||
|
||
### **12. Upload Pipeline + Filesystem Consolidation**
|
||
- **Status**: ✅ IMPLEMENTED — transport tuning in progress
|
||
- **Upload model**: Direct to runtime root, atomic, no staging, no symlinks
|
||
- **Provenance**: `.zlh_metadata.json` tracking, `stat` returns `source`
|
||
- **Transport**: Switched from `fetch()` to raw `http.request` piping
|
||
- **Docs**: `Session_Summaries/2026-03-01_Upload-Pipeline-Filesystem-Consolidation.md`
|
||
|
||
---
|
||
|
||
## 🚨 Critical Outstanding Issues
|
||
|
||
1. **zlh-api NOT IN GIT** - Still empty since Dec 28 — CRITICAL RISK
|
||
2. **DNS Fix Unverified** - Can't check without API in git
|
||
3. **Frontend Customer ID** - Still hardcoding `u-dev-001`
|
||
4. **Host Controls UI** - Backend ready, frontend not wired
|
||
5. **Vanilla MC versions** - Need to add 1.21.8–1.21.11 (source: Mojang version manifest)
|
||
6. **Upload transport tuning** - Timeout categories + error logging incomplete
|
||
|
||
---
|
||
|
||
## 🚀 Active Development (Current)
|
||
|
||
### **API Work (GPT)**:
|
||
- Fix customer ID hardcoding (use `req.user.id`)
|
||
- Improve upload transport diagnostics
|
||
- Increase upload route timeout
|
||
|
||
### **Frontend (GPT)**:
|
||
- Wire host controls UI
|
||
- Fix customer ID hardcoding
|
||
|
||
### **Artifacts (User)**:
|
||
- Add vanilla 1.21.8–1.21.11 from Mojang manifest
|
||
- Confirm NeoForge installer naming contract resolved
|
||
|
||
### **User (Critical)**:
|
||
- **Push API to git** — this is the #1 blocker
|
||
|
||
---
|
||
|
||
## 📋 Full Documentation
|
||
|
||
- **Mar 1 Session**: `Session_Summaries/2026-03-01_Upload-Pipeline-Filesystem-Consolidation.md`
|
||
- **Feb 23 Session**: `Session_Summaries/2026-02-23_Mod-System-Operational.md`
|
||
- **Feb 22 Session**: `Session_Summaries/2026-02-22_Artifact-Strategy-NeoForge-Launch-Scope.md`
|
||
- **Feb 21 Session**: `Session_Summaries/2026-02-21_Game-Engine-Mod-Management-Architecture.md`
|
||
- **Feb 7 Session**: `Session_Summaries/2026-02-07_Customer-ID-Prometheus-Host-Controls.md`
|
||
- **Agent Specs**: `Agent_Endpoint_Specifications_Phase1.md`
|
||
- **Architecture Rules**: `ZeroLagHub_Cross_Project_Tracker.md`
|
||
- **Drift Prevention**: `ZeroLagHub_Drift_Prevention_Card.md`
|
||
- **Development Notes**: `jester/zlh-grind` repo
|
||
|
||
---
|
||
|
||
## 🔖 Next Session Start Here
|
||
|
||
### **For GPT (API + Frontend)**:
|
||
1. Fix customer ID hardcoding (`req.user.id`)
|
||
2. Wire host controls UI
|
||
3. Upload transport diagnostics + timeout increase
|
||
|
||
### **For User**:
|
||
1. **CRITICAL**: Push API to git
|
||
2. Add vanilla 1.21.8–1.21.11 to artifact tree
|
||
3. Verify NeoForge installer naming fix
|
||
|
||
---
|
||
|
||
## 🔒 Security Reminders
|
||
|
||
**Before User Uploads** (Phase 2):
|
||
- [ ] ClamAV + VirusTotal integration
|
||
- [ ] Quarantine workflow
|
||
- [ ] Manual review queue
|
||
- [ ] Incident logging
|
||
|
||
**Current Phase 1** (Modrinth-sourced + user uploads to allowlist only):
|
||
- ✅ Hash verification mandatory (SHA-512 from Modrinth)
|
||
- ✅ Container isolation active
|
||
- ✅ Non-root game server user
|
||
- ✅ Network segmentation enforced
|
||
- ✅ Download from trusted sources only (Modrinth, NeoForge maven)
|
||
- ✅ Upload allowlist enforced by agent
|
||
|
||
---
|
||
|
||
## 📊 Platform Progress
|
||
|
||
**Feb 7**: 93%
|
||
**Feb 21**: 94%
|
||
**Feb 22**: ~95% (agent feature set complete, artifact strategy locked)
|
||
**Feb 23**: ~96% (mod system fully operational end-to-end)
|
||
**Mar 1**: ~97% (upload pipeline implemented, filesystem model stable)
|
||
|
||
**Remaining for Launch**:
|
||
- ⚠️ API into git (blocker)
|
||
- ⚠️ Upload transport tuning
|
||
- ⚠️ Host controls UI wiring
|
||
- ⚠️ Vanilla 1.21.8–1.21.11 artifact additions
|
||
- ⚠️ Customer ID hardcoding fix
|
||
- ⚠️ Security audit
|
||
|
||
---
|
||
|
||
## 🔑 Key Architectural Decisions (Feb 21 – Mar 1)
|
||
|
||
**DEC-009**: Game-specific API organization (separate game.js)
|
||
**DEC-010**: Engine abstraction timing (design now, implement later)
|
||
**DEC-011**: Mod security model (Modrinth Phase 1, uploads Phase 2)
|
||
**DEC-012**: Developer mod pipeline (dev container → game server)
|
||
**DEC-013**: Artifact resolver Phase 1 = Modrinth proxy, no local mod storage
|
||
**DEC-014**: Modrinth as primary mod source; CurseForge = SFTP fallback
|
||
**DEC-015**: NeoForge version coverage = 1.21.1, 1.21.4, 1.21.11 only
|
||
**DEC-016**: Direct runtime upload model (no staging, no symlinks)
|
||
**DEC-017**: `.zlh_metadata.json` as provenance layer (source field on stat)
|
||
**DEC-018**: Raw http.request piping for upload proxy (no fetch streaming)
|
||
|
||
---
|
||
|
||
**Last Updated**: March 1, 2026
|
||
**Platform Status**: ~97%
|
||
**Critical Blocker**: API not in git
|
||
**Next Major Milestone**: API into git + upload transport tuning complete
|