feat(market): yfinance alignment + per-card tooltips + auto-refresh

[luokerenx4]

Summary

Six commits addressing three fronts surfaced while shipping the equity workbench:

yfinance field alignment (opentypebb)

• toSnakeCase was inserting underscores before every uppercase letter, so EBITDA became e_b_i_t_d_a and NetPPE became net_p_p_e. Switched to a two-pass regex that preserves acronym runs (ebitda, net_ppe, ebitda_margin).
• Each yfinance fetcher (quote, key-metrics, balance, income, cash-flow) had a partial alias dict canonicalizing to its own names. Reworked all five to emit the same snake_case canonical fields FMP emits: price_to_earnings / ev_to_ebitda / ev_to_sales / price_to_sales / gross_profit_margin / operating_profit_margin / net_profit_margin / ma50 / ma200 / market_cap / revenue / total_operating_income / income_tax_expense / consolidated_net_income / basic_earnings_per_share / diluted_earnings_per_share / short_term_debt / total_current_liabilities / total_liabilities / plant_property_equipment_net / net_cash_from_operating_activities / investing_activities / financing_activities / cash_at_end_of_period.
• Quote fetcher was also missing change / change_percent / last_timestamp aliases (→ null values despite Yahoo returning them).
• Quote schema was .strip()ing marketCap because neither the alias dict nor the schema extension declared it.

UI panel chrome

• Each market Card now carries a free-form info prop surfaced as a hover tooltip on a small circled "i" next to the title. Profile / Key Metrics / Financial Statements fill it with: data source (provider name), endpoint path, conventions in play (TTM, annual, B/M scaling), and provider-specific caveats (ratios not reported on yfinance). First cut used the native title= attribute but its ~700ms browser delay reads as "nothing is happening"; switched to a CSS-only group-hover tooltip with zero delay, multi-line rendering, and app-consistent styling.
• KeyMetricsPanel used Promise.all for metrics + ratios, which fails fast — a 500 on ratios discarded the successful metrics response along with it. Switched to Promise.allSettled so a single rejection doesn't nuke the other source.

Auto-refresh

• A tab left open overnight was showing yesterday's last print, then jumping when the user triggered any refetch. Polling added where it matters: QuoteHeader 60s, KlinePanel 60s intraday / 5min daily, KeyMetricsPanel 5min. Profile and Financial Statements don't poll — they don't change on that timescale.
• Refreshes are silent (no spinner flicker); initial load still shows loading. clearInterval + a cancelled flag handle unmount and symbol changes without double-applying stale state.

---

Additional work accumulated on dev

Three more commits landed on dev between the original push and merge; rolling them into the same PR rather than fragmenting.

Event system docs (6c12cc1)

docs/event-system.md — recipe-oriented walkthrough of how events, Listeners, and Producers fit together, with checklists for each common change (new event type, new Listener, new Producer, opening an event to HTTP) and a common-pitfalls section covering the load-bearing wiring AI sessions have historically half-done (forgetting as const on emit tuples, calling eventLog.append directly instead of declaring a Producer, opening an event to HTTP without extending webhook-ingest's tuple, registry name collisions, wildcard emit misunderstandings). CLAUDE.md gains a "Subsystem guides" pointer so future sessions read it before touching the area.

Shared connector producer (68b8e3e)

Per-connector producers (web-chat, telegram-connector) were declaring identical event tuples (['message.received', 'message.sent']) with identical payload shapes — the channel field already carried source attribution, so the two producer nodes on the Flow graph were indistinguishable. Moved the pump up to ConnectorCenter: one connectors producer declared on construction (conditional on ListenerRegistry availability, mirroring the interaction-tracker pattern), typed emitMessageReceived / emitMessageSent helpers, and symmetric stop() teardown. WebPlugin and TelegramPlugin dropped their own producer wiring and call the center directly. main.ts shutdown order: connectorCenter.stop() before listenerRegistry.stop() so the producer name is released before the registry tears down. Event-system guide updated with a special-case note so future connector authors don't reinvent per-plugin message producers.

Chat history — infinite scroll up (5519b84)

Chat had a hard-cap of 100 messages, so conversations longer than that lost earlier context — scrolling up hit the top of the loaded window but never fetched the rest. Replaced with cursor-based pagination:

• Backend — GET /api/chat/history now accepts before=<uuid> and returns { messages, hasMore }. toChatHistory attaches a cursor (= first-entry uuid) to every ChatHistoryItem — including merged tool_calls items — so the client can pass the oldest one back as before for the next page.
• Frontend — useChat exposes loadMore(), hasMore, isLoadingMore. Channel switch resets pagination state. Uses refs internally so loadMore is referentially stable (prevents ChatPage's scroll listener from re-registering on every stream tick).
• ChatPage — fires loadMore when scrollTop < 200, hasMore, not already loading. Captures scrollHeight - scrollTop before fetch; after prepend lays out, useLayoutEffect restores scrollTop so the viewport stays anchored to the same visual position. If the user returned to the bottom during the fetch, restoration is skipped — auto-scroll-to-bottom wins. A separate effect clears the captured offset if the fetch returned empty, so the next unrelated messages change doesn't use a stale offset. Top-of-container status line: "Loading older messages…" / "— beginning of history —".

Initial page size dropped 100 → 50; subsequent pages 50 each.

Test plan

• npx tsc --noEmit clean
• pnpm test — 1097 tests / 56 files pass (1088 → 1097 after the shared connector producer added 10 cases; chat pagination adjusted one existing cursor assertion)
• yfinance equity endpoints all return canonical field names (P/E, ROE, gross_profit_margin, revenue, total_operating_income, ebitda, ebit, net_cash_from_*, ma50, market_cap, change, change_percent, last_timestamp)
• Non-FMP users see Key Metrics populate (was showing error due to Promise.all fail-fast on the missing ratios endpoint)
• Hover on ⓘ icon shows multi-line tooltip instantly (Profile / Key Metrics / Financials)
• QuoteHeader and KlinePanel pick up fresh data without manual refresh
• /api/topology producers list: 3 (was 4) — cron-engine, connectors, webhook-ingest
• POST /api/chat fires message.received via shared producer, payload.channel = 'web', seq chain intact; connector-interaction-tracker still updates lastInteraction
• Chat: long conversations (>50 entries) scroll up progressively — older pages prepend without viewport jump; reach "— beginning of history —" at the active-window boundary

🤖 Generated with Claude Code