docs: update README and TODO with Autonomous Mode

- Add Autonomous Mode section in README with usage examples
- Add new Phase 9: Autonomous Mode to TODO (completed)
- Update project statistics (8,300 LOC, 35+ classes)
- Version bump to 0.2.0
- Document both entry points (main.py and autonomous_mode.py)

Users can now choose between:
- Interactive mode: Standard gameplay with decision engine
- Autonomous mode: LLM-orchestrated exploration and learning
This commit is contained in:
truetype committed 2026-02-09 12:11:07 +01:00
1 parent a1a0ad5840
commit 72a2f1ec45
2 files changed
+54 -9

No files matched your search

+29
View File
@@ -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:
+25 -9
View File
@@ -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.