Feat/v5

.gitignore

@@ -1,3 +1,4 @@
 *configs
 storage/
-private/
+private/
+.tokensave

README.md

@@ -1,6 +1,6 @@
 # nExBot
 
-![Version](https://img.shields.io/badge/version-4.0.0-blue)
+![Version](https://img.shields.io/badge/version-5.1.0-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 ![Lua](https://img.shields.io/badge/Lua-5.1-purple)
 
@@ -16,19 +16,49 @@ Install paths:
 - **vBot:** `%APPDATA%/OTClientV8/<ServerName>/bot/nExBot`
 - **OTCR:** `~/.local/share/<otcr-data>/<ServerName>/bot/nExBot`
 
+## v5.1.0 — Tactical Intelligence, Profile Reconnect & Character-Bound State Remediation
+
+This release delivers a comprehensive remediation of state management, persistence, and tactical intelligence:
+
+- **Atomic profile switching** — CaveBot/TargetBot profile changes preserve desired ON/OFF state, commit in single transaction
+- **Character-bound state** — Per-character, per-root-profile UnifiedStorage files (schema v6), full isolation
+- **Tactical Intelligence crash safety** — `next = nil` sandbox handled, section isolation, incremental projections
+- **Analytics contract separation** — `TelemetryClient` (outbound), `HuntMetrics` (local), `ClientTelemetry` (OTClient signals)
+- **Desired vs Effective state** — Explicit inhibitors, runtime state never overwrites user preference
+- **Explicit origins** — Every mutation carries `USER`/`INITIAL_RESTORE`/`RECONNECT_RESTORE`/etc.
+- **Silent restoration** — UI restores without triggering persistence callbacks
+- **Control registry** — All toggles declaratively registered with explicit scopes
+- **Lifecycle adapter** — `onGameStart`/`onGameEnd` drive state coordinator, generation guards on all async work
+- **Performance** — ≥70% Tactical CPU reduction target, no-change projection p95 <2ms
+
+See [Release Notes](docs/RELEASE_NOTES.md) and [Remediation Summary](docs/REMEDIATION_SUMMARY.md) for details.
+
 ## Modules
 
 | Module | Function |
 |--------|----------|
 | **HealBot** | Spell/potion healing at configurable HP thresholds. 75ms response. |
 | **AttackBot** | Attack spell/rune rotation with AoE optimization |
 | **CaveBot** | Waypoint navigation, floor-change safety, supply refills, 50+ pre-built routes |
-| **TargetBot** | 9-stage priority targeting, Monster Insights AI, movement coordination |
-| **Hunt Analyzer** | Session analytics — kills/hr, XP/hr, profit, Hunt Score |
-| **Containers** | Event-driven BFS, O(1) operations, generation tracking, quiver management 🎒 |
+| **TargetBot** | 9-stage priority targeting, Tactical Intelligence integration, movement coordination |
+| **Tactical Intelligence** | Unified session analytics, monster intelligence, targeting history, resources, routes |
+| **Containers** | Event-driven BFS, O(1) operations, generation tracking, reconnect recovery coordinator, multi-level readiness, quiver management 🎒 |
 | **Follow Player** | Party hunt — stays near leader while attacking |
 | **Extras** | Anti-RS, alarms, equipment swap, combo system, push max |
 
+## Adaptive Intelligence
+
+nExBot shares combat and navigation context through one bounded intelligence runtime:
+
+- TargetBot evaluates candidates through deterministic proposal arbitration and a hard safety envelope.
+- Dynamic Lure, Pull, and wave avoidance use explicit state machines.
+- CaveBot preserves route intent across combat pauses, path failures, and recovery.
+- Twelve local models learn in `SHADOW` mode without changing actions.
+- Replay, calibration, resource tracking, learned navigation costs, and Bot Doctor diagnostics use bounded storage.
+- Adaptive tick rates reduce background work while combat and safety paths keep their priority.
+
+Open **nExBot Tactical Intelligence** from the Main tab to inspect lifecycle, targeting, routes, models, replay, resources, and diagnostics.
+
 ## Architecture
 
 ```
@@ -37,17 +67,23 @@ Install paths:
 ├── EventBus (event-driven communication)
 ├── UnifiedTick (single 50ms master timer)
 ├── UnifiedStorage (per-character JSON persistence)
+├── Adaptive Intelligence
+│   ├── immutable world snapshot + feature pipeline
+│   ├── proposal arbitration + hard safety envelope
+│   ├── bounded SHADOW models, replay, calibration, and diagnostics
+│   └── adaptive tick and optional-work budgets
 │
 ├── Containers 🎒
-│   ├── identity (physical container identity)
+│   ├── identity (physical container identity — generation+path+slot+type)
 │   ├── queue (head/tail FIFO, O(1) dequeue)
-│   ├── state_machine (13 states, generation tracking)
-│   ├── registry (O(1) lookups, incremental item index)
-│   ├── bfs (event-driven traversal)
-│   ├── scheduler (UnifiedTick integration)
-│   ├── readiness (derived snapshots)
-│   ├── quiver (paladin ownership)
-│   └── discovery (orchestrator)
+│   ├── state_machine (23 states, generation tracking, transition log)
+│   ├── registry (O(1) lookups, slot-level item index, role assignments)
+│   ├── bfs (event-driven traversal, retry counting, deduplication)
+│   ├── scheduler (priority queue, ack timeout, exhaustion backoff)
+│   ├── readiness (10-level derived snapshots)
+│   ├── client_adapter (OTClient/vBot abstraction)
+│   ├── quiver (paladin ownership, fixed slot detection)
+│   └── discovery (orchestrator + reconnect recovery coordinator)
 │
 ├── HealBot ←── player:health events
 │   └── spell_resolver (conversion functions)
@@ -57,10 +93,7 @@ Install paths:
 ├── CaveBot ←─── 250ms waypoint engine
 ├── TargetBot ←─ creature events + Monster AI
 │   ├── AttackStateMachine (sole attack issuer)
-│   ├── Monster Insights (12 AI modules)
-│   └── MovementCoordinator (intent voting)
-│
-└── Hunt Analyzer ←─ passive analytics
+│   └── Tactical Intelligence ←─ unified analytics + learning
 ```
 
 ## Documentation
@@ -71,13 +104,14 @@ Install paths:
 | [HealBot](docs/HEALBOT.md) | Healing spells, potions, conditions |
 | [AttackBot](docs/ATTACKBOT.md) | Attack spells, runes, AoE optimization |
 | [CaveBot](docs/CAVEBOT.md) | Navigation, waypoints, supply management |
-| [TargetBot](docs/TARGETBOT.md) | Combat AI, Monster Insights, movement |
+| [TargetBot](docs/TARGETBOT.md) | Combat AI, Tactical Intelligence, movement |
 | [Follow Player](docs/FOLLOW.md) | Party hunt companion |
 | [Containers](docs/CONTAINERS.md) | Container management, quiver system |
-| [Hunt Analyzer](docs/SMARTHUNT.md) | Session analytics |
+| [Tactical Intelligence](docs/INTELLIGENCE.md) | Unified analytics, learning, diagnostics, UI |
 | [Extras](docs/EXTRAS.md) | Safety, equipment, utilities |
 | [Architecture](docs/ARCHITECTURE.md) | Technical design |
 | [Performance](docs/PERFORMANCE.md) | Optimization and tuning |
+| [Adaptive Intelligence](docs/INTELLIGENCE.md) | Arbitration, learning, replay, diagnostics, and UI |
 | [FAQ](docs/FAQ.md) | Troubleshooting |
 
 ## Contributing