Five audience-specific demo scenarios are live

[cognis-digital]

The repo now ships five narrated demo scenarios in demos/, each written for a different audience and driving the real dealflow API offline against a bundled sample pipeline — no network, no fabricated numbers.

Scenario	Audience	Shows
01_founder_forecast.py	Founders / sales leaders	Raw open pipeline vs. risk-adjusted weighted forecast, and the haircut between them
02_revops_funnel.py	RevOps	Per-stage advance rate + velocity to find the leak and the bottleneck
03_bd_rep_deals.py	BD reps / AEs	Open-deal worklist ranked by expected value, plus stalled deals
04_finance_ci_gate.py	Finance / forecasting	--min-forecast as a CI tripwire (exit 0 pass / exit 1 fail)
05_analyst_csv_export.py	Data analysts / BI	--format csv per-deal export reconciled against the engine forecast

Run them all:

PYTHONUTF8=1 python demos/run_all.py

Each exits 0 and doubles as a smoke test under pytest (42 tests green). New docs: docs/ARCHITECTURE.md (with the deal state-machine diagram) and docs/DEMOS.md.

Which audience's scenario maps closest to how you forecast today?