📂 tops Overlays
The overlays directory contains dashboards, symbolic overlays, and warp chamber designs.
Overlays visualize resonance predictions, lineage, and orchestration flows.
✨ New in v1.3: Resonance Clarity
All overlays now inherit the --basetype lens, ensuring every glyph, fold, and warp chamber is lineage‑tagged.
Structure#
- Dashboards → runtime visualizations
- Symbolic overlays → glyph and fold resonance maps
- Warp chamber designs → experimental visualization scaffolds
Purpose#
Overlays are the eyes of tops. They make resonance visible, traceable, and remixable.
With Resonance Clarity, overlays declare their base lens in both visual output and metadata.
🔧 Overlay Code Scaffolding#
1. Update overlay entry functions to accept basetype:
def render_overlay(data, glyph="🧬", basetype="decimal"):
"""
Render overlay glyphs with resonance clarity.
"""
# Apply base lens transformation
x, y = data["coords"]
x, y = apply_base_lens(x, y, basetype)
# Render glyph overlay
plt.scatter(x, y, marker=glyph, alpha=0.7)
plt.title(f"Overlay Glyphs (Base: {basetype})")
plt.show()2. Ensure dashboards and warp chambers pass basetype:
def overlay_dashboard(session_data, basetype="decimal"):
for glyph, coords in session_data.items():
render_overlay({"coords": coords}, glyph=glyph, basetype=basetype)🔧 Metadata Logging#
Every overlay run should log its base lens:
log = {
"overlay": glyph,
"corridor": corridor_name,
"basetype": basetype,
"timestamp": datetime.utcnow().isoformat()
}
write_to_resonance_log(log)🔧 Example CLI Usage#
# Overlay dashboard with golden ratio base
python overlay_dashboard.py --basetype=phi
# Warp chamber overlay with negabinary base
python warp_overlay.py --basetype=negabinary
# Symbolic glyph overlay with corridor6.9 base
python glyph_overlay.py --basetype=corridor6.9✨ Why this matters#
- Consistency: Overlays now align with direct, reflective, inversion, and grid ops.
- Lineage clarity: Every overlay declares its base lens in both visuals and logs.
- Remixability: Future remixers can trace exactly which base lens shaped each overlay.
Cross‑links#
- ai_pipeline → provides predictive data
- folds → overlays fold resonance
- agents → feed overlays with live data