jester/zlh-grind
1
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity
The daily GPT grind
65 Commits 1 Branch 0 Tags 143 KiB
Markdown 100%
main
Go to file
jester 452fa59fcb docs: expand drift prevention rules with AI-specific guardrails
2026-01-18 23:58:57 +00:00
SCRATCH Create quick reference for DNS fix needed in next session 2025-12-20 23:10:20 +00:00
ANTI_DRIFT_GUARDRAIL.md docs: expand drift prevention rules with AI-specific guardrails 2026-01-18 23:58:57 +00:00
ANTI_DRIFT.md Add Console Anti-Drift Rule - enforce PTY-backed, agent-owned, WebSocket architecture, disallow log-tailing or exec-based alternatives 2026-01-18 22:50:25 +00:00
CONSTRAINTS.md docs: add network architecture constraints to prevent agent bypass 2026-01-18 23:58:28 +00:00
OPEN_THREADS.md Close console core implementation threads - mark interactive console, WebSocket, dev/game console streaming as complete 2026-01-18 22:48:45 +00:00
PORTAL_MIGRATION.md docs: add architectural boundaries to prevent frontend-agent drift 2026-01-18 23:57:55 +00:00
README.md Add Live Console (Implemented) section - PTY-backed interactive console for dev/game servers, replaces log-only approaches 2026-01-18 22:49:57 +00:00
SESSION_LOG.md Append Jan 14-18 2026 session - Agent PTY Console Breakthrough, interactive bidirectional console complete 2026-01-18 22:48:19 +00:00
SESSION_START.md Update session start - subtraction-first mindset 2025-12-28 00:16:08 +00:00
UPSTREAMS.md Add Authentication Ownership section - Portal/APIv2 responsibilities and explicit non-responsibilities 2025-12-28 22:28:12 +00:00

README.md

zlh-grind

Execution Workspace for ZeroLagHub (ZLH)

This repository exists to capture live execution context, architectural decisions, and day-to-day grind notes while building ZeroLagHub.

This is not a source-of-truth code repo. This repo preserves:

  • rationale
  • decision history
  • migration state
  • unresolved threads

It exists so long-running work can resume cleanly without re-deriving intent.

What This Repo Is For

  • GPT / Claude execution handoffs
  • Portal v2 architecture notes
  • Dashboard & Servers UX decisions
  • Agent vs API responsibility boundaries
  • Migration context from Pterodactyl → ZLH-native

Current Platform Model (Jan 2026)

Control Plane

  • API v2
    Owns:

    • auth
    • ownership
    • permissions
    • orchestration
    • routing to agents

  • ZLH Agent (inside every server/LXC)
    Owns:

    • service lifecycle
    • runtime state
    • console / output
    • in-container truth

The API does not infer server state. The agent is authoritative for runtime behavior.

Live Console (Implemented)

ZeroLagHub now provides a true interactive server console:

  • Dev servers expose a live shell (PTY-backed)
  • Game servers expose live Minecraft console access
  • Console sessions survive browser reconnects
  • No SSH, no Proxmox console access required
  • All execution occurs inside the container via the agent

This replaces all prior log-only or exec-based approaches.

Portal UX Philosophy (Locked)

Dashboard

  • Situational awareness only
  • No operational controls
  • System Health indicator (frontend ↔ backend connectivity)
  • Notices timeline (expandable, scrollable)
  • Resource summaries only

Servers Page

  • Grouped by server type (GAME / DEV)
  • Expandable server cards
  • Collapsed = status
  • Expanded = context
  • Single escalation action: System View

System View

  • Observation-first detail page
  • Runtime output, metadata, health
  • Future controls may live here
  • No AWS-style console metaphors

What This Repo Is NOT For

  • Final schemas
  • Billing logic
  • Infrastructure secrets
  • Canonical documentation

Those live elsewhere.

This repo intentionally favors clarity over completeness.