stock-brief

1# Stock brief
2 
3Give a tight, decision-useful read on **one ticker** from AlphaAI's enriched
4feed. Not a price quote — a *news* brief: what's been happening, who's buying or
5selling, and what to keep an eye on.
6 
7## Steps
8 
91. **Resolve the ticker.** If the user gave a company name, not a symbol, call
10   `alphai_tickers(q=...)` to find it. If `alphai_ticker_news` returns
11   `unknown_ticker=true`, tell the user and stop — don't invent coverage.
122. **Pull the ticker feed.** Call `alphai_ticker_news(ticker, collapse_stories=true)`.
13   `collapse_stories` folds syndicated reprints into one row each and adds a
14   `sources_count` corroboration signal — prefer it for a clean brief. Insider
15   news is included by default; keep it.
163. **Optional context.** If the user wants the wider tape, call
17   `alphai_trending(limit=5)` and note any market-level story that touches this
18   name or its sector.
194. **Deep-dive on demand.** If one story clearly drives the brief and the user
20   wants detail, fetch it with `alphai_article(uid)` for the full enrichment
21   (ticker analysis, key entities). The article *body* is not served — work from
22   the enrichment and summary.
23 
24## Output
25 
26Keep it to a screen. Structure:
27 
28- **One-line read** — the single most important thing about this name right now.
29- **Top stories** — 3–5 bullets, each: headline · relevance score · one-clause
30  "why it matters". Lead with the highest `relevance_score`.
31…