# 🗺️ 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

```markdown
# 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.* 🗺️