alphacouncil-agent 1.0.0 → 1.0.2

package/mcp/lib/fund-observations.mjs

@@ -0,0 +1,152 @@
+/**
+ * An append-only ledger of what each run saw about a fund's size.
+ *
+ * A flow is shares created minus shares redeemed, priced. Two dated share counts are the whole
+ * input, and no issuer serves a history of them keylessly: iShares publishes today's count in
+ * the holdings file and answers 404 for a dated one, Invesco and Vanguard publish none at all.
+ *
+ * So the history is built rather than fetched. Every run already retrieves the holdings file;
+ * recording what it said costs nothing and makes the second run onward able to compute a flow
+ * exactly, by the arithmetic `fundFlow` already implements.
+ *
+ * This bootstraps, it does not backfill, and that is the honest trade. A user who looks at SOXX
+ * weekly has weekly flows from the second week. It is not a vendor flow series and the fact
+ * built from it says so.
+ *
+ * What this deliberately does NOT do is derive a flow from a change in assets. Assets move with
+ * the market and with creations, and reporting the sum as the second is how this number gets
+ * faked — in the direction that makes a rally look like conviction.
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve, sep } from "node:path";
+
+import { DATA_DIR } from "./constants.mjs";
+
+const LEDGER_DIRNAME = "fund-observations";
+
+/** Keep a bounded history per fund; a flow only ever reads the two most recent rows. */
+export const MAX_OBSERVATIONS_PER_FUND = 400;
+
+const SYMBOL = /^[A-Z0-9][A-Z0-9.\-^]{0,15}$/u;
+
+export function observationsRoot(dataDir = DATA_DIR) {
+  return join(dataDir, LEDGER_DIRNAME);
+}
+
+/**
+ * The ledger file for one symbol.
+ *
+ * A symbol arrives from a caller and becomes a path, so it is validated against a shape rather
+ * than escaped: anything with a separator or a traversal segment is refused outright.
+ */
+export function observationFile(symbol, dataDir = DATA_DIR) {
+  const upper = String(symbol || "").trim().toUpperCase();
+  if (!SYMBOL.test(upper)) throw new Error(`unsafe fund symbol for a ledger path: ${JSON.stringify(symbol)}`);
+  const root = observationsRoot(dataDir);
+  const file = resolve(root, `${upper.replace(/[^A-Z0-9]/gu, "_")}.json`);
+  if (dirname(file) !== resolve(root)) throw new Error(`ledger path escaped its root: ${file}`);
+  return file;
+}
+
+function readLedger(file) {
+  if (!existsSync(file)) return [];
+  try {
+    const parsed = JSON.parse(readFileSync(file, "utf8"));
+    return Array.isArray(parsed?.observations) ? parsed.observations : [];
+  } catch {
+    // A corrupt ledger is not a reason to fail a research run. It is a reason to start a new
+    // one, and to lose the history rather than to report a flow computed from garbage.
+    return [];
+  }
+}
+
+function finite(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+
+/**
+ * Record one dated observation and return the ledger.
+ *
+ * Idempotent per as-of date: the same trading day seen twice does not create two rows, because
+ * a flow between two rows of the same date is zero and would read as a real zero.
+ */
+export function recordFundObservation({
+  symbol,
+  asOf,
+  sharesOutstanding = null,
+  sharesBasis = null,
+  nav = null,
+  netAssets = null,
+  sourceUrl = null,
+  dataDir = DATA_DIR,
+} = {}) {
+  if (!asOf || !/^\d{4}-\d{2}-\d{2}$/u.test(String(asOf))) return { observations: [], recorded: false };
+  if (!finite(sharesOutstanding) && !finite(netAssets)) return { observations: [], recorded: false };
+  const file = observationFile(symbol, dataDir);
+  const existing = readLedger(file);
+  if (existing.some((row) => row.as_of === asOf)) return { observations: existing, recorded: false };
+  const observations = [...existing, {
+    as_of: asOf,
+    shares_outstanding: finite(sharesOutstanding) ? sharesOutstanding : null,
+    // How the count was obtained decides whether it may price a flow. See `flowInputs`.
+    shares_basis: sharesBasis || null,
+    nav: finite(nav) ? nav : null,
+    net_assets: finite(netAssets) ? netAssets : null,
+    source_url: sourceUrl || null,
+  }]
+    .sort((left, right) => left.as_of.localeCompare(right.as_of))
+    .slice(-MAX_OBSERVATIONS_PER_FUND);
+  mkdirSync(dirname(file), { recursive: true });
+  writeFileSync(file, `${JSON.stringify({ schema_version: 1, symbol: String(symbol).toUpperCase(), observations }, null, 2)}\n`, "utf8");
+  return { observations, recorded: true };
+}
+
+/**
+ * Share counts an issuer actually published. Nothing else may price a flow.
+ *
+ * Where an issuer publishes no count this repository reconstructs one from disclosed assets
+ * over price, which is fine for a market capitalisation -- the product is the size we already
+ * had. It is NOT fine for a flow. A flow is a DIFFERENCE of two counts, so it subtracts away
+ * the number and leaves the noise: assets carry the error of a 95%-priced position sum, price
+ * carries the fund's premium or discount, and half a percent at each end of a $300bn fund
+ * manufactures $1.5bn of flow that never happened. Worse, that error is not centred on zero
+ * from a reader's point of view -- it appears as conviction exactly when the market moved.
+ */
+const FILED_SHARE_BASES = new Set([
+  "issuer_disclosed_shares_outstanding",
+  // Assets and net asset value published by the same issuer on the same date. Their ratio is
+  // shares outstanding by definition, not an approximation of it, so differencing two of them
+  // is differencing two share counts.
+  "issuer_aum_over_nav",
+]);
+
+/**
+ * The two most recent observations that can price a flow, and how far apart they are.
+ *
+ * The gap matters and is returned rather than hidden: a flow measured across forty days is not
+ * a daily flow, and a reader who cannot see the gap will read it as one.
+ */
+export function flowInputs(observations) {
+  const priced = (observations || []).filter((row) => (
+    finite(row?.shares_outstanding) && FILED_SHARE_BASES.has(row?.shares_basis)
+  ));
+  if (priced.length < 2) return null;
+  const prior = priced.at(-2);
+  const latest = priced.at(-1);
+  const nav = finite(latest.nav)
+    ? latest.nav
+    : (finite(latest.net_assets) && latest.shares_outstanding > 0
+      ? latest.net_assets / latest.shares_outstanding
+      : null);
+  if (!finite(nav) || nav <= 0) return null;
+  return {
+    sharesNow: latest.shares_outstanding,
+    sharesPrior: prior.shares_outstanding,
+    nav,
+    asOf: latest.as_of,
+    priorAsOf: prior.as_of,
+    gapDays: Math.round((Date.parse(latest.as_of) - Date.parse(prior.as_of)) / 86_400_000),
+    netAssets: finite(latest.net_assets) ? latest.net_assets : latest.shares_outstanding * nav,
+  };
+}

package/mcp/lib/fundamentals.mjs

@@ -717,7 +717,12 @@ function shareCount(series, cik, gaps) {
     valueKind: "count",
     value: Math.round(entry.value),
     unit: "shares",
-    alignment,
+    // A count is carried as a point-in-time quantity rather than as a span. It exists to be a
+    // denominator under a market capitalisation, where what matters is how many shares there
+    // are and not which window they were averaged over -- and a fund's share count, which is
+    // a genuine instant, could satisfy no duration contract at all. The averaging basis stays
+    // stated in `assumptions` rather than being implied by an interval.
+    alignment: { ...alignment, suppressInterval: true },
     cik,
     derivation: "reported",
     inputs: { diluted_shares: entry.value, tag: entry.tag },

package/mcp/lib/funds.mjs

@@ -54,11 +54,36 @@ import { fetchText } from "./quotes.mjs";
 export const FUND_REGISTRY = Object.freeze({
   IVV: { issuer: "ishares", name: "iShares Core S&P 500 ETF", product_id: "239726", cusip: "464287200" },
   IWM: { issuer: "ishares", name: "iShares Russell 2000 ETF", product_id: "239710", cusip: "464287655" },
+  SOXX: { issuer: "ishares", name: "iShares Semiconductor ETF", product_id: "239705", cusip: "464287523" },
+  IYW: { issuer: "ishares", name: "iShares U.S. Technology ETF", product_id: "239522", cusip: "464287721" },
+  IYF: { issuer: "ishares", name: "iShares U.S. Financials ETF", product_id: "239508", cusip: "464287788" },
+  IYH: { issuer: "ishares", name: "iShares U.S. Healthcare ETF", product_id: "239511", cusip: "464287762" },
+  IYE: { issuer: "ishares", name: "iShares U.S. Energy ETF", product_id: "239507", cusip: "464287796" },
+  IBB: { issuer: "ishares", name: "iShares Biotechnology ETF", product_id: "239699", cusip: "464287556" },
+  IGV: { issuer: "ishares", name: "iShares Expanded Tech-Software Sector ETF", product_id: "239771", cusip: "464287515" },
+  ITB: { issuer: "ishares", name: "iShares U.S. Home Construction ETF", product_id: "239512", cusip: "464288752" },
+  IWF: { issuer: "ishares", name: "iShares Russell 1000 Growth ETF", product_id: "239706", cusip: "464287614" },
+  IWD: { issuer: "ishares", name: "iShares Russell 1000 Value ETF", product_id: "239708", cusip: "464287598" },
+  IJH: { issuer: "ishares", name: "iShares Core S&P Mid-Cap ETF", product_id: "239763", cusip: "464287507" },
+  IJR: { issuer: "ishares", name: "iShares Core S&P Small-Cap ETF", product_id: "239774", cusip: "464287804" },
+  IEFA: { issuer: "ishares", name: "iShares Core MSCI EAFE ETF", product_id: "244049", cusip: "46432F842" },
+  EEM: { issuer: "ishares", name: "iShares MSCI Emerging Markets ETF", product_id: "239637", cusip: "464287234" },
   EFA: { issuer: "ishares", name: "iShares MSCI EAFE ETF", product_id: "239623", cusip: "464287465" },
   AGG: { issuer: "ishares", name: "iShares Core U.S. Aggregate Bond ETF", product_id: "239458", cusip: "464287226" },
   TLT: { issuer: "ishares", name: "iShares 20+ Year Treasury Bond ETF", product_id: "239454", cusip: "464287432" },
   HYG: { issuer: "ishares", name: "iShares iBoxx $ High Yield Corporate Bond ETF", product_id: "239565", cusip: "464288513" },
   SPY: { issuer: "ssga", name: "SPDR S&P 500 ETF Trust", slug: "spy", cusip: "78462F103" },
+  XLK: { issuer: "ssga", name: "Technology Select Sector SPDR Fund", slug: "xlk" },
+  XLF: { issuer: "ssga", name: "Financial Select Sector SPDR Fund", slug: "xlf" },
+  XLE: { issuer: "ssga", name: "Energy Select Sector SPDR Fund", slug: "xle" },
+  XLV: { issuer: "ssga", name: "Health Care Select Sector SPDR Fund", slug: "xlv" },
+  XLI: { issuer: "ssga", name: "Industrial Select Sector SPDR Fund", slug: "xli" },
+  XLY: { issuer: "ssga", name: "Consumer Discretionary Select Sector SPDR Fund", slug: "xly" },
+  XLP: { issuer: "ssga", name: "Consumer Staples Select Sector SPDR Fund", slug: "xlp" },
+  XLU: { issuer: "ssga", name: "Utilities Select Sector SPDR Fund", slug: "xlu" },
+  XLB: { issuer: "ssga", name: "Materials Select Sector SPDR Fund", slug: "xlb" },
+  XLRE: { issuer: "ssga", name: "Real Estate Select Sector SPDR Fund", slug: "xlre" },
+  XLC: { issuer: "ssga", name: "Communication Services Select Sector SPDR Fund", slug: "xlc" },
   QQQ: { issuer: "invesco", name: "Invesco QQQ Trust Series 1", cusip: "46090E103" },
   QQQM: { issuer: "invesco", name: "Invesco NASDAQ 100 ETF", cusip: "46138G649" },
   VOO: { issuer: "vanguard", name: "Vanguard S&P 500 ETF", ticker: "VOO", cusip: "922908363" },
@@ -462,7 +487,17 @@ export const LOOK_THROUGH_METRICS = Object.freeze({
   "growth.revenue_growth": { kind: "rate", aggregation: "weighted_arithmetic_mean", reciprocal_of: null },
   "growth.earnings_growth": { kind: "rate", aggregation: "weighted_arithmetic_mean", reciprocal_of: null },
   "leverage.debt_to_equity": { kind: "ratio", aggregation: "weighted_arithmetic_mean", reciprocal_of: null },
+  // Cash conversion sits around one and is bounded in practice, so the weighted mean of the
+  // ratios is the portfolio ratio to within the usual dispersion caveat.
+  "accounting.cash_conversion": { kind: "ratio", aggregation: "weighted_arithmetic_mean", reciprocal_of: null },
+  "profitability.incremental_return_on_capital": { kind: "rate", aggregation: "weighted_arithmetic_mean", reciprocal_of: null },
+  // Interest coverage is a MULTIPLE, and an arithmetic mean of multiples is dominated by
+  // whichever constituent carries almost no debt -- one company at 900x drags a basket of
+  // thinly covered names to "comfortably covered". The harmonic mean averages the thing that
+  // actually adds up across a portfolio, which is interest expense per unit of profit.
+  "coverage.interest_coverage": { kind: "price_multiple", aggregation: "weighted_harmonic_mean", reciprocal_of: null },
   "leverage.net_debt_to_ebitda": { kind: "ratio", aggregation: "weighted_arithmetic_mean", reciprocal_of: null },
+  "profitability.return_on_equity_10y": { kind: "rate", aggregation: "weighted_arithmetic_mean", reciprocal_of: null },
 });
 
 /**

package/mcp/lib/grounding.mjs

@@ -4,6 +4,9 @@ import { getMacroSnapshot } from "./macro.mjs";
 import { fetchMacroSeries } from "./fred.mjs";
 import { fetchFundamentals } from "./fundamentals.mjs";
 import { fetchInsiderOwnership } from "./insider-ownership.mjs";
+import { INDEX_PROXIES, normalizeIndexSymbol } from "./index-aggregate.mjs";
+import { SECTOR_SPDRS, fetchCrossMarket, fetchSectorDispersion } from "./cross-market.mjs";
+import { fetchBasketNews } from "./basket-news.mjs";
 import { gatherInstrumentFacts, LOOK_THROUGH_FACT_IDS } from "./instrument-facts.mjs";
 import { fetchOptionsChain } from "./options.mjs";
 import { screenTicker } from "./screen.mjs";
@@ -77,6 +80,11 @@ async function safely(label, fn) {
  * @param {boolean} [options.options] include the delayed CBOE option-chain digest for US listings
  * @param {string} [options.asOf]     only use filings filed by this date
  */
+/** The tracking ETF whose listed chain stands in for a cash index. */
+function indexProxyEtf(symbol) {
+  return INDEX_PROXIES[normalizeIndexSymbol(symbol)]?.etf || null;
+}
+
 export async function gatherGrounding({
   symbol,
   cik,
@@ -170,6 +178,21 @@ export async function gatherGrounding({
     }));
   } else if (symbol && options && symbolMarket?.id === "US" && !out.instrument.index_like) {
     out.unavailable.push("options chain: historical cutoff requires an archived chain; current CBOE snapshot was not fetched");
+  } else if (symbol && options && out.instrument.index_like && indexProxyEtf(symbol) && snapshotPolicy.allowed) {
+    // A cash index has no chain of its own on this adapter, and its tracking ETF does. The
+    // holdings path already answers "the index itself is licensed, so read the tracker and say
+    // so"; a volatility surface is the same problem and gets the same answer. What must not
+    // happen is the substitution going unlabelled -- an ETF's implied volatility is not the
+    // index's, and a reader comparing them needs to know which one this is.
+    const proxy = indexProxyEtf(symbol);
+    jobs.push(safely("options chain", () => fetchOptionsChain(proxy, { asOf, signal })).then((r) => {
+      if (r.ok && r.value?.available) {
+        out.options = { ...r.value, proxy_for: normalizeIndexSymbol(symbol), is_proxy: true,
+          proxy_note: `${proxy} option chain used as an explicit proxy; the cash index has no chain on this adapter` };
+      } else {
+        out.unavailable.push(r.ok ? `options chain via ${proxy}: ${r.value?.reason || "unavailable"}` : r.error);
+      }
+    }));
   } else if (symbol && options && out.instrument.index_like) {
     out.not_applicable.push(localizedText(language, {
       en: "CBOE equity/ETF option-chain adapter: direct cash-index symbol is not supported; use the appropriate listed derivative or ETF proxy explicitly",
@@ -179,6 +202,22 @@ export async function gatherGrounding({
     }));
   }
 
+  // What else is this a bet on. Only for baskets: a single company's correlation to KOSPI is a
+  // fact about its sector, not about the company, and the seats that reason about crowding and
+  // position size are asking about the basket.
+  if (symbol && isFundOrIndex(out.instrument)) {
+    jobs.push(safely("cross-market", () => fetchCrossMarket(symbol, { signal })).then((r) => {
+      if (!r.ok) { out.unavailable.push(r.error); return; }
+      if (r.value.facts.length) out.cross_market = r.value.facts;
+      out.unavailable.push(...r.value.unavailable);
+    }));
+    jobs.push(safely("sector dispersion", () => fetchSectorDispersion(SECTOR_SPDRS, { signal })).then((r) => {
+      if (!r.ok) { out.unavailable.push(r.error); return; }
+      if (r.value.available) out.sector_dispersion = r.value;
+      out.unavailable.push(...(r.value.unavailable || []));
+    }));
+  }
+
   if (cik) {
     if (snapshotPolicy.allowed) {
       // Resolve the registrant before deciding whether Company Facts applies. Scheduling
@@ -285,7 +324,7 @@ export async function gatherGrounding({
   // instead: published holdings, index-level valuation and the look-through aggregates that
   // let an operating-company method run against a basket at all.
   if (symbol && isFundOrIndex(out.instrument) && snapshotPolicy.allowed) {
-    jobs.push(safely("instrument aggregate", () => gatherInstrumentFacts({
+    const instrumentJob = safely("instrument aggregate", () => gatherInstrumentFacts({
       symbol, instrument: out.instrument, asOf, signal,
       // The operating-company facts a basket can supply at all: everything the method seats
       // ask of a company, aggregated by weight across the constituents that publish it.
@@ -294,7 +333,21 @@ export async function gatherGrounding({
       if (!r.ok) { out.unavailable.push(r.error); return; }
       out.instrument_aggregate = r.value;
       out.unavailable.push(...(r.value.unavailable || []));
-    }));
+    });
+    jobs.push(instrumentJob);
+    // A basket has no press office and files nothing, so its news comes from what it holds.
+    // Chained after the instrument pass rather than run beside it, because the holdings are
+    // what name the industry -- fetching them twice to avoid the wait would cost more than it
+    // saves.
+    jobs.push((async () => {
+      await instrumentJob;
+      const holdings = out.instrument_aggregate?.holdings;
+      if (!holdings?.length) return;
+      const news = await safely("basket news", () => fetchBasketNews(holdings, { asOf, signal }));
+      if (!news.ok) { out.unavailable.push(news.error); return; }
+      if (news.value.available) out.basket_news = news.value;
+      out.unavailable.push(...(news.value.unavailable || []));
+    })());
   }
 
   if (symbol && isFundOrIndex(out.instrument)) {

package/mcp/lib/index-aggregate.mjs

@@ -124,6 +124,20 @@ export const INDEX_PROXIES = Object.freeze({
     licensor: "Nasdaq, Inc.",
     why: "Nasdaq publishes NDX membership itself, but weights still come from the tracking ETF, so the same proxy labelling applies",
   }),
+  "^SOX": Object.freeze({
+    index_name: "PHLX Semiconductor Sector",
+    etf: "SOXX",
+    alternates: Object.freeze(["SMH", "SOXQ"]),
+    licensor: "Nasdaq, Inc.",
+    why: "PHLX Semiconductor membership and its modified-cap weights are a licensed Nasdaq asset; the free path is a tracking ETF's published holdings, labelled as a proxy",
+  }),
+  "^RUT": Object.freeze({
+    index_name: "Russell 2000",
+    etf: "IWM",
+    alternates: Object.freeze(["VTWO"]),
+    licensor: "FTSE Russell",
+    why: "Russell 2000 membership and weights are a licensed FTSE Russell asset; the free path is a tracking ETF's published holdings, labelled as a proxy",
+  }),
   "^DJI": Object.freeze({
     index_name: "Dow Jones Industrial Average",
     etf: "DIA",
@@ -137,7 +151,8 @@ const INDEX_ALIASES = Object.freeze({
   GSPC: "^GSPC", "^GSPC": "^GSPC", SPX: "^GSPC", "^SPX": "^GSPC", SP500: "^GSPC",
   NDX: "^NDX", "^NDX": "^NDX", NASDAQ100: "^NDX",
   DJI: "^DJI", "^DJI": "^DJI", DJIA: "^DJI",
-  RUT: "^RUT", "^RUT": "^RUT",
+  RUT: "^RUT", "^RUT": "^RUT", RUSSELL2000: "^RUT",
+  SOX: "^SOX", "^SOX": "^SOX", SOXX: "^SOX", PHLXSEMI: "^SOX",
   IXIC: "^IXIC", "^IXIC": "^IXIC",
 });
 

package/mcp/lib/industry.mjs

@@ -119,24 +119,45 @@ export const SIC_GROUPS = [
   { id: "mining_energy", range: [1000, 1499], title: { zh: "采矿与能源", en: "Mining and energy" } },
   { id: "construction", range: [1500, 1799], title: { zh: "建筑", en: "Construction" } },
   { id: "food_beverage", range: [2000, 2199], title: { zh: "食品饮料", en: "Food and beverage" } },
+  { id: "textiles_apparel", range: [2200, 2399], title: { zh: "纺织服装", en: "Textiles and apparel" } },
+  { id: "paper_packaging", range: [2400, 2679], title: { zh: "造纸与包装", en: "Paper and packaging" } },
+  { id: "publishing", range: [2700, 2799], title: { zh: "出版印刷", en: "Publishing and printing" } },
   { id: "chemicals", range: [2800, 2899], title: { zh: "化工", en: "Chemicals" } },
   { id: "pharma_biotech", range: [2833, 2836], title: { zh: "医药与生物科技", en: "Pharma and biotech" } },
   { id: "energy_refining", range: [2900, 2999], title: { zh: "炼化", en: "Refining" } },
+  { id: "rubber_plastics", range: [3000, 3199], title: { zh: "橡胶塑料", en: "Rubber and plastics" } },
+  { id: "building_materials", range: [3200, 3299], title: { zh: "建材", en: "Building materials" } },
   { id: "metals", range: [3300, 3399], title: { zh: "金属", en: "Metals" } },
+  { id: "fabricated_metal", range: [3400, 3499], title: { zh: "金属制品", en: "Fabricated metal products" } },
   { id: "machinery", range: [3500, 3569], title: { zh: "机械", en: "Machinery" } },
   { id: "computers_hardware", range: [3570, 3579], title: { zh: "计算机硬件", en: "Computers and hardware" } },
+  { id: "industrial_equipment", range: [3580, 3599], title: { zh: "工业设备", en: "Industrial equipment" } },
   { id: "electronics", range: [3600, 3673], title: { zh: "电子", en: "Electronics" } },
   { id: "semiconductors", range: [3674, 3674], title: { zh: "半导体", en: "Semiconductors" } },
-  { id: "instruments_medical", range: [3820, 3873], title: { zh: "仪器与医疗器械", en: "Instruments and medical devices" } },
+  { id: "electrical_equipment", range: [3675, 3699], title: { zh: "电气设备", en: "Electrical equipment" } },
+  { id: "autos", range: [3700, 3719], title: { zh: "汽车", en: "Automobiles" } },
+  { id: "aerospace_defense", range: [3720, 3799], title: { zh: "航空航天与国防", en: "Aerospace and defense" } },
+  { id: "instruments_medical", range: [3800, 3879], title: { zh: "仪器与医疗器械", en: "Instruments and medical devices" } },
+  { id: "manufacturing_other", range: [3880, 3999], title: { zh: "其他制造", en: "Other manufacturing" } },
   { id: "transportation", range: [4000, 4799], title: { zh: "运输", en: "Transportation" } },
   { id: "telecom", range: [4800, 4899], title: { zh: "电信", en: "Telecom" } },
   { id: "utilities", range: [4900, 4999], title: { zh: "公用事业", en: "Utilities" } },
+  { id: "wholesale", range: [5000, 5199], title: { zh: "批发分销", en: "Wholesale and distribution" } },
   { id: "retail", range: [5200, 5999], title: { zh: "零售", en: "Retail" } },
-  { id: "banks", range: [6020, 6199], title: { zh: "银行", en: "Banks" } },
+  { id: "banks", range: [6000, 6199], title: { zh: "银行", en: "Banks" } },
+  { id: "brokers_asset_managers", range: [6200, 6299], title: { zh: "券商与资产管理", en: "Brokers and asset managers" } },
   { id: "insurance", range: [6300, 6411], title: { zh: "保险", en: "Insurance" } },
+  { id: "financial_services", range: [6412, 6499], title: { zh: "金融服务", en: "Financial services" } },
   { id: "real_estate", range: [6500, 6799], title: { zh: "房地产", en: "Real estate" } },
+  { id: "hospitality_leisure", range: [7000, 7099], title: { zh: "酒店与休闲", en: "Hospitality and leisure" } },
+  { id: "business_services", range: [7100, 7369], title: { zh: "商业服务", en: "Business services" } },
   { id: "software", range: [7370, 7379], title: { zh: "软件与IT服务", en: "Software and IT services" } },
+  { id: "consumer_services", range: [7380, 7799], title: { zh: "消费服务", en: "Consumer services" } },
+  { id: "media_entertainment", range: [7800, 7999], title: { zh: "影视与娱乐", en: "Media and entertainment" } },
   { id: "healthcare_services", range: [8000, 8099], title: { zh: "医疗服务", en: "Healthcare services" } },
+  { id: "professional_services", range: [8100, 8730], title: { zh: "专业服务", en: "Professional services" } },
+  { id: "research_services", range: [8731, 8734], title: { zh: "研究服务", en: "Research services" } },
+  { id: "other_services", range: [8735, 8999], title: { zh: "其他服务", en: "Other services" } },
 ];
 
 export function sicGroupFor(sic) {