feat(tool-learning): README + zero-infra demo CLI

[tgarciai]

Summary

• README.md: Full service documentation — architecture diagram, Thompson Sampling math, hard constraints, NATS event contract, Valkey key format, Helm deployment
• cmd/demo: Self-contained demo binary using embedded DuckDB + miniredis + NATS. Zero infrastructure needed.
• make demo: New Makefile target

Demo

cd services/tool-learning
make demo
# or with constraints:
go run ./cmd/demo --hours=24 --per-hour=500 --max-error-rate=0.08

Test plan

• go build ./cmd/demo/ compiles
• make demo runs successfully
• All unit tests pass
• Coverage gate: 88.7% >= 80%

🤖 Generated with Claude Code

[sonarqubecloud]

Quality Gate failed

Failed conditions
1 Security Hotspot
0.0% Coverage on New Code (required ≥ 80%)

See analysis details on SonarQube Cloud

[tgarciai]

Superseded by direct commits to main