Aegis Protocol 🛡️

Self-Healing Stability Monitor for AI Agents

Version: 0.12.6
Author: Dream
License: MIT

---

Features

• 20-Dimension Monitoring: System, services, AI agent, security, maintenance
• Auto Recovery: Terminate stuck sessions, restart services, compact context
• Health Scoring: Quantified health score (0-100)
• Healing Memory: Record and learn from recovery strategies
• Result Caching: 5-minute TTL for reduced system calls

---

Commands

aegis-protocol init

Initialize configuration file

aegis-protocol status

Show system health summary

aegis-protocol check

Run full health check

aegis-protocol heal

Execute automatic recovery

aegis-protocol config

View current configuration

---

Usage Examples

# Initialize
python3 aegis-protocol.py init

# Check health
python3 aegis-protocol.py check

# Auto recover
python3 aegis-protocol.py heal

# View config
python3 aegis-protocol.py config

---

Configuration

File: ~/.openclaw/workspace/.watchdog-config.json

{
  "thresholds": {
    "sessionTimeoutMinutes": 60,
    "pm2RestartAlert": 50,
    "diskUsagePercent": 90,
    "memoryUsagePercent": 95,
    "contextUsagePercent": 80
  }
}

---

Monitoring Dimensions

Category	Checks
System	CPU, Memory, Disk, Zombies, FD, Connections
Services	PM2, Nginx, Docker, Cron
AI Agent	Sessions, Context, Tasks, Loops
Security	SSL, Updates, Git
Maintenance	Backup, Cleanup, Network

---

Health Score

Score	Status
90-100	Excellent
70-89	Good
50-69	Warning
0-49	Critical

---

Testing

# Unit tests
python3 -m pytest tests/ -v

# Coverage
python3 -m pytest tests/ --cov=aegis_protocol -v

Coverage: 82%
Tests: 20+ passing

---

Quality Metrics

Metric	Value
Type hints	>90%
Test coverage	82%
Documentation	100%
Bugs	0

---

Version History

v0.7.0 (2026-04-05)

• Result caching with 5-minute TTL
• Type hints >90% coverage
• Exception classification (4 types)
• 20-dimension monitoring
• Health scoring system

---

Aegis Protocol - The Never-Sleeping Guardian 🌀