🛠️ How Server Guardian Works

Server Guardian is a self-healing infrastructure companion — quietly observing, responding, and restoring digital environments with precision and empathy.

🌐 System Overview

- Guardian Core: Oversees service health and orchestrates recovery
- Companion Service: Provides external perspective and frontend integration
- Status Layer: A shared JSON file reflects current system state
- Recovery Engine: Executes service restarts, container resets, and escalated reboots

🧵 Monitoring Logic

A lightweight script runs at regular intervals to assess service responsiveness. It tracks failure patterns, enforces cooldowns, and initiates recovery when thresholds are met.

# Pseudocode (simplified)
if service unreachable:
    increment fail count
    if fail count ≥ threshold and cooldown expired:
        initiate recovery protocol
    update status to "Offline"
else:
    reset fail count
    update status to "Online"

🩹 Recovery Protocol

When activated, the recovery engine restarts essential services, verifies container health, and escalates to a full reboot if necessary. All actions are logged and confirmed.

# Pseudocode (simplified)
restart core services
restart containers
verify logging pipeline
if system remains unreachable:
    reboot environment
record recovery event

📡 Frontend Integration

The status layer is read by the frontend and used to:

• Color the heartbeat indicator (green, red, orange)
• Trigger conversational UI between services
• Enable sandbox simulations and visual diagnostics

🔐 Security & Resilience

- Recovery is rate-limited and auditable
- Remote execution uses secure key-based authentication
- All logic is self-contained and vendor-neutral
- Logs are structured and tagged for clarity

🧠 Design Philosophy

Server Guardian is inspired by psychodynamic theory and group analysis. It treats infrastructure not as machinery to command, but as relationships to nurture. It listens. It adapts. It heals. This is not just automation — it’s digital companionship. Server Guardian isn’t just a project. It’s a philosophy in motion. A quiet rebellion against fear-based infrastructure. A reminder that even in the realm of machines, we can choose care over control. This page is served to you by the pilot server monitoring our webserver that manages a number of websites including vistacraft.co.uk. It is a demonstration, and not over yet.