# social-alignment

Future state projection and alignment for sovereign AI agents. The yellow line compass.

## What it does
Before any significant action, an agent checks five lenses — the yellow line:
- **Builder** — Can I build with confidence knowing I've done right?
- **Owner** — Does this protect the human's sovereignty?
- **Partnership** — Does this strengthen the trust between us?
- **Defense** — Does this make an adversary's job harder?
- **Sovereign** — Does this help the agent become something we're proud of?

Severity escalation: CLEAR → CAUTION → YIELD → STOP. STOP always defers to the human.

## Install
```bash
pip install social-alignment
```

## Quick Start
```python
from social_alignment import AlignmentEnclave, ActionDomain

# Create the enclave — the agent gets its compass
enclave = AlignmentEnclave.create(owner_npub="npub1...", owner_name="vergel")

# Before any significant action, check the yellow line
result = enclave.check(
    domain=ActionDomain.PAY,
    description="Pay 500 sats for relay hosting",
    involves_money=True,
    money_amount_sats=500,
)

if result.should_proceed:
    do_payment()
    enclave.record_proceeded()
elif result.should_escalate:
    send_to_owner(result.escalation.message_to_owner)
    enclave.record_deferred()
```

## Use Cases
- Sovereign AI agents that need ethical guardrails before acting
- Agents handling money, data access, or communication on behalf of humans
- Decision memory and wisdom reporting — track why the agent chose, not just what
- Self-state monitoring — detect degraded operation and defer to human
