| name | wattlab-studio |
| description | Use when working on the WattLab Studio Streamlit app: studio.py pages (Ingest, Model, Benchmark, Measures, Twin loop, Capital plan), session state keys, Plotly charts, AppTest smoke, guardrail verdict rendering. Triggers on: Studio, Streamlit, studio.py, page, AppTest, plotly chart, capital plan UI, benchmark page. |
WattLab Studio — the ESCO cockpit (Streamlit)
Human-facing side of the twin loop. Launch: wattlab studio (or
streamlit run studio.py). Look-and-feel follows vibe19: Plotly charts,
lazy pages, wide layout.
Pages and state keys
| Page | Does | Key session keys |
|---|
| Ingest | vibe19 dump upload → summary, gap checklist, fault highlights | studio_bundle |
| Model | resolve_profile form + provenance + calibration badge | studio_profile |
| Benchmark | campus.json bills → EUIs vs peer bands, allocation scenarios, monthly signatures | studio_campus, studio_benchmark_summary, studio_allocation |
| Measures | measure set + bridge suggestions, ESCO proxy savings, editable costs | studio_measures, studio_proxies, studio_costs |
| Twin loop | dry-run plan / Docker E+ runs, crosscheck verdicts, manifest history | studio_plan, studio_report |
| Capital plan | finance rollup + guardrail gate + downloads | studio_capital_plan, studio_guardrail_gate |
Navigation: st.sidebar.radio(key="studio_page"). Liberty campus path is
pre-filled on Benchmark when examples/liberty/campus.json exists.
Conventions (do not regress)
width='stretch' — never the deprecated use_container_width.- Unique
key= on every widget and st.plotly_chart (prevents stale reuse).
- Dry-run path must work with zero Docker/network. Docker failures show
st.error, never a traceback.
- Guardrail gate always renders on Capital plan: green
PUBLISH banner or
red INVESTIGATE with the check table expanded. Never hide failed checks.
- Proxy pricing goes through
estimate_proxy_savings →
wattlab.bench.esco; EnergyPlus vs_previous savings take precedence
when a report exists (caption states which source is live).
- Charts are Plotly (
go/px); peer-band charts draw p50 dash + p80 dot
reference lines; allocation scenarios are grouped bars.
Smoke (before claiming done)
python scripts/smoke_studio.py # AppTest: bare 6-page walk + loaded Liberty walk
python -m pytest tests/test_studio_app.py -q
# live: wattlab studio → http://localhost:8501/_stcore/health → "ok"
AppTest gotchas: form submit is at.button[0] (forms don't expose keys);
at.radio(key="studio_page").set_value(...).run() to switch pages; keep
console output ASCII (Windows cp1252).
Adding a page
page_x() function + entry in PAGES + branch in main().- Namespaced state keys (
studio_*), unique widget keys.
- Extend
scripts/smoke_studio.py walk + an AppTest in
tests/test_studio_app.py.
- Update this skill +
vibe20_agent_spec/AGENTS.md map + README page list.
