MeshDD-Bot/.claude/CLAUDE.md

MeshDD-Bot Project Memory

Workflow Rules

• Every commit must include: version bump in config.yaml + CHANGELOG.md entry
• Version is in config.yaml (field version:), NOT in a separate version.py
• Changelog format: ## [x.y.z] - YYYY-MM-DD with ### Added/Changed/Removed sections

Project Structure

• Config: config.yaml (live-reloaded via file watcher in meshbot/config.py)
• Bot: meshbot/bot.py - Meshtastic TCP, commands use config.get("bot.command_prefix")
• Web: meshbot/webserver.py - aiohttp + WebSocket
• DB: meshbot/database.py - SQLite via aiosqlite
• Scheduler: meshbot/scheduler.py - Cron-based job scheduler
• Frontend: static/ - Bootstrap 5.3 dark/light theme, AdminLTE-style layout
• Entry: main.py

Pages & Routes

• / - Dashboard (static/index.html, static/js/dashboard.js)
• /scheduler - Scheduler (static/scheduler.html, static/js/scheduler.js)
• /map - Leaflet map (static/map.html, static/js/map.js)
• /settings - Node config (static/settings.html, static/js/settings.js)
• /ws - WebSocket endpoint
• API: /api/nodes, /api/messages, /api/stats, /api/send, /api/node/config, /api/scheduler/jobs

Frontend Layout Pattern

• All pages use consistent AdminLTE-style: top-navbar (46px), sidebar (200px), content-wrapper
• Sidebar nav with active state, 4 entries: Dashboard, Scheduler, Karte, Einstellungen
• Each JS file has: theme toggle (localStorage), sidebar toggle (mobile), page-specific logic
• Shared styles in static/css/style.css

Key Details

• Meshtastic host configured in config.yaml, not env vars
• Bot start: /home/peter/meshdd-bot/venv/bin/python main.py
• Forgejo remote with token in URL
• Current version: 0.3.8
• Protobuf objects converted via google.protobuf.json_format.MessageToDict()