A minimal, open demo of a runtime stability & observability layer for AI agents.
What it shows
- Per-cycle metrics → stability signals (lock / mini-lock / out-of-lock)
- Append-only JSONL logging with rolling checksum
- Live KPIs via Prometheus exporter
- Minimal Web UI (FastAPI) for Δφ / Γ / P visualization
What it does NOT include
- No proprietary “production core” — this uses a DemoCore (black-box placeholder)
- No private algorithms or resonant transforms
cd app
python run_demo.py
python rsc_kpi_report.py --source ./logs --outdir ./reports
# optional charts from CSV:
python - <<'PY'
import json,gzip,pandas as pd,pathlib
p=pathlib.Path("./logs"); rows=[]
for f in sorted(list(p.glob("*.jsonl"))+list(p.glob("*.jsonl.gz"))):
op=gzip.open if f.suffix.endswith(".gz") else open
with op(f,"rt",encoding="utf-8") as fh:
for line in fh:
line=line.strip()
if not line: continue
try: rows.append(json.loads(line))
except: pass
df=pd.DataFrame(rows)
cols=["step","Gamma","Gamma_sm","DeltaPhi_deg","P","lock","mini_lock","lock_deg_t"]
for c in cols:
if c not in df.columns: df[c]=None
df[cols].to_csv("delta_phi_run.csv",index=False)
print("Wrote delta_phi_run.csv")
PY
python rsc_dashboard.py --csv delta_phi_run.csv --outdir ./plots
docker compose up -d
# Web UI: http://localhost:8008/
# Exporter RAW: http://localhost:9108/metrics
To re-run the demo stream:
docker compose exec demo python run_demo.py
- app/core_iface.py — public interface + safe DemoCore placeholder
- app/runtime_adapter.py — map raw signals → canonical metrics
- app/rsc_collector_v12.py — JSONL logger (rolling checksum, rotation)
- app/rsc_kpi_report.py — simple KPI report
- app/rsc_prom_exporter.py — Prometheus exporter (KPIs)
- app/rsc_webui.py — FastAPI minimal Web UI
- app/rsc_dashboard.py — optional CSV→PNG plots
- docker-compose.yml — demo + exporter + web UI
Apache License 2.0 — see LICENSE. Copyright © 2025 Freedom (Damjan Žakelj) & Harmonic Logos.
- DemoCore emulates stable behavior for demos and integration; it’s intentionally simple and non-proprietary.
- No PII is logged; IDs should be hashed in production deployments.
.png)

