From b8935def9720e6f952fcceecf2cdbf34c1e4d721 Mon Sep 17 00:00:00 2001 From: Pigbibi <20649888+Pigbibi@users.noreply.github.com> Date: Fri, 18 Sep 2026 02:01:44 +0800 Subject: [PATCH] docs(ci): clarify Drift Check preflight returns are research proxies Document that portfolio_and_tracker_returns.csv from walk-forward preflight is not paper/live account PerformanceStore PnL; real account drift needs a verified live_stream_id after the QPK reusable input lands. Co-authored-by: Cursor --- .github/workflows/drift-check.yml | 4 ++++ tests/test_drift_workflow_config.py | 2 ++ 2 files changed, 6 insertions(+) diff --git a/.github/workflows/drift-check.yml b/.github/workflows/drift-check.yml index ab66fca..636b8f4 100644 --- a/.github/workflows/drift-check.yml +++ b/.github/workflows/drift-check.yml @@ -185,6 +185,10 @@ jobs: market_history = os.environ["MARKET_HISTORY_PATH"] store_root = bundle_root / "data" / "lifecycle_store" for profile in profiles: + # Preflight returns CSV is a walk-forward research proxy for doctor/ + # monitor freshness — not paper/live account PerformanceStore PnL. + # Real account drift requires a verified live_stream_id on the + # reusable workflow (QPK) once LIFECYCLE_LIVE_STREAM_ID is set. returns_output = ( bundle_root / "external" diff --git a/tests/test_drift_workflow_config.py b/tests/test_drift_workflow_config.py index db01492..b80956b 100644 --- a/tests/test_drift_workflow_config.py +++ b/tests/test_drift_workflow_config.py @@ -55,6 +55,8 @@ def test_drift_workflow_wires_real_snapshot_history_and_preflight_bundle() -> No assert "matrix:" in workflow assert "profile: ${{ fromJSON(needs.preflight_backtests.outputs.lifecycle_profiles) }}" in workflow assert "strategy_profile: ${{ matrix.profile }}" in workflow + assert "walk-forward research proxy" in workflow + assert "not paper/live account" in workflow assert "tqqq_growth_income" not in workflow.split("LIFECYCLE_PREFLIGHT_BUNDLE_ROOT", 1)[1].split("Upload lifecycle", 1)[0] assert "codex_audit_service_url: ${{ secrets.CODEX_AUDIT_SERVICE_URL }}" in workflow assert "secrets.SNAPSHOT_REPOSITORY_TOKEN || secrets.QSL_REPO_SYNC_TOKEN || github.token" in workflow