diff --git a/README.md b/README.md index 708efbd..afeb350 100644 --- a/README.md +++ b/README.md @@ -129,6 +129,35 @@ monitoring: port: 8080 ``` +## ๐ŸŽฎ Autonomous Mode + +**Modalitร  completamente autonoma** dove il bot esplora, impara e cresce da solo guidato dall'LLM: + +```bash +# Avvia esplorazione autonoma per 60 minuti +python -m src.autonomous_mode --duration 60 + +# Con config personalizzata +python -m src.autonomous_mode --config my_config.yaml --duration 120 +``` + +**Caratteristiche:** +- ๐Ÿค– **LLM-First**: L'LLM prende tutte le decisioni strategiche +- ๐Ÿ—บ๏ธ **Auto-Mapping**: Esplora e mappa automaticamente il mondo +- ๐Ÿง  **Learning**: Memorizza stanze pericolose, NPC utili, pattern +- ๐Ÿ“Š **Session Logging**: Salva tutto in `data/autonomous_sessions/` +- ๐ŸŽฏ **Goal Dinamici**: Obiettivi di esplorazione e crescita +- ๐Ÿ›ก๏ธ **Safety First**: Override automatico se HP critici + +**Esempio di output:** +``` +๐Ÿš€ Avviata sessione autonoma: session_20240209_143022 +๐Ÿง  Decisione LLM: [explore] north + Ragionamento: Uscita non esplorata, pericolo basso +๐Ÿ” Scoperta: [room] Village Square: You are standing in... +๐Ÿ“„ Log completo: data/autonomous_sessions/session_20240209_143022.json +``` + ## Configurable Embedding Models Choose the best embedding model for semantic room search: diff --git a/TODO.md b/TODO.md index 7949f08..3e2ecbd 100644 --- a/TODO.md +++ b/TODO.md @@ -68,7 +68,17 @@ This document outlines the implementation status of the MUD AI Player. - [x] **Statistics**: Room count, exit count, session info - [x] **Vitals Display**: HP/MP/SP bars and values -## ๐Ÿ”„ Phase 9: Testing & Quality Assurance +## โœ… Phase 9: Autonomous Mode (NEW!) + +- [x] **LLM Orchestrator**: LLM-first decision making system +- [x] **Autonomous Mode**: Standalone autonomous exploration entry point +- [x] **Session Logging**: Structured JSON logs for each session +- [x] **Learning Engine**: Memory for dangerous rooms, valuable NPCs, patterns +- [x] **Game Context**: Complete game state awareness for LLM +- [x] **Dynamic Goals**: Automatic exploration and growth objectives +- [x] **Safety Overrides**: Automatic retreat on low HP/high danger + +## ๐Ÿ”„ Phase 10: Testing & Quality Assurance - [x] **Unit Tests**: 17 test files covering all major components - [x] **Test Coverage**: ~2,500 lines of test code @@ -77,7 +87,7 @@ This document outlines the implementation status of the MUD AI Player. - [ ] **End-to-End Tests**: Integration tests with mock MUD server (planned) - [ ] **Performance Tests**: Benchmark for large maps (planned) -## ๐Ÿ”„ Phase 10: Documentation +## ๐Ÿ”„ Phase 11: Documentation - [x] **README.md**: Comprehensive project overview - [x] **Architecture.md**: System design documentation @@ -108,18 +118,24 @@ This document outlines the implementation status of the MUD AI Player. ## ๐Ÿ“Š Implementation Statistics -- **Total Lines of Code**: ~7,500 +- **Total Lines of Code**: ~8,300 (+780 nuove per Autonomous Mode) - **Test Coverage**: ~2,500 lines (17 test files) -- **Documentation**: ~3,000 lines -- **Modules**: 8 major modules -- **Components**: 30+ classes +- **Documentation**: ~3,200 lines +- **Modules**: 9 major modules (incl. Autonomous) +- **Components**: 35+ classes +- **Entry Points**: 2 (main.py + autonomous_mode.py) - **Test Pass Rate**: 100% ## ๐ŸŽฏ Current Status -**Version**: 0.1.0 -**Status**: Feature Complete โœ… +**Version**: 0.2.0 +**Status**: Autonomous Mode Available โœ… **Ready for Testing**: Yes -**Production Ready**: Stabilization & testing phase +**Production Ready**: Stabilization phase + +### ๐ŸŽฎ Modalitร  Disponibili + +1. **Interactive Mode** (`main.py`): Modalitร  standard con decision engine +2. **Autonomous Mode** (`autonomous_mode.py`): Esplorazione completamente autonoma con LLM The MUD AI Player is functionally complete with all core features implemented. The current focus is on testing, bug fixes, and documentation improvements before a stable release.