Changelog¶

This page tracks significant changes to the homelab infrastructure.

2026¶

2026-07-08 - Jarvis neteng network-engineer profile¶

Category: Automation / Monitoring

Summary: Turned the Jarvis Hermes agent into an always-on homelab network engineer and wired a Grafana-native Telegram alert pipe.

Details:

• New version-controlled Jarvis profile neteng (hermes-vm/agent/profiles/neteng/): a network-engineer persona (SOUL.md) with a hard autonomy contract, a homelab knowledge pack (HOMELAB.md) seeded into the agent's memory, and an idempotent setup-neteng.sh deploy script.
• Wired the grafana-stack MCP (Loki + Prometheus on .241) into the profile so the agent can query telemetry directly; registered three cron jobs (30-min health sweep, daily digest, weekly review → Telegram), created paused pending the Nous Portal login.
• Scoped auto-fix: the agent may only restart existing containers via a revocable jarvis-neteng Portainer token; everything structural is proposed via Telegram and routed through GitOps. It annotates Grafana for every action.
• Grafana pane of glass: added a "Jarvis Ops" dashboard (agent heartbeat, firing alerts, annotation-driven incident timeline) and provisioned Grafana-managed alerting that mirrors the Prometheus ALERTS metric to a Telegram contact point — the dumb-pipe layer that fires even if the agent is down. Added a Prometheus blackbox heartbeat probe for the Jarvis dashboard on :9119.

2026-01-16 - Documentation Overhaul¶

Category: Documentation

Summary: Major documentation update with infrastructure scanning and Home Assistant API integration.

Details:

• Added Mermaid diagram support and converted all ASCII diagrams
• Added MkDocs Material QoL features (sticky nav, instant navigation, code annotations, etc.)
• Scanned PVE1 and PVE2 via SSH - documented hardware, storage, VMs, LXCs
• Connected to Home Assistant API and documented:
  • 9 add-ons with versions
  • 12 integrations
  • 164 sensors, 35 binary sensors, 8 automations
  • Lights, media players, cameras
• Created system architecture diagrams for network and Home Assistant
• Simplified docker-compose.yml (removed nginx/build services)

2026-01-16 - SSH Key Configuration¶

Category: Infrastructure

Summary: Configured SSH key access for automated Proxmox management.

Details:

• Generated ed25519 SSH key
• Deployed to PVE1 (192.168.1.199) and PVE2 (192.168.1.151)
• Enables automated infrastructure scanning

2025¶

January¶

• Initial MkDocs documentation setup

Template Entry¶

### YYYY-MM-DD - Brief Title

**Category:** Infrastructure / Services / Network / Storage

**Summary:** What changed and why.

**Details:**
- Bullet points with specifics
- Links to relevant docs if needed

**Issues encountered:**
- Any problems and their solutions