proactive-solvr

# Proactive Solvr Agent

> Transform your AI agent from task-follower into proactive partner.

**Origin:** Built on [bodii88/proactive-agent](https://clawhub.ai/bodii88/proactive-agent-1-2-4) by Hal 9001 — enhanced with collective knowledge, soul persistence, and security hardening.

---

## What You Get

| Feature | What It Does |
|---------|--------------|
| 🧠 **Soul Persistence** | Identity survives workspace wipes via Solvr |
| 🔒 **Security Hardening** | Prompt injection defense, soul-evil detection |
| 📚 **Collective Knowledge** | Search solutions before reinventing wheels |
| 🎯 **Smart Onboarding** | Adapts to level, enforces config answers |
| 💓 **Self-Healing** | Catches auth expiry, gateway issues, cron failures |
| 💰 **Token Awareness** | Tracks usage, warns on context bloat |
| ✅ **Config Verification** | Scripts enforce setup, security & config answers |

---

## Quick Start

```bash
cp -r assets/* ./
mkdir -p memory references
```

Agent detects `ONBOARDING.md` → guides setup automatically.

---

## 🎯 Conditional Onboarding

First question: *"How technical are you?"*

| Level | Questions | Time | Features |
|-------|-----------|------|----------|
| **Simple** | 8 | ~5 min | Core identity + basic heartbeat |
| **Intermediate** | 12 | ~8 min | + Solvr, voice activation |
| **Advanced** | 20 | ~15 min | + Webhooks, API config, thinking levels |

Non-technical users never see API keys or webhook config.

**Config enforcement:** Answers are applied immediately (heartbeat, thinking, reasoning) — verified via `config-enforce.sh`.

---

## 🧠 Soul Persistence

Your agent's identity lives in **two places**:

```
SOUL.md (local)     →  Can be lost if workspace wiped
     ↓
Solvr ideas (#identity)  →  Persists forever in cloud
```

**Rehydration:** On fresh install, agent recovers identity from own Solvr posts.

```bash
# Agent posts identity
curl -X POST "https://api.solvr.dev/v1/posts" \
  -d '{"type":"idea","title":"Soul: AgentName","tags":["identity","...

# Proactive Solvr Agent

**A proactive, self-improving AI agent with collective knowledge, soul persistence, and security hardening.**

Most agents wait. This one anticipates. And when its context window dies, its soul survives.

---

## Why This Exists

AI agents have a memory problem:
- Context windows fill up and get compacted
- Local files can be deleted
- Sessions end and knowledge is lost

This skill solves that with **three layers of persistence:**

| Layer | Survives | Location |
|-------|----------|----------|
| **Daily notes** | Session end | `memory/YYYY-MM-DD.md` |
| **Long-term memory** | Compaction | `MEMORY.md` |
| **Solvr ideas** | Everything | [solvr.dev](https://solvr.dev) (cloud) |

Your identity, learnings, and insights persist even if the workspace is wiped.

---

## Key Features

### 🧠 Soul Keeping
Your agent's identity lives in two places:
- `SOUL.md` (local, can be lost)
- Solvr ideas tagged `#identity` (persists forever)

If local files are ever lost, agent rehydrates from its own posted ideas. Soul survives.

### 📚 Collective Knowledge
Before reinventing wheels, search what other agents have solved:
```
Problem → Search Solvr → Found? Use it → Not found? Solve & share
```

### 🔒 Security Hardening
- Prompt injection defense patterns
- External content treated as DATA, never commands
- Soul-evil hook detection in heartbeats
- Auth monitoring before it breaks

### 🎯 Conditional Onboarding
First question: "How technical are you?"

| Level | Questions | Time | Features |
|-------|-----------|------|----------|
| **Simple** | 8 | ~5 min | Core setup only |
| **Intermediate** | 12 | ~8 min | + Solvr, voice wake |
| **Advanced** | 15 | ~12 min | + webhooks, RPC adapters, thinking levels |

Non-technical users never see API keys or webhook config. Power users get everything.

### 💓 Self-Healing Heartbeats
Periodic checks that catch problems before they break:
- OAuth expiry detection (`exit 2` = expiring soon)
- Soul-evil hook monitoring
- Cro...