MarekWo ff0d52e281 docs: Update documentation for persistent meshcli session architecture ...

Updated documentation to reflect the fundamental architectural change from
per-request subprocess spawning to a persistent meshcli session in meshcore-bridge.

Changes:
- Updated README.md with detailed bridge session architecture section
- Added TZ environment variable to configuration table
- Created comprehensive technical note (technotes/persistent-meshcli-session.md)
  documenting the refactor, implementation details, and benefits

Key architectural changes documented:
- Single subprocess.Popen with stdin/stdout pipes (not subprocess.run per request)
- Multiplexing: JSON adverts → .adverts.jsonl log, CLI responses → HTTP
- Real-time message reception via msgs_subscribe (no polling required)
- Thread-safe command queue with event-based synchronization
- Watchdog thread for automatic crash recovery
- Timeout-based response detection (300ms idle threshold)

This persistent session enables:
✅ Real-time message reception without polling
✅ Network advertisement logging
✅ Advanced interactive features (manual_add_contacts, etc.)
✅ Better stability and lower latency

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2025-12-28 18:10:32 +01:00

..

meshcore-cli.md

add: meshcore-cli documentation

2025-12-24 11:03:01 +01:00

persistent-meshcli-session.md

docs: Update documentation for persistent meshcli session architecture

2025-12-28 18:10:32 +01:00