blackroad-os-archive/beacons

🗺️ Beacon Maps

Purpose: Which services/envs/orgs are alive + reachable
Updated: 2025-11-25

---

Overview

This directory contains beacon maps — append-only records of service and environment reachability.

🧪 Invariants

Every beacon map must have:

• 🧬 Stable ID: BEACON-YYYYMMDD-XXX
• ⏱️ Timestamp: Precise with timezone/UTC
• 🧭 Context tags: services tracked, environments

Entry Format

# Beacon Map: YYYY-MM-DD HH:MM:SS UTC

**ID:** BEACON-YYYYMMDD-XXX  
**Services Tracked:** [count]  
**Environments:** [list]  
**Generated By:** [agent:name | system]

---

## Service Reachability

| Service | Env | Status | Latency | Last Seen |
|---------|-----|--------|---------|-----------|
| api | prod | ✅ | 45ms | HH:MM |
| web | prod | ✅ | 32ms | HH:MM |
| operator | prod | ⚠️ | 120ms | HH:MM |

## Summary
- **Total Services:** [count]
- **Healthy:** [count]
- **Degraded:** [count]
- **Down:** [count]

## Notes
[Any anomalies or observations]

File Naming

Use: YYYY-MM-DD-beacon-map-XXX.md

Example: 2025-11-25-beacon-map-001.md

---

This is append-only history. Corrections are new entries that reference old ones. 🗺️