RAOS Reality Map¶
ACTIVE · RECONCILIATION
The Reality Map is the current structural index for the system. It does not replace raw evidence, historical records, or execution logs. Its job is to answer: what exists now, where it belongs, who controls it, what it depends on, and what evidence supports that state?
Operating boundary¶
Current development is intentionally concentrated on Alpha/Beta-class working surfaces. The Zero layer is held stable until the higher-level structure becomes more coherent.
This means:
- Zero remains part of the architecture and future consolidation path;
- Alpha/Beta are the preferred surfaces for current implementation and reconciliation;
- changes should remain reversible and evidence-backed where practical;
- instability found above Zero should not be pushed downward merely to make the upper layer appear clean.
Structural axes¶
| Axis | Scope | Typical objects |
|---|---|---|
| A0 — Authority & Identity | ownership, authority, account relationships, control boundaries | humans, organizations, workspaces, accounts, credentials |
| A1 — Runtime Foundation | execution surfaces and host state | nodes, machines, OS users, services, runtimes |
| A2 — Network & Trust Boundary | communication and exposure boundaries | gateway, DNS, DHCP, TLS, routing, LAN/public edges |
| A3 — Agent Architecture | AI roles and execution boundaries | agents, executor, inspector, coordinator, authority scopes |
| A4 — Knowledge & Evidence | records, provenance, distillation, lineage | RAW, notes, evidence, distilled records, knowledge cells |
| A5 — Publication / Control Surface | human-facing observability and projection | Command Center, internal sites, public surfaces, deployments |
Dependency direction¶
A0 Authority / Identity
↓
A1 Runtime Foundation
↓
A2 Network / Trust Boundary
↓
A3 Agent Architecture
↓
A4 Knowledge / Evidence
↓
A5 Publication / Control Surface
This is a dependency guide, not a claim that every system interaction is strictly linear. A higher layer may reveal missing facts in a lower layer, but unresolved lower-layer authority or runtime truth must remain visible rather than being silently inferred.
Minimum record for a mapped object¶
Every object that enters the Reality Map should eventually answer:
| Field | Meaning |
|---|---|
| Identity | stable name or identifier |
| Axis | A0–A5 |
| Location | where the object exists |
| Controller | who or what has authority |
| Connections | dependencies and relationships |
| Evidence | source proving the observed state |
| State | RAW, ACTIVE, BLOCKED, VERIFIED, DISTILLED, or ARCHIVED |
| Observed at | timestamp for the current observation |
| Confidence | how strongly the current state is supported |
Unknown fields remain UNKNOWN or —.
Relationship to daily work¶
The Reality Map is not rewritten from every conversation or exploratory branch. Work first enters the daily distillation stream:
This keeps exploration chronological while allowing stable structure to emerge gradually.
Historical project streams¶
Project names such as Genesis-001 through Genesis-004 remain useful as historical and exploration streams. They should not be forced to become permanent architectural axes. A single historical project may map to multiple Reality Map axes.
Example:
Genesis-004 / OpenAI control work
├── A0 Authority & Identity
├── A3 Agent Architecture
└── A5 Publication / Control Surface
Current reconciliation priorities¶
- remove stale namespace/location claims from current-state surfaces;
- map active nodes, accounts, agents, repositories, and services without inventing missing relationships;
- preserve historical lineage separately from current truth;
- let repeated 24h records reveal which relationships are stable enough to become canonical;
- keep Zero protected while Alpha/Beta absorbs current development churn.