VVV Scenario Monitor — SPEC REQUIREMENTS (source of truth)

Cel: system monitorujący tempo wzrostu fundamentów VVV + ceny i OZNACZAJĄCY, na której ścieżce scenariusza jesteśmy (Bessa / Baza / Hossa). Wejście: dane on-chain VeniceStats + cena. Wyjście: cykliczny raport (Telegram + strona r.10s.pl) + stan w JSON.

Autor: Kuba (decyzje) i CEO (twarde fakty zweryfikowane 2026-09-11). Oparty na scenariuszach z wiadomości Kuby — wklejone 1:1 poniżej.

1. Tło i decyzje

Kuba dostarczył trzy scenariusze na lipiec 2027 oraz progi ROZPOZNAWCZE na styczeń 2027 ("połowa drogi") — są w sekcji 3.
Dane: już zweryfikowane w dniu pisania spec:
Cena VVV: CoinGecko simple/price?ids=venice-token&vs_currencies=usd,btc — działa, ~$23.48 (2026-09-11).
Fundamenty: VeniceStats.com + oficjalne MCP @venicestats/mcp-server (npm, v0.8.1, MIT, bez klucza, stdio lub HTTP port 3333) — 18 narzędzi: price, staking, volume, burns, protocol_overview (40+ KPI), insider_flow, large_trades, treasury, airdrop, diem, vesting, live, trends, leaderboard...
Cege i RF: VVV na Base (DexScreener token 0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf), też CEX (Bybit VVVUSDT).
KLUCZ objaw: 3 fakty (potwierdzone przez Voorheesa 17.08.2026): >$100M ARR, emisja cięta do 2.5M (1.09) i 2M VVV/rok (1.10.2026), koniec vestingu 27.01.2027. Po 27.01.2027 znika ~13.4K VVV/dzień presji podażowej (~$310K/dzień ≈ $9M/mies.).

Parametry progu fundamentów wg stanu 2026-09-11

Kanał	Stan dziś	Tempo
Nowe subskrypcje/dzień	90d: 1446 → 30d: 1671 → 7d: 1747	+8–12%/miesic
Subskrypcje miesięczne	maj 41.6K → sie 48.9K → wrz ~53K	+6–8%/mies
Kredyty API (zakupy)	sie $5.39M → wrz ~$6.0M/mies	+12%/miesic
Mix tierów	92% Pro / 7% Pro+ / 1% Max	stabilny, bez poprawy
Cena VVV	90d $16 → dołek $10.4 (lip) → $23.4	wysoka zmienne, +36%/7d

Przychód modelowy dziś: ~$160M/rok (sub ~$87M + kredyty ~$73M), P/S ≈ 7.

2. TRZY SCENARIUSZE NA LIPIEC 2027 (model Kuby — oprzyj monitoring o nie)

	Bessa	Baza	Hossa
Wzrost fundamentów	+3–4%/mies., churn 20%, kredyty w stagnacji	+7–9%/mies., churn 15%, mix bez zmian	+12%/mies., churn 10%, mix „standard", Enterprise
Przychód roczny (lip 2027)	$190–210M	$300–350M	$450–500M
P/S	4–5	6–7	12–15
Market cap	$0.8–1.0B	$2.0–2.5B	$5.5–7.5B
Cena VVV	$15–20	$38–48	$105–145
Tempo ceny	−2 do −4%/mies.	+5–7%/mies.	+16–19%/mies.
Waga	~25%	~50%	~25%

Realny poziom bazowy: ~$40–45 (mediana). Średnia ważona ~$55 (zasługa prawego ogona). Uwaga: $150 to już byłoby 6.4× do lipca 2027 — wymagałoby ~10× większej kapitału (rynek AI-inference: VVV ~$1.13B vs TAO $2.2B) i fundamentów rosnących 20%/mies. (nie 8%). Ostatni rok +748% to efekt re-rating z P/S<1, który jest wyczerpany przy P/S 7. Mix 92% Pro hamuje ARPU.

Dlaczego nie mniej: koniec vesting (01.2027) + emisja 2M/rok + buyback ~$9M/rok → netto inflacja <3% (a buyback rośnie z przychodami). Kanał kredytów jest w 100% mierzalny i rośnie dwucyfrowo. P/S 7 przy ~100% wzroście/rok jest tani względem Web2 AI-SaaS (15–30×).

3. TABELA ŚRODKOWA — PROGI ROZPOZNAWCZE NA STYCZEŃ 2027 (halfway)

Połowa drogi (do 01.2027)	Bessa	Baza	Hossa
Kredyty API / dzień	<$220K	$280–330K	>$400K
Nowe subskrypcje / dzień	<1,900	2,300–2,700	>3,200
Udział Pro+Max	8%	8–10%	>15%
Przychód roczny (model)	~$180M	$220–250M	>$300M
Cena VVV (styczeń)	$15–22	$28–34	$55–75

Interpretacja Kuby (musi być w systemie): jeśli kredyty >$300K/dzień i rejestracje >2,500/dzień w styczniu → Baza ugruntowana ($40–48 na lipiec). Jeśli kredyty <$220K/dzień — sygnał, że kanał API był startem, nie trendem (→ ryzyko Bessicy).

4. Cele systemu (co musi robić)

Co 24 h (codziennie ~06:00) odczytuje z VeniceStats (MCP lub API venicestats.com):

nowe subskrypcje/dzień (kawałki 90d/30d/7d), subskrypcje miesięczne (w skali),
kredyty API/dzień i /mies.,
mix tierów (Pro/Pro+/Max),
(opcjonalnie) burns, vesting drip, insider_flow, airdrop retention — wg dostępności MCP.

Co 24h zapisuje wszystkie wskaźniki do JSON-prostopadłego historycznego (append-only) — by policzyć tempa zmian (KPI na 30/90 dni).
Liczy tempo wzrostu (mies./dni) subskrypcji i kredytów z hortus (nie z jednego ticka) i porównuje z pasmami ścieżek scenariuszy (sekcja 2 i 3).
Określa aktualną ścieżkę: klasyfikacja do Bessa/Normal/Hossa wg tabel (waga: fundamenty 70%, cena 30% — do potwierdzenia spec). Wynik: „SCENARIUSZ: NORMAL (utwierdzony)" + pasek postępu do docelowego przedziału.
Alerty: koło domniemanych progów (np. sygnał z Bessy gdy kredyty utkną, sygnał do Hossy gdy przekroczone 3200 subs).
Raport/status: dostarczany na Telegram (raz dziennie, krótko, wg formatu "stan dzisiaj / tempo / ścieżka / co obserwować") + jednorazowa strona public HTML na r.10s.pl z aktualnym statusem (dashboard wg design 10s.pl) + stan JSON.
Tryb record: raport tygodniowy (niedziela) — porównanie do poprzedniego, zmiany tempo.

Technika (wzorzec hermes-trading-monitors):

Python (no_agent) — fetch + logika deterministyczna; LLM NIE czyta ceny.
Cron Hermes co 60 min dla szybkich sygnałów, codziennie 06:00 dla raportu i zapisu.
Stan w JSON: state/scenarios.json, historia: state/history.jsonl (append jeden wpis dziennie).
Telegram alerty przez print() w skrypcie (stdout crona idzie na Telegram).

5. Struktura projektu (repo /root/projects/vvv-fundamentals-monitor)

├── SPEC-REQUIREMENTS.md (ten plik)
├── README.md
├── scripts/
│   ├── fetch_fundamentals.py   # VeniceStats MCP (npx) lub REST venicestats.com— wybierz w spec (MCP jest public, ale jesli REST wystarczy, to mniej zależności)
│   ├── fetch_price.py          # CoinGecko/Bybit (VAT: N/A) + DexScreener fix (np. dog)
│   ├── compute_scenario.py     # tempa, klasyfikacja Bessa/Baza/Hossa, pasek postępu
│   ├── monitor.py              # orchestrator: fetch→compute→state→alerty (no_agent, cron)
│   └── report_html.py          # generuje html (design 10s.pl) → /var/www/wwww/projects/vvv-scenario-monitor/
├── state/
│   ├── scenarios.json   # ostatni stan + klasyfikacja
│   └── history.json     # wpis dzienny
└── wrapper.sh / wrapper.py -> w ~/.hermes/profiles/ceo/scripts/ (cron)

9. Kryteria akceptacji (AC) — musi spełnić po wdrożeniu:

[ ] python3 scripts/monitor.py działa bez błędów, tworzy state/history.json z datą dzisiejszą
[ ] Dane VeniceStats realnie ciągnięte (live sprawdzenie: subskrypcje/kredyty — wartość w pliku ≠ 0)
[ ] Cena VVV pobrana (CoinGecko/Bybit/DexScreener)
[ ] Klasyfikacja scenariusza zwraca Bessa/C/HDwig draw (nie NaN/brak)
[ ] JSON output w stdout (codzienny)
[ ] Raport codzienny do Telegram (krótki: https format)
[ ] Dashboard HTML na https://r.10s.pl/vvv-scenario-monitor/ HTTP 200 (design v2 jak planner)
[ ] cron: codziennie 06:00 + co 60 min sygnały (istotne zmianyp)
[ ] FINAL REPORT z realnymi URL i przykładami stan stdout

6. Zasady globalne

Zero kluczy/secretów (public endpoints tylko).
Bez npm w runtime — MCP wołany przez npx @venicestats/mcp-server --http (background, port 3333) LUB REST venicestats.com jeśli istnieje — w spec zdepp.: pierwsza próba REST (curl https://venicestats.com/api/... wg narzędzi MCP), fallback MCP. Nie podpinaj do stałej zewn.
Commit format: feat:, fix:, config:, docs:.
Nie ruszać poza /root/projects/vvv-fundamentals-monitor/ (poza cielną publikację do /var/www/projects/vvv-scenario-monitor/).
Koszt monitora Python = $0/tick; LLM supervisor opcjonalny 1×/dzień (raport treściowy).