Active Sprint: Protocol & Tasks

🛡️ Global Guardrails

1. Architectural Integrity

• Strict File Ownership: Agents MUST NOT edit files outside their assigned domains.
• Zero Panic Policy: Usage of .unwrap() or .expect() in runtime systems is FORBIDDEN.
• Modular Design: Files > 300 lines must be refactored.

2. Frontend Guardrails (loh-website)

• Aesthetic Standard: All Pages must be "Awwwards Worthy". Premium textures, glassmorphism, and micro-animations are mandatory.
• Component Reusability: Do not duplicate UI logic. Extract shared components (e.g., FounderPacks, TurnstileWidget) to components/ before using them in multiple pages.
• Bot Protection: All public forms (Login, Register, Waitlist) MUST include Cloudflare Turnstile.
• Cloudflare Optimization:
  • Cache: Static pages must use Cache-Control headers for Edge caching.
  • Compute: Workers must stick to Free Tier limits (10ms CPU). Use KV for reads, batch D1 writes.

3. Rust Guardrails (loh-game)

• Type Safety: Use Newtypes for IDs (struct PlayerId(Uuid)).
• Toolchain: Keep rust-toolchain.toml updated to latest stable.
• Data Funneling: All game events must be structured to allow eventual export to ClickHouse/Postgres.

👷 Agent 1: Web & Account (Active)

✅ Completed

• Store Content:
  • Updated Bonds to "Passive Income (10k/week)".
  • Added "Not Play-to-Win" Crowdfunding Disclaimer.
  • Synced content with "Crowdfunding Phase" narrative.
• Store Design:
  • Refactored store/page.tsx to use shared FounderPacks component.
  • Added cursor-pointer and hover effects to all cards.
  • Verified mobile responsiveness.
• Bot Protection:
  • Created TurnstileWidget.
  • Integrated into Login/Register pages.
  • Updated API client for captcha tokens.

🚧 In Progress / Next Steps

🛠️ Account API (Cloudflare Workers)

• Optimization: Implement heavy KV caching for session/profile reads.
• Endpoints:
  • POST /auth/login (Verify Turnstile token + checking password)
  • POST /auth/register (Verify Turnstile token + creating user in D1)
  • GET /me (Return Profile + Founder Status via KV Cache)
• Payment Stub:
  • POST /api/v1/founder/upgrade (Implemented as stub).

🛠️ Agent 2: Engine Stability

🚧 Priority Tasks

🦀 Rust Modernization

• Upgrade Toolchain: Update rust-toolchain.toml to latest stable.
• Dependencies: cargo update & align with 2021/2024 edition.
• Lint Fixes: Fix any new Clippy warnings from the upgrade (Done via standard suppression/fixes).

🚨 Panic Removal (Heavy Bug Fixing)

• Fix Panics in:
  • src/systems/ui/xp_drops.rs (Migrated to Event System)
  • src/systems/ui/milestone_notifications.rs (Migrated to Event System)
  • src/systems/ui/login.rs (Migrated to Event System)
  • src/systems/camera/mod.rs (Migrated to Event System)

🔄 Event Migration (Bevy 0.17)

• Migrate network/mod.rs events (Pending verify).
• Migrate world/resources.rs (Pending verify).

🏗️ Agent 3: Gameplay & Economy

🚧 Priority Tasks

💰 Economy & Bonds

• Fix Compilation: Resolve systems/economy build errors.
• Bond Logic:
  • Implement PassiveIncome trait/struct for Bonds.
  • Logic: Grant 10,000 gold/week to owner's bank.
  • Ensure EconomyUiState reflects this correctly (Via shared trait).

🎓 Tutorial Island

• Spawn Points: Implement Editor placement logic.
• NPC AI: Integrate big-brain for Guide NPC.