v2.1.0 - Species 2: Temporal Presence

Species 2: Temporal Presence (AES-SPEC-002)

First implementation of Species 2 with SSE presence channel.

New: Presence Server

node dist/src/index.js presence start [port]

Endpoints:

Method	Endpoint	Description
GET	/presence/stream	SSE channel (text/event-stream)
POST	/presence/grant	Coupling grant endpoint
GET	/presence/status	Channel status

Signal Types (DEF-059)

• STATUS_CHANGED - State transition notification
• ENERGY_WARNING - Energy below threshold
• COUPLING_REQUESTED - Agent requested coupling
• HEARTBEAT - Connection alive (max 1/5 min)

Hard Rules

• PRESENCE_SILENCE default (CONSTRAINT-005)
• Rate limit: max 1 signal/min (CONSTRAINT-001)
• REST dominance: no heartbeat at V=0, ε=0 (CONSTRAINT-003)
• INV-006: Signal integrity with audit trail

Payload Format

{
  "type": "STATUS_CHANGED",
  "ts": "2026-01-05T20:28:56.468Z",
  "seq": 1,
  "org_hash": "bd5b24db...",
  "state": {"energy": 0.45, "V": 0, "integrity": "5/5"},
  "coupling": {"pending": 0, "urgent": 0}
}

New Files

• src/presence/ - SSE server module
• spec/AES-SPEC-002.md - Species 2 specification
• spec/ANNEX-K-NON-GOALS-V2.md - Presence prohibitions

Stats

Metric	Value
Tests	588 (+41)
Events	1053
Sessions	65

---

🤖 Generated with Claude Code