Document crypto live pool authority

Author: Pigbibi

README.md

@@ -6,15 +6,15 @@
 
 ## What this repository is
 
-CryptoSnapshotPipelines is the QuantStrategyLab crypto snapshot and release pipeline. It builds the crypto live pool, rankings, shadow candidate tracks, and release artifacts used by CryptoStrategies.
+CryptoSnapshotPipelines is the QuantStrategyLab crypto snapshot and release pipeline. It is the authority for monthly crypto live-pool membership, ordering, rankings, shadow candidate tracks, and release artifacts used by CryptoStrategies.
 
 It is an evidence-producing repository. It does not place trades and should not be treated as an execution platform.
 
 ## Strategy and evidence boundary
 
 ### Direct runtime strategies
 
-The trading logic lives in CryptoStrategies. This repository produces the live-pool and validation artifacts that the strategy package reads.
+The trading logic lives in CryptoStrategies. This repository produces the live-pool and validation artifacts that the strategy package reads, and it owns the monthly selection and order of the published pool.
 
 ### Snapshot-backed work handled here
 
@@ -24,11 +24,11 @@ The trading logic lives in CryptoStrategies. This repository produces the live-p
 
 ### Downstream use
 
-CryptoStrategies and BinancePlatform should consume only release artifacts that pass the documented contract checks.
+CryptoStrategies and BinancePlatform should consume only release artifacts that pass the documented contract checks. Downstream systems should preserve `live_pool.json["symbols"]` order and should not rebuild the monthly pool from local indicators.
 
 ## What the artifacts are for
 
-Snapshot artifacts are used to make strategy decisions reproducible: ranking inputs, feature snapshots, manifests, validation summaries, and promotion evidence. They are not marketing claims. Before a downstream repository promotes a profile, review the latest artifacts across short, medium, and long windows where applicable.
+Snapshot artifacts are used to make strategy decisions reproducible: ranking inputs, live-pool snapshots, manifests, validation summaries, and promotion evidence. `live_pool.json` and `artifact_manifest.json` are the stable downstream execution contract; ranking files and research outputs stay upstream evidence unless the contract explicitly promotes them. They are not marketing claims. Before a downstream repository promotes a profile, review the latest artifacts across short, medium, and long windows where applicable.
 
 ## Repository layout
 

README.zh-CN.md

@@ -6,15 +6,15 @@
 
 ## 这个仓库是什么
 
-CryptoSnapshotPipelines 是 QuantStrategyLab 的加密货币 snapshot 与发布流水线。为 CryptoStrategies 生成 live pool、ranking、shadow candidate tracks 和发布产物。
+CryptoSnapshotPipelines 是 QuantStrategyLab 的加密货币 snapshot 与发布流水线。它是月度加密 live-pool 成员、顺序、ranking、shadow candidate tracks 和发布产物的权威来源，供 CryptoStrategies 使用。
 
 这是一个产出证据的仓库，不直接下单，也不应该被当作执行平台。
 
 ## 策略和证据边界
 
 ### 普通 runtime 策略
 
-交易逻辑在 CryptoStrategies。本仓库生成策略包读取的 live-pool 和验证产物。
+交易逻辑在 CryptoStrategies。本仓库生成策略包读取的 live-pool 和验证产物，并负责已发布池的月度选择和顺序。
 
 ### 本仓库处理的 Snapshot-backed 工作
 
@@ -24,11 +24,11 @@ CryptoSnapshotPipelines 是 QuantStrategyLab 的加密货币 snapshot 与发布
 
 ### 下游如何使用
 
-CryptoStrategies 和 BinancePlatform 应只消费通过 contract 检查的发布产物。
+CryptoStrategies 和 BinancePlatform 应只消费通过 contract 检查的发布产物。下游系统应保留 `live_pool.json["symbols"]` 的顺序，不应根据本地指标重建月度池。
 
 ## 这些产物用来做什么
 
-Snapshot artifact 的作用是让策略判断可复现：包括 ranking 输入、feature snapshot、manifest、validation summary 和提升证据。它们不是宣传式收益承诺。下游仓库提升 profile 前，应在适用场景下检查最新短、中、长周期产物。
+Snapshot artifact 的作用是让策略判断可复现：包括 ranking 输入、live-pool snapshot、manifest、validation summary 和提升证据。`live_pool.json` 和 `artifact_manifest.json` 是稳定的下游执行合约；ranking 文件和研究输出默认留在上游作为证据，除非合约明确提升它们。它们不是宣传式收益承诺。下游仓库提升 profile 前，应在适用场景下检查最新短、中、长周期产物。
 
 ## 仓库结构
 

docs/integration_contract.md

@@ -17,6 +17,12 @@ The upstream project publishes a monthly `core_major` live pool and exposes it t
 2. versioned and current objects in GCS
 3. a lightweight Firestore summary document
 
+## Authority Boundary
+
+`CryptoSnapshotPipelines` owns monthly live-pool membership, ranking, and order for `crypto_leader_rotation`. Downstream strategy and execution repositories should treat the ordered `symbols` list from `live_pool.json` or `artifact_manifest.json` as canonical.
+
+Downstream systems may apply runtime execution gates, sell rules, top-N selection, sizing, and degraded-source policy after artifact validation. They should not recalculate monthly membership or replace the published order from local indicators. `latest_ranking.csv` and `selection_meta` are upstream evidence and diagnostics; `live_pool.json` plus `artifact_manifest.json` are the stable execution contract.
+
 ## Canonical Downstream Files
 
 ### `artifact_manifest.json`
@@ -130,6 +136,7 @@ Stable contract fields for downstream validation:
 Meaning:
 
 - `pool_size` and `symbols` always describe the full official exported pool for that monthly snapshot
+- `symbols` order is the official upstream monthly order and should be preserved by downstream payload normalization
 - downstream display panels, local ranking previews, or final execution targets are separate downstream-layer concepts
 
 Research/reporting extras are intentionally not part of the stable contract. Downstream consumers should not infer live readiness from local research CSVs or validation summaries.

docs/operator_runbook.md

@@ -40,6 +40,11 @@ The GCS prefix, Firestore document, and `source_project` value intentionally
 remain in the `crypto-leader-rotation` v1 artifact namespace for downstream
 compatibility.
 
+This repository owns the monthly live-pool membership, ranking, and published
+symbol order. Downstream runtime repositories should consume the validated
+artifact contract and preserve that order when passing the pool into strategy
+code.
+
 ## Research Path Vs Production Path
 
 Production path:
@@ -81,6 +86,7 @@ Operator-facing summary entrypoints:
 Boundary rules:
 
 - Downstream execution systems should consume the validated release artifacts, not recreate the monthly report layer.
+- Downstream systems should not rerank or rebuild the monthly live pool from local runtime indicators.
 - Research reports and shadow-track diagnostics stay upstream and are not part of the minimum downstream execution contract.
 - Telegram messages from this repository are operational release notifications, not trade execution alerts.