longbridge · hogan-yuan · May 15, 2026 · May 15, 2026
diff --git a/docs/en/docs/cli/fundamentals/business-segments.md b/docs/en/docs/cli/fundamentals/business-segments.md
@@ -0,0 +1,61 @@
+---
+title: 'business-segments'
+sidebar_label: 'business-segments'
+sidebar_position: 15
+---
+
+# longbridge business-segments
+
+Show revenue breakdown by business segment for a company — current period totals or historical trends across reporting periods.
+
+## Basic Usage
+
+```bash
+longbridge business-segments AAPL.US
+```
+
+```
+Period: Q1 FY2026    Total: 124,300,000,000    Currency: USD
+
+| segment           | amount          | share  |
+|-------------------|-----------------|--------|
+| iPhone            | 69,140,000,000  | 55.62% |
+| Services          | 26,340,000,000  | 21.19% |
+| Mac               | 7,940,000,000   | 6.39%  |
+| iPad              | 8,090,000,000   | 6.51%  |
+| Wearables & Other | 12,790,000,000  | 10.29% |
+```
+
+## Examples
+
+### Current period breakdown
+
+```bash
+longbridge business-segments AAPL.US
+```
+
+Shows each business segment's revenue and its share of total revenue for the most recent reporting period.
+
+### Historical segment trends
+
+```bash
+longbridge business-segments AAPL.US --history
+```
+
+Returns segment revenue across multiple reporting periods so you can track how the revenue mix has shifted over time.
+
+### Filter by report type
+
+```bash
+longbridge business-segments AAPL.US --history --report af
+```
+
+Use `--report` to scope the history to a specific period type: `af` (annual), `saf` (semi-annual), `qf` (quarterly).
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--history` | Show historical segment data across multiple periods |
+| `--report <TYPE>` | Period type filter: `af` (annual), `saf` (semi-annual), `qf` (quarterly) |
+| `--format json` | Output raw JSON |
diff --git a/docs/en/docs/cli/fundamentals/financial-report.md b/docs/en/docs/cli/fundamentals/financial-report.md
@@ -59,3 +59,40 @@ longbridge financial-report 700.HK --kind BS --report af
 ```
 
 Retrieves the annual balance sheet for Tencent. Use `--report` to choose the reporting period: `af` (annual), `saf` (semi-annual), `q1`, `3q`, or `qf` (quarterly).
+
+### AI earnings snapshot
+
+```bash
+longbridge financial-report snapshot AAPL.US
+```
+
+```
+Apple Inc. (AAPL)    Q1 FY2026    Jan 2026 – Mar 2026    USD
+
+Apple delivered a solid quarter with revenue and EPS beating consensus
+estimates. Services continued to outperform, offsetting softer iPhone
+sales outside of China.
+
+── Forecast vs Actual ──────────────────────────────────────────────
+| metric        | consensus | actual  | beat/miss |
+|---------------|-----------|---------|-----------|
+| Revenue       | 123.15B   | 124.30B | +0.93%    |
+| EBIT          | 34.21B    | 35.43B  | +3.57%    |
+| Net Income    | 29.48B    | 30.52B  | +3.53%    |
+
+── Upcoming peer earnings ──────────────────────────────────────────
+| company     | ticker   | date       |
+|-------------|----------|------------|
+| Microsoft   | MSFT.US  | 2026-04-29 |
+| Alphabet    | GOOG.US  | 2026-04-29 |
+| Meta        | META.US  | 2026-04-30 |
+```
+
+The `snapshot` subcommand provides an AI-generated earnings summary, beat/miss analysis against consensus estimates, and upcoming earnings dates for peer companies.
+
+```bash
+# Specify a historical quarter
+longbridge financial-report snapshot TSLA.US --report qf --year 2025 --period 4
+```
+
+Use `--report qf --year <YEAR> --period <1-4>` to retrieve a specific quarter.
diff --git a/docs/en/docs/cli/fundamentals/industry-peers.md b/docs/en/docs/cli/fundamentals/industry-peers.md
@@ -0,0 +1,59 @@
+---
+title: 'industry-peers'
+sidebar_label: 'industry-peers'
+sidebar_position: 17
+---
+
+# longbridge industry-peers
+
+Explore the hierarchical sub-sector tree for an industry group. Takes a BK counter ID from [`industry-rank`](./industry-rank) and expands it into a full competitive landscape — sub-sectors, their sub-sectors, and the stocks in each.
+
+## Basic Usage
+
+```bash
+longbridge industry-peers BK/US/IN00258
+```
+
+```
+Root: Semiconductors (US)
+
+├── Design & Fabless  23 stocks  +3.12%  YTD +18.4%
+│   ├── GPU & AI Chips  8 stocks  +4.91%  YTD +24.1%
+│   ├── Mobile SoC  6 stocks  +2.33%  YTD +12.8%
+│   └── Analog IC  9 stocks  +1.54%  YTD +9.3%
+├── Foundry & Manufacturing  7 stocks  +2.87%  YTD +15.6%
+│   ├── Logic Foundry  3 stocks  +3.11%  YTD +19.2%
+│   └── Memory  4 stocks  +2.61%  YTD +11.9%
+└── Equipment & Materials  12 stocks  +1.43%  YTD +7.2%
+```
+
+## Examples
+
+### Explore a sector from industry-rank
+
+```bash
+# Step 1: find a sector
+longbridge industry-rank --market US
+
+# Step 2: drill into it using the counter_id column
+longbridge industry-peers BK/US/IN00258
+```
+
+### HK sector tree
+
+```bash
+longbridge industry-peers BK/HK/IN00012
+```
+
+Works the same way across markets — use counter IDs from `industry-rank --market HK`, `--market CN`, or `--market SG`.
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--format json` | Output raw JSON |
+
+## Notes
+
+- Counter IDs follow the format `BK/<MARKET>/IN<NUMBER>` — copy them directly from `industry-rank` output
+- Each node shows stock count, daily change, and YTD change
diff --git a/docs/en/docs/cli/fundamentals/industry-rank.md b/docs/en/docs/cli/fundamentals/industry-rank.md
@@ -0,0 +1,77 @@
+---
+title: 'industry-rank'
+sidebar_label: 'industry-rank'
+sidebar_position: 16
+---
+
+# longbridge industry-rank
+
+Rank all industries in a market by a chosen indicator — see which sectors are leading today, which have the strongest revenue growth, or which are attracting the most capital.
+
+## Basic Usage
+
+```bash
+longbridge industry-rank --market US
+```
+
+```
+| rank | name                                    | counter_id      | chg    | indicator |
+|------|-----------------------------------------|-----------------|--------|-----------|
+| 1    | Semiconductors                          | BK/US/IN00258   | +3.82% | ...       |
+| 2    | Software - Infrastructure               | BK/US/IN00305   | +2.91% | ...       |
+| 3    | Biotechnology                           | BK/US/IN00043   | +2.54% | ...       |
+| 4    | Electronic Components                   | BK/US/IN00099   | +1.98% | ...       |
+| 5    | Asset Management                        | BK/US/IN00033   | +1.73% | ...       |
+```
+
+The `counter_id` column (e.g. `BK/US/IN00258`) can be passed directly to [`industry-peers`](./industry-peers) to explore the competitive tree within that sector.
+
+## Examples
+
+### Leading industries today
+
+```bash
+longbridge industry-rank --market US
+```
+
+Ranks industries by daily price performance. Replace `US` with `HK`, `CN`, or `SG` to switch markets.
+
+### Top industries by market cap
+
+```bash
+longbridge industry-rank --market HK --indicator market-cap
+```
+
+### Top industries by revenue growth
+
+```bash
+longbridge industry-rank --market CN --indicator revenue-growth
+```
+
+### Then drill into a sector
+
+```bash
+# Get the counter_id from industry-rank, then explore its sub-sectors
+longbridge industry-peers BK/US/IN00258
+```
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--market <MARKET>` | Market to rank: `US`, `HK`, `CN`, `SG` |
+| `--indicator <IND>` | Ranking indicator (see below) |
+| `--format json` | Output raw JSON |
+
+### Indicators
+
+| Value | Description |
+|-------|-------------|
+| `leading-gainer` | Daily price performance (default) |
+| `today-trend` | Intraday trend strength |
+| `popularity` | Search and watchlist activity |
+| `market-cap` | Total market capitalisation |
+| `revenue` | Latest revenue |
+| `revenue-growth` | YoY revenue growth rate |
+| `net-profit` | Latest net profit |
+| `net-profit-growth` | YoY net profit growth rate |
diff --git a/docs/en/docs/cli/fundamentals/institution-rating.md b/docs/en/docs/cli/fundamentals/institution-rating.md
@@ -112,3 +112,20 @@ longbridge institution-rating TSLA.US --format json
 ```
 
 The `evaluate` object contains the per-rating counts across all 52 covering analysts. The `target` object shows the highest and lowest price targets alongside the previous close for context.
+
+### Monthly analyst sentiment trend
+
+```bash
+longbridge institution-rating TSLA.US --views
+```
+
+```
+| month   | strong_buy | buy | hold | sell | under | no_opinion | total |
+|---------|------------|-----|------|------|-------|------------|-------|
+| 2026-04 | 18         | 5   | 17   | 6    | 2     | 4          | 52    |
+| 2026-03 | 17         | 6   | 18   | 5    | 3     | 3          | 52    |
+| 2026-02 | 16         | 7   | 19   | 5    | 3     | 2          | 52    |
+| 2026-01 | 15         | 8   | 19   | 6    | 2     | 2          | 52    |
+```
+
+Shows how the buy/hold/sell distribution has shifted month by month, newest first. Use alongside `--history` (individual analyst target price changes) to get both perspectives on momentum.
diff --git a/docs/en/docs/cli/release-notes.md b/docs/en/docs/cli/release-notes.md
@@ -7,6 +7,14 @@ sidebar_icon: newspaper
 
 # Release Notes
 
+### [v0.21.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.21.0)
+
+- **New: `business-segments`** — revenue breakdown by business segment, current period or historical trend
+- **New: `industry-rank`** — industry ranking by market (US/HK/CN/SG) and indicator; counter_id output feeds directly into `industry-peers`
+- **New: `industry-peers`** — hierarchical sub-sector tree with stock count, daily change, and YTD change per node
+- **New: `financial-report snapshot`** — AI earnings summary with beat/miss analysis vs consensus estimates and upcoming peer earnings dates
+- **New: `institution-rating --views`** — month-by-month buy/hold/sell distribution timeline
+
 ### [v0.20.3](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.20.3)
 
 - **Breaking: `analyst-estimates` removed** — command has been removed; the same data is available via `consensus` (EPS and revenue estimates)