NARRADOR.IA

# 📝 Update 1.4 - The Cognitive Engine Awakening / O Despertar do Motor Cognitivo

*(Scroll down for Portuguese / Role para baixo para Português)*

---

## 🇺🇸 English (EN)

### ✨ New Features & Narrative Improvements
* **Hierarchical Decision Engine:** Edson no longer gets confused by simultaneous events. A new strict decision tree (Waterfall) ensures perfect narrative priority. For example, a brutal death will now correctly override the celebration of a recent achievement, and a new achievement will correctly interrupt an "idleness" scolding.
* **Cognitive Chat Shielding (Anti-Injection):** Edson's persona is now fully protected against player manipulation attempts. The AI will no longer break character if a player tries to give it system commands via the in-game chat. Instead, the chat content is heavily mocked.
* **Narrative Entropy (Anti-Repetition):** Added guided randomness to specific scenarios (like achievements) to prevent "template overfitting". Edson will now react from completely different angles instead of repeating the same sentence structure.

### 🛠️ Architectural Changes
* **Dry Boundary Architecture:** Strict separation of concerns between the Client (Java) and the Server (Python). The Java mod now acts as a lightweight sensor, dispatching only raw data (like pure Y-level coordinates and boolean flags), leaving all semantic translation and narrative load to the Python core.
* **Token Output Optimization:** Precisely adjusted the AI generation limit to 138 tokens. This completely eradicates the "guillotine effect" (abruptly cut sentences) while maintaining low latency and preventing the AI from creating endless monologues that bottleneck the TTS engine.

### 🐛 Bug Fixes
* **Sensor Cleanup:** Fixed an issue where the Java listener would send "ghost" items to the AI (such as tracking "Air" as a picked-up block, or flooding the log with inventory dumps upon player death). Telemetry noise is now zero.

---

## 🇧🇷 Português (PT-BR)

### ✨ Novos Recursos e Melhorias Narrativas
* **Motor Hierárquico de Decisão:** O Edson não se confunde mais com eventos simultâneos. Uma nova árvore de decisão estruturada garante prioridade narrativa perfeita. Por exemplo, uma morte trágica agora interromperá corretamente a celebração de uma conquista recente, e uma conquista interromperá uma bronca de ociosidade.
* **Blindagem Cognitiva de Chat (Anti-Injection):** A persona do Edson agora está 100% protegida contra tentativas de manipulação por parte dos jogadores. A IA não quebrará mais o personagem se um jogador tentar dar comandos de sistema pelo chat do jogo. Em vez disso, o conteúdo do chat vira munição para deboche.
* **Entropia Narrativa (Anti-Repetição):** Adicionada aleatoriedade guiada para cenários específicos (como conquistas) para evitar o vício de estrutura ("preenchimento de formulário"). O Edson agora reagirá usando ângulos completamente diferentes em vez de repetir o mesmo esqueleto de frase.

### 🛠️ Mudanças Arquiteturais
* **Arquitetura de Fronteira Seca (Dry Boundary):** Separação estrita de responsabilidades entre o Cliente (Java) e o Servidor (Python). O mod em Java agora atua como um sensor leve, despachando apenas dados brutos (como coordenadas Y puras e flags booleanas), transferindo todo o peso de tradução semântica para o motor em Python.
* **Otimização de Saída de Tokens:** O limite de geração da IA foi calibrado cirurgicamente para 138 tokens. Isso erradica o problema de frases cortadas de forma abrupta ("efeito guilhotina"), mantendo a latência baixa e impedindo a IA de gerar monólogos infinitos que travavam a síntese de áudio.

### 🐛 Correções de Bugs
* **Limpeza de Sensores:** Corrigido um problema onde o mod enviava itens "fantasmas" para a IA (como registrar blocos de "Ar" no inventário ou inundar o log com todos os itens dropados no momento da morte). O ruído da telemetria foi completamente zerado.