openclaw-aegis 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Canary Builds
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# OpenClaw Aegis
+
+**Self-healing sidecar for the OpenClaw Gateway.**
+
+Aegis monitors your OpenClaw gateway, detects failures in seconds, fixes them automatically, and alerts you through out-of-band channels that don't depend on the gateway being up.
+
+[![CI](https://github.com/Canary-Builds/openclaw-aegis/actions/workflows/ci.yml/badge.svg)](https://github.com/Canary-Builds/openclaw-aegis/actions/workflows/ci.yml)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+---
+
+## Why Aegis?
+
+When your OpenClaw gateway crashes, **everything goes dark** — Telegram, WhatsApp, all channels. If the crash was caused by a bad config, restarting doesn't help. The `.bak` files may contain the same poison. You only find out when you notice messages aren't arriving.
+
+Aegis prevents this:
+
+1. **Detects** failures via 10 health probes (process, port, config, memory, CPU, disk, logs, network, WebSocket, HTTP)
+2. **Diagnoses** the root cause using 6 failure pattern matchers
+3. **Fixes** automatically — restores known-good config, clears stale PIDs, runs safe `doctor --fix`
+4. **Alerts** you through channels that bypass the gateway entirely (ntfy, Telegram, WhatsApp, Slack, Discord, Email, Pushover, webhook)
+
+**Total downtime: ~15 seconds instead of hours.**
+
+---
+
+## Quick Start
+
+```bash
+# Install
+npm install -g openclaw-aegis
+
+# Configure (auto-detects your gateway)
+aegis init --auto
+
+# Verify
+aegis check
+```
+
+Output:
+```
+Health: HEALTHY (score: 10)
+Probes: 10 passed, 0 failed
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `aegis init` | Interactive setup wizard |
+| `aegis init --auto` | Auto-detect everything, zero prompts |
+| `aegis check` | Run all 10 health probes once |
+| `aegis check --json` | JSON output for scripting |
+| `aegis status` | Health dashboard with per-probe details |
+| `aegis test-alert` | Send a test notification to all configured channels |
+
+---
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Getting Started](docs/getting-started.md) | Installation, first setup, verification |
+| [Architecture](docs/architecture.md) | System design, probe pipeline, recovery tiers |
+| [Configuration](docs/configuration.md) | Full TOML reference with every option |
+| [Alerts](docs/alerts.md) | Setting up ntfy, Telegram, WhatsApp, webhooks |
+| [CLI Reference](docs/cli-reference.md) | Every command with examples and options |
+| [Contributing](docs/contributing.md) | Development setup, testing, PR process |
+
+---
+
+## How It Works
+
+```
+OpenClaw Gateway                  Aegis Sidecar
+┌─────────────────────┐          ┌──────────────────────────────┐
+│                     │          │  Health Monitor (10 probes)  │
+│  ~/.openclaw/       │◄────────►│  Config Guardian             │
+│    openclaw.json    │          │  Dead Man's Switch           │
+│    logs/            │          │  Recovery Orchestrator        │
+│                     │          │    L1: Restart               │
+│  systemd service    │◄─────────│    L2: Targeted Repair       │
+│                     │          │    L4: Human Alert           │
+└─────────────────────┘          │  Alert Dispatcher            │
+                                 │  (ntfy/TG/WA/Slack/Webhook) │
+                                 └──────────────────────────────┘
+                                          │
+                                    Out-of-band
+                                    (never through
+                                     the gateway)
+                                          │
+                                          ▼
+                                      Your phone
+```
+
+---
+
+## Requirements
+
+- Node.js >= 18
+- OpenClaw Gateway (any version with `openclaw gateway health` support)
+- Linux (systemd) or macOS (launchd)
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Built by [Canary Builds](https://github.com/Canary-Builds).

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }