AGENTS.md

Repository and validation

Stage-mode HAR @b2c/first_page: main module biz_firstpage, with a separate src/ohosTest Hypium test module. Root Index.ets is the host-facing export surface.
This checkout is not independently runnable: hvigorfile.ts defines HAR tasks, but hvigorw, oh_modules, and sibling ../biz_quote are absent. Sources also use host-provided modules beyond the root manifest's biz_quote and theme-manager dependencies.
Do not claim local build or test success, add host dependencies, or invent standalone commands. Validate integration, including src/ohosTest scaffolding where applicable, in the host project.

Export new host-facing symbols from root Index.ets.
A normal feed card needs a datacenter FirstPageConstant.KEY_*, model insertion, and a FirstPage.createNodeView dispatch branch; metadata normally comes from src/main/resources/rawfile/first_page_cards_config.json.
market-ranking is special: FirstPage inserts and renders it directly under KEY_MARKET_RANKING; its loader config key is marketRanking.
The two FirstPageConstant.ets files differ: datacenter/ defines card KEY_* values; util/ exports TITLE_BAR_HEIGHT only.

Keep the two-stage data path: MarketRankingDataFetcher obtains recommended contracts through @kit.NetworkKit, then MarketRankingHqRequestClient subscribes them through the host TableRequestClient/4106 path. Do not substitute mock data or another quote client.
MarketRankingConstant.ets couples UI labels, HTTP parameters, and 4106 fields in TAB_METRICS and PERIOD_RANGES; update ordering, IDs, and child-tab semantics together.
Keep 4106 frame 2201, scenario qht_qihuo_sort, and pushtime=2.5 aligned with the subscription path. Release subscriptions on invisibility, tab changes, refresh, and destruction; reconstruct on TCP reconnect from the original HTTP contract list.
Preserve HTTP/quote request and subscription version guards. Preserve contract, market, and name ordering when rows call host jumpToQuote().
Validate 4106 IDs and standard-price fields, HTTP environment/auth, lifecycle/reconnect behavior, and quote routing in the host; see doc/market-ranking-known-issues.md before changing this area.

Put user-facing text in src/main/resources/{base,zh_CN,en_US}/element/string.json; use $r('app.color.*') with light/dark qualifiers rather than hardcoded theme colors.
Keep FirstPageDebugUtil.isMarketRankingUseTestUrl and other test-URL switches false in commits.
Preserve existing root/deep biz_quote import style. For public or reflective symbols, account for release ArkGuard rules in obfuscation-rules.txt and consumer-rules.txt.