🎉 Simplified Architecture: Removed history.py, Added Default Logging

[wu-changxing]

ConnectOnion Just Got Simpler! 🚀

We've completed a major refactoring that simplifies ConnectOnion's architecture while improving the default developer experience.

What Changed

TL;DR: Removed history.py (119 lines) and consolidated to console-based logging with automatic .co/logs/ storage by default.

Before ❌

from connectonion import Agent

agent = Agent("assistant")
# No logs unless you explicitly enable them
# History saved to ~/.connectonion/agents/assistant/behavior.json
print(agent.history.summary())

After ✅

from connectonion import Agent

agent = Agent("assistant")
# Automatically logs to .co/logs/assistant.log
# Plain text, human-readable, easy to grep/tail

Why This Matters

1. Simpler Architecture (-129 lines net)

• Removed duplicate persistence (history.py + console.py did the same thing)
• One less module to maintain
• Clearer mental model

2. Better Defaults

• Old: No logging by default → users miss important debugging info
• New: Automatic logging to .co/logs/ → always have an audit trail

3. Consistent .co/ Pattern

.co/
├── keys/           # Your agent identity
├── config.toml     # Configuration
└── logs/           # Activity logs (NEW!)

4. Human-Readable Logs

Plain text format, perfect for:

• tail -f .co/logs/assistant.log - Monitor in real-time
• grep "error" .co/logs/*.log - Quick debugging
• Version control diffs

Migration Guide

If You Used History Class

Breaking Change: from connectonion import History no longer works.

Migration:

# OLD: Manual history tracking
agent = Agent("assistant")
agent.history.summary()

# NEW: Just use the logs
agent = Agent("assistant")  # Logs to .co/logs/assistant.log
# Or access trace data:
trace = agent.current_session['trace']

Logging Control

# Default: .co/logs/{name}.log
agent = Agent("assistant")

# Disable logging
agent = Agent("assistant", log=False)

# Current directory
agent = Agent("assistant", log=True)  # → assistant.log

# Custom path  
agent = Agent("assistant", log="debug/session.log")

Implementation Details

Files Changed: 30 files

• Code: 5 files
• Docs: 12 files
• Website: 7 files
• Tests: 4 files (42 history references fixed)

Test Results: ✅ 12 tests passing

Commit: 902ebaa
Issue: #10

Benefits Summary

✅ Simpler - One persistence mechanism instead of two
✅ Better defaults - Logging enabled automatically
✅ Consistent - Everything in .co/ directory
✅ Debuggable - Plain text logs you can actually read
✅ Zero config - Works out of the box

What's Next

This refactoring sets us up for:

• Better structured logging formats (JSON lines?)
• Log rotation and cleanup utilities
• Built-in log analysis tools

Thoughts? Questions? Drop a comment below! 👇

---

Following our core principle: "Keep simple things simple, make complicated things possible" ✨