docs/technical_roadmap.md

Lovecasim: Technical Roadmap (Post-Audit)

Following the logic audit and idempotency fix, we are rebuilding the engine foundations for maximum stability.

🏁 Phase 1: Engine Verification

• Compilation Check: Ensure Rust engine and Python bindings build correctly.
• Basic Playability: Verify the game loop still runs via play_vs_ai.py.

🧪 Phase 2: "New Testament" Test Suite

• Integration Baseline: Create tests/test_game_flow.py (Complete loop).
• Idempotency Proof: Create tests/test_performance_idempotency.py to verify the fix for redundant triggers.
• Opcode Matrix: Test complex opcodes in isolation (Look & Choose, Select Mode).

💎 Phase 3: Action ID Unification

• Refactor Response IDs: Move all interactive choice IDs (Select Mode, Generic List) into a unified, collision-free range (e.g., 2000+ or dedicated 550-999 block).
• Update Frontend: Ensure main.js and ability_translator.js reflect the unified ID mapping.

🚀 Phase 4: Meta Rule Completion

• Implement heart_rule (Blades as Hearts).
• Implement YELL_AGAIN and RE_CHEER logic.
• Implement PREVENT_SET_PILE (Prevents moving to success pile).

---

Roadmap initiated on 2026-02-07