From 768127ac52aad9e1e9d8c36fc57bdbebe01c0c27 Mon Sep 17 00:00:00 2001 From: OoO Date: Sun, 24 May 2026 13:15:14 +0800 Subject: [PATCH] V10.405 add market intel MCP manual fetch handoff gate --- TODO_NEXT_STEPS.txt | 1 + config.py | 2 +- ...s-platform-market-campaign-intelligence.md | 1 + .../code_modularization_inventory_20260430.md | 8 +- docs/memory/history_logs.md | 1 + routes/market_intel_routes.py | 31 ++ services/market_intel/deployment_readiness.py | 23 ++ .../market_intel/mcp_manual_fetch_handoff.py | 230 +++++++++++ services/market_intel/phase.py | 2 +- templates/market_intel/disabled.html | 158 +++++++- tests/test_market_intel_skeleton.py | 376 ++++++++++++------ 11 files changed, 703 insertions(+), 130 deletions(-) create mode 100644 services/market_intel/mcp_manual_fetch_handoff.py diff --git a/TODO_NEXT_STEPS.txt b/TODO_NEXT_STEPS.txt index 75a2b55..55c202a 100644 --- a/TODO_NEXT_STEPS.txt +++ b/TODO_NEXT_STEPS.txt @@ -4,6 +4,7 @@ ================================================================================ 【已完成】 + - V10.405 補市場情報 MCP manual fetch handoff gate:新增 `mcp_manual_fetch_handoff` read-only builder、GET/POST endpoint、UI handoff package 審核面板與 deployment readiness smoke target,將 runtime promotion package 與操作員安全確認合併成「可進人工 fetch gate 審核」的交接收據;API/UI 不保存 payload、不打 health、不開 DB、不抓外站、不掛 scheduler,也不會自動打開 manual fetch。 - V10.379 補市場情報 MCP runtime promotion gate:新增 `mcp_runtime_promotion` read-only builder、GET/POST endpoint、UI promotion package 審核面板與 deployment readiness smoke target,將 MCP activation evidence 與 runtime smoke receipt 合併成可審核的 runtime promotion package;API/UI 不保存 payload、不打 health、不開 DB、不抓外站、不掛 scheduler,也不會自動打開人工 fetch gate。 - V10.366 補市場情報 MCP runtime smoke 收據審核:新增 `mcp_runtime_smoke_receipt` read-only builder、GET/POST endpoint、UI receipt JSON 審核面板與 deployment readiness smoke target,讓操作員貼上 `/api/market_intel/mcp_readiness?execute=true&timeout=3` 的實際收據後,判斷 external/internal MCP runtime 是否可升級為已驗收;API/UI 不保存 payload、不打 health、不開 DB、不抓外站、不掛 scheduler,且會阻擋任何 DB write/commit/scheduler/writes 旗標或原始 readiness blocked reasons。 - V10.360 收斂瀏覽器自動開啟與 PChome 熱路徑:`tests/test_image_fetch.py` 改成 `RUN_MOMO_BROWSER_TESTS=1` 才會跑,預設 headless 且關閉 Chrome 密碼管理,避免一般 pytest 自動打開 MOMO 網站與觸發密碼允許提示;scheduler Selenium 同步關閉 password manager/autofill;PChome coverage/review queue 熱查詢改用 `JOIN LATERAL` 取 active 商品最新價,並補 Dashing Diva 品線召回搜尋詞。 diff --git a/config.py b/config.py index a34923b..29d1280 100644 --- a/config.py +++ b/config.py @@ -325,7 +325,7 @@ YOUTUBE_API_KEY = os.getenv('YOUTUBE_API_KEY', '') # ========================================== # 系統版本與路徑 # ========================================== -SYSTEM_VERSION = "V10.404" +SYSTEM_VERSION = "V10.405" LOG_FILE_PATH = os.path.join(BASE_DIR, 'logs/system.log') public_url = PUBLIC_URL # 用於模板顯示 diff --git a/docs/adr/ADR-035-cross-platform-market-campaign-intelligence.md b/docs/adr/ADR-035-cross-platform-market-campaign-intelligence.md index 8baa4f8..d0e74f1 100644 --- a/docs/adr/ADR-035-cross-platform-market-campaign-intelligence.md +++ b/docs/adr/ADR-035-cross-platform-market-campaign-intelligence.md @@ -158,6 +158,7 @@ EwoooC 目前已有 MOMO EDM / 節慶活動資料、`promo_products`、PChome - 2026-05-18 追加 external MCP deploy preflight preview:`services.market_intel.mcp_deploy_preflight` 與 `/api/market_intel/mcp_deploy_preflight` 只讀檢查 `docker-compose.mcp.yml`、必要 env、localhost-only ports、read-only volume、Firecrawl resource guard 與 fallback plan。`docker-compose.mcp.yml` 需以 read-only bind mount 進 app 容器供 preflight 審核。此 preflight 不執行 docker/SSH、不建立 `mcp_readonly` role、不啟用 `MCP_ROUTER_ENABLED`、不寫 DB、不掛 scheduler;外部 MCP stack 須等 env 與 operator smoke 全過後另行批准。 - 2026-05-18 追加 MCP activation runbook preview:`services.market_intel.mcp_activation_runbook` 與 `/api/market_intel/mcp_activation_runbook` 只輸出人工啟用順序與 gate:補必要 env、人工建立/驗證 `mcp_readonly`、啟動外部 MCP stack、四個 health 全過、最後才允許 `MCP_ROUTER_ENABLED=true`。此 runbook 不執行 docker/SSH、不寫 env、不建立 DB role、不跑 health、不啟用 router、不寫 DB、不掛 scheduler。 - 2026-05-18 追加 MCP fetch gate preview:`services.market_intel.mcp_fetch_gate` 與 `/api/market_intel/mcp_fetch_gate` 將人工 discovery fetch 改成必須先通過市場情報 feature flags、MCP readiness、router、外部 MCP health 與 tool contract gate;`run_manual_discovery(fetch=true)` 即使 flags 開啟也會先被此 gate 阻擋,直到 MCP 條件全過。此 gate 不抓電商頁、不寫 DB、不掛 scheduler、不執行 deployment,UI 預設只呼叫 `fetch=false&execute=false`。 +- 2026-05-24 追加 MCP manual fetch handoff gate:`services.market_intel.mcp_manual_fetch_handoff` 與 `/api/market_intel/mcp_manual_fetch_handoff` 將 runtime promotion package 與操作員安全確認合併成可審核 handoff,只放行到人工 fetch gate operator review;API/UI 不保存 payload、不打 health、不開 DB、不抓外站、不掛 scheduler,也不會自動打開 manual fetch。 - 2026-05-18 追加 scheduler attach plan preview:`services.market_intel.scheduler_plan` 與 `/api/market_intel/scheduler_plan` 描述未來 `campaign_discovery_daily`、`campaign_product_probe`、`product_match_review_seed` 三個 job 的 cadence、gate、fallback 與安全邊界。此階段不註冊 scheduler job、不啟動 crawler、不連外、不寫 DB;排程掛載必須等 migration、seed、MCP fetch gate、manual sample 與人工批准全過。 - 2026-05-18 追加 match review plan preview:`services.market_intel.match_review_plan` 與 `/api/market_intel/match_review_plan` 定義商品比對訊號、分數門檻、`needs_review → confirmed/rejected` HITL 流程與安全邊界。此階段不建立 review queue、不自動 confirmed、不寫 `market_product_matches`、不呼叫 MCP;價格只能作為輔助訊號,不能單獨決定同品比對。 - 2026-05-18 追加 opportunity plan preview:`services.market_intel.opportunity_plan` 與 `/api/market_intel/opportunity_plan` 定義競品低價威脅、促銷缺口、深折重疊、活動即將結束四類規則與分級策略。此階段不建立 opportunity queue、不派送 Telegram、不產生 AI 摘要、不寫 DB;高風險項必須先有 confirmed match 與 DB evidence 才能升級。 diff --git a/docs/memory/code_modularization_inventory_20260430.md b/docs/memory/code_modularization_inventory_20260430.md index 1afc31c..430d67c 100644 --- a/docs/memory/code_modularization_inventory_20260430.md +++ b/docs/memory/code_modularization_inventory_20260430.md @@ -37,12 +37,14 @@ - 2026-05-21 追記:同步 111 fallback context/resource guard 合併後的 `services/ollama_service.py` 行數;此處只更新 inventory,不變更 Ollama 路由行為。 - 2026-05-21 追記:同步專業比價分級連動合併後的 `services/competitor_intel_repository.py` 與 `services/nemoton_dispatcher_service.py` 行數;此處只更新 inventory,不變更比價或告警行為。 - 2026-05-21 追記:同步市場情報 MCP runtime promotion gate 後的 `routes/market_intel_routes.py` 與 `services/market_intel/deployment_readiness.py` 行數;此處只更新 inventory,後續市場情報 MCP route 應拆出子 Blueprint。 +- 2026-05-24 追記:同步市場情報 MCP manual fetch handoff gate 後的 `routes/market_intel_routes.py` 與 `services/market_intel/deployment_readiness.py` 行數;本次新增邏輯已放在獨立 `services/market_intel/mcp_manual_fetch_handoff.py`,route 僅保留薄 glue,下一個 MCP/UI gate 應優先拆出子 Blueprint 或 route registration helper。 - 2026-05-21 追記:同步 PChome/LUDEYA 商品線名稱漂移比對更新後的 `services/marketplace_product_matcher.py` 行數;此處只更新 inventory,不變更模組化決策。 - 2026-05-21 追記:同步 MAC/Yuskin/AHC 名稱漂移與 bundle equivalent matcher 更新後的 `services/marketplace_product_matcher.py` 行數;此處只更新 inventory,不變更模組化決策。 - 2026-05-21 追記:同步 EDM 失效頁 alert guard 與 REJURAN 唇膏寬價差 exact-identity matcher 更新後的 `scheduler.py`、`services/marketplace_product_matcher.py` 行數;此處只更新 inventory,不變更模組化決策。 - 2026-05-21 追記:同步過期 EDM / seasonal promo crawler 排程改為 opt-in、NIVEA/OPI 搜尋 noise 與 identity anchor 補強後的 `run_scheduler.py`、`services/marketplace_product_matcher.py` 行數;此處只更新 inventory,不變更模組化決策。 - 2026-05-21 追記:同步 Recipe Box 多效提亮防曬霜同款漂移比對補強後的 `services/marketplace_product_matcher.py` 行數;此處只更新 inventory,不變更模組化決策。 - 2026-05-21 追記:同步 browse.sh 診斷計畫寫入 `competitor_match_attempts` 後的 `services/competitor_price_feeder.py` 行數;此處只更新 inventory,不變更模組化決策。 +- 2026-05-24 追記:同步背景 PChome 近門檻身份回收與 focused identity 系列更新後的 `services/marketplace_product_matcher.py` 行數;此處只更新 inventory,不變更商品比對行為。 ## 達到或超過 800 行檔案清單 @@ -69,7 +71,7 @@ | 940 | `services/import_service.py` | P2 import service | validators / import writers / report builders | | 933 | `services/telegram_templates.py` | P2 Telegram templates | alert template groups / channel-specific formatting / reusable render helpers | | 867 | `services/token_report_service.py` | P2 token report service | query / aggregation / chart payload / notification formatting | -| 2337 | `services/marketplace_product_matcher.py` | P2 marketplace matcher | identity parsing / unit-comparable scoring / search term quality / persistence normalization | +| 3313 | `services/marketplace_product_matcher.py` | P2 marketplace matcher | identity parsing / unit-comparable scoring / search term quality / persistence normalization | | 865 | `routes/daily_sales_routes.py` | P2 Daily Sales Blueprint | route glue / export helpers / daily query and formatting service | | 961 | `services/ollama_service.py` | P2 Ollama client | host health / request client / fallback policy / response parsing | | 849 | `services/pchome_crawler.py` | P2 PChome crawler | search fetch / parsing / fallback source handling / rate limit policy | @@ -80,8 +82,8 @@ | 1327 | `services/competitor_intel_repository.py` | P2 competitor intel repository | review queue query / cache shaping / formatting helpers | | 805 | `routes/bot_api_routes.py` | P2 Bot API Blueprint | route glue / bot action service | | 1319 | `routes/market_intel_review_report_routes.py` | P2 market intel review report Blueprint | review report route glue / export payload / phase handoff orchestration | -| 853 | `routes/market_intel_routes.py` | P2 market intel Blueprint | page route / API route glue / MCP gate route registration helper | -| 931 | `services/market_intel/deployment_readiness.py` | P2 market intel deployment readiness | preflight gates / readiness payload / route contract helpers | +| 884 | `routes/market_intel_routes.py` | P2 market intel Blueprint | page route / API route glue / MCP gate route registration helper | +| 954 | `services/market_intel/deployment_readiness.py` | P2 market intel deployment readiness | preflight gates / readiness payload / route contract helpers | | 846 | `services/market_intel/candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_run_receipt.py` | P2 market intel review receipt pipeline | AI summary / persistence / Telegram dispatch / report catalog run receipt orchestration | ## 市場情報開發前置禁區 diff --git a/docs/memory/history_logs.md b/docs/memory/history_logs.md index 9801621..266d081 100644 --- a/docs/memory/history_logs.md +++ b/docs/memory/history_logs.md @@ -14,6 +14,7 @@ ### 2026-05-24:PChome 近門檻身份回收第二輪 - **V10.404 Hermes 競價威脅漏斗只吃 direct alert**: `HermesAnalystService.fetch_candidates()` 的 `competitor_prices` JOIN 新增硬條件,只讓 `match_type=exact`、`price_basis=total_price`、`alert_tier=price_alert_exact` 的 identity_v2 配對進入 Hermes 競價威脅分析;`identity_review`、`unit_price_review` 與 `suppress` 仍保留在 dashboard / 人工覆核資料流,但不再消耗 Hermes token 或被上游視為直接價格威脅候選。production fresh 配對分布顯示直接告警約 497 筆、覆核型約 216 筆,本版將兩者在 AI 威脅入口切開。同版 matcher 追加 KATE 怪獸級持色唇膏、植村秀武士刀眉筆筆蕊、The Forest 焦糖楓葉擴香禮盒等近門檻 review-only 回收線,仍只進人工覆核,不直接價格告警。 +- **V10.405 MCP manual fetch handoff gate**: 新增 `mcp_manual_fetch_handoff` read-only builder、GET/POST endpoint、UI handoff package 審核面板與 deployment readiness smoke target,讓 runtime promotion package 搭配操作員公開頁面、節流、無登入/反爬、無 DB、無 scheduler 確認後,只放行到人工 fetch gate operator review;API/UI 不保存 payload、不打 health、不開 DB、不抓外站、不掛 scheduler,也不會自動打開 manual fetch。 - **V10.403 近門檻候選重驗擴池**: production 最新 72h attempt audit 顯示 7853 筆近門檻/被擋候選中,有 105 筆可被現行 matcher 回收,其中 46 筆已達 `price_alert_exact`、59 筆只進 `identity_review`。`CompetitorPriceFeeder._fetch_retryable_candidate_skus()` 擴大每日 revalidation 候選池,納入 `true_low_confidence`、`unit_comparable`、`refresh_unit_comparable` 與高分 `identity_veto`;但仍要求 PChome product_id、`best_match_score >= 0.70`,且正式寫入前必須由現行 matcher 重判、通過 hard-veto 與既有配對保護。 - **V10.402 catalog variant identity-review 回收**: marketplace matcher 新增 Johnson’s 嬰兒潤膚乳 catalog 對同香型、IM MEME 涼感定妝噴霧、SO NATURAL FIXX 定妝噴霧三條 review-only focused identity,讓同品線 catalog / variant 候選可脫離 `true_low_confidence` 但只進 `identity_review`,不直接價格告警;同版明確保留 MUJI 品牌缺漏護手霜等 brandless catalog 案例在低信心,避免品牌缺漏與多款任選同時存在時被過度救回。 - **V10.401 focused identity 邊界整理**: 將 Laundrin TOKYO 車用夾式消臭芳香劑判定抽成 `_has_laundrin_tokyo_car_freshener_alignment()`,並在 variant descriptor guard 中豁免同一條強身份線,避免 TOKYO / 車用 / 芳香劑語序差異造成誤擋。Yuskin 經典乳霜 30g 6 入組改用 `_has_exact_count_alignment()` 判斷包數,保留 6入 vs 6盒這類同數量但不同容器字詞的人工覆核路徑。 diff --git a/routes/market_intel_routes.py b/routes/market_intel_routes.py index c1744d8..f4ba7de 100644 --- a/routes/market_intel_routes.py +++ b/routes/market_intel_routes.py @@ -19,6 +19,9 @@ from services.market_intel.candidate_queue_writer_run_receipt import build_candi from services.market_intel.candidate_queue_writer_run_closeout import build_candidate_queue_writer_run_closeout from services.market_intel.candidate_queue_review_handoff import build_candidate_queue_review_handoff from services.market_intel.mcp_activation_evidence import build_mcp_activation_evidence_preview +from services.market_intel.mcp_manual_fetch_handoff import ( + build_mcp_manual_fetch_handoff_preview, +) from services.market_intel.mcp_runtime_promotion import build_mcp_runtime_promotion_preview from services.market_intel.mcp_runtime_smoke_receipt import build_mcp_runtime_smoke_receipt_preview @@ -218,6 +221,34 @@ def market_intel_mcp_runtime_promotion(): ) +@market_intel_bp.route("/api/market_intel/mcp_manual_fetch_handoff", methods=["GET", "POST"]) +@login_required +def market_intel_mcp_manual_fetch_handoff(): + promotion_package = {} + promotion_review = None + operator_acknowledgements = {} + if request.method == "POST": + payload = request.get_json(silent=True) or {} + handoff_package = payload.get("handoff_package") or payload + promotion_package = handoff_package.get("promotion_package", {}) + promotion_review = handoff_package.get("promotion_review") + operator_acknowledgements = handoff_package.get( + "operator_acknowledgements", + {}, + ) + + service = _service() + return jsonify( + build_mcp_manual_fetch_handoff_preview( + promotion_package=promotion_package, + promotion_review=promotion_review, + operator_acknowledgements=operator_acknowledgements, + runtime_status=service.get_runtime_status(), + phase=service.phase, + ) + ) + + @market_intel_bp.route("/api/market_intel/scheduler_plan") @login_required def market_intel_scheduler_plan(): diff --git a/services/market_intel/deployment_readiness.py b/services/market_intel/deployment_readiness.py index 5c4e7e7..7e67695 100644 --- a/services/market_intel/deployment_readiness.py +++ b/services/market_intel/deployment_readiness.py @@ -60,6 +60,9 @@ from services.market_intel.candidate_queue_review_ai_summary_persistence_transac from services.market_intel.candidate_queue_review_ai_summary_persistence_writer_preflight import build_candidate_queue_review_ai_summary_persistence_writer_preflight from services.market_intel.candidate_queue_review_ai_summary_run_package import build_candidate_queue_review_ai_summary_run_package from services.market_intel.mcp_activation_evidence import build_mcp_activation_evidence_preview +from services.market_intel.mcp_manual_fetch_handoff import ( + build_mcp_manual_fetch_handoff_preview, +) from services.market_intel.mcp_runtime_promotion import build_mcp_runtime_promotion_preview from services.market_intel.mcp_runtime_smoke_receipt import build_mcp_runtime_smoke_receipt_preview BLOCKED_RUN_REVIEW_KEYS = ( @@ -149,6 +152,11 @@ PRODUCTION_SMOKE_TARGETS = ( + ("/api/market_intel/mcp_runtime_promotion",) + PRODUCTION_SMOKE_TARGETS[-1:] ) +PRODUCTION_SMOKE_TARGETS = ( + PRODUCTION_SMOKE_TARGETS[:-1] + + ("/api/market_intel/mcp_manual_fetch_handoff",) + + PRODUCTION_SMOKE_TARGETS[-1:] +) def _run_review_preview_safe(payload, mode): return bool(payload["mode"] == mode and all(not payload.get(key) for key in BLOCKED_RUN_REVIEW_KEYS)) def build_deployment_readiness_preview(*, service, market_intel_tables, schema_smoke_builder): @@ -169,6 +177,10 @@ def build_deployment_readiness_preview(*, service, market_intel_tables, schema_s mcp_runtime_promotion = build_mcp_runtime_promotion_preview( phase=service.phase, ) + mcp_manual_fetch_handoff = build_mcp_manual_fetch_handoff_preview( + runtime_status=status, + phase=service.phase, + ) scheduler_plan = service.build_scheduler_plan() manual_sample_plan = service.build_manual_sample_plan() manual_sample_acceptance = service.build_manual_sample_acceptance() @@ -420,6 +432,16 @@ def build_deployment_readiness_preview(*, service, market_intel_tables, schema_s and not mcp_runtime_promotion["api_writes_database"] and not mcp_runtime_promotion["api_uses_external_network"] ), + "mcp_manual_fetch_handoff_preview_safe": bool( + mcp_manual_fetch_handoff["mode"] == "mcp_manual_fetch_handoff_preview" + and not mcp_manual_fetch_handoff["payload_persisted"] + and not mcp_manual_fetch_handoff["handoff_persisted"] + and not mcp_manual_fetch_handoff["manual_fetch_gate_opened_by_api"] + and not mcp_manual_fetch_handoff["network_request_allowed"] + and not mcp_manual_fetch_handoff["api_opens_database_connection"] + and not mcp_manual_fetch_handoff["api_writes_database"] + and not mcp_manual_fetch_handoff["api_uses_external_network"] + ), "scheduler_plan_preview_safe": bool( scheduler_plan["mode"] == "scheduler_attach_plan_preview" and not scheduler_plan["scheduler_registration_executed"] @@ -854,6 +876,7 @@ def build_deployment_readiness_preview(*, service, market_intel_tables, schema_s "mcp_activation_evidence": mcp_activation_evidence, "mcp_runtime_smoke_receipt": mcp_runtime_smoke_receipt, "mcp_runtime_promotion": mcp_runtime_promotion, + "mcp_manual_fetch_handoff": mcp_manual_fetch_handoff, "scheduler_plan": scheduler_plan, "manual_sample_plan": manual_sample_plan, "manual_sample_acceptance": manual_sample_acceptance, diff --git a/services/market_intel/mcp_manual_fetch_handoff.py b/services/market_intel/mcp_manual_fetch_handoff.py new file mode 100644 index 0000000..451dffa --- /dev/null +++ b/services/market_intel/mcp_manual_fetch_handoff.py @@ -0,0 +1,230 @@ +"""市場情報 MCP manual fetch handoff preview。 + +本模組只審核 runtime promotion 與操作員安全確認是否足以進入人工 +fetch gate review;不打開 fetch、不連外、不開 DB、不保存 payload、不掛排程。 +""" + +from services.market_intel.mcp_fetch_gate import build_mcp_fetch_gate_preview +from services.market_intel.mcp_runtime_promotion import ( + build_mcp_runtime_promotion_preview, +) + + +ACKNOWLEDGEMENT_LABELS = { + "public_pages_only": "只允許公開頁面與公開結構化資料", + "respect_rate_limit": "每平台需遵守節流與 timeout / retry ceiling", + "no_login_no_antibot": "不得登入、不得處理會員資料、不得繞反爬或帳號池", + "no_database_write": "本階段不得寫 DB,正式入庫需另走 writer gate", + "no_scheduler_attach": "不得掛上正式 scheduler,排程掛載另行批准", + "manual_fetch_requires_separate_execution": "manual fetch 需另由人工命令或後續 gate 執行", +} + +_BLOCKED_SIDE_EFFECT_KEYS = ( + "api_executes_health_check", + "api_executes_docker", + "api_executes_ssh", + "api_opens_database_connection", + "api_writes_database", + "api_uses_external_network", + "database_session_created", + "database_write_executed", + "database_commit_executed", + "external_network_executed", + "scheduler_attached", + "writes_executed", + "would_write_database", +) + + +def _default_runtime_status(phase): + return { + "phase": phase, + "enabled": False, + "crawler_enabled": False, + "write_enabled": False, + "dry_run_only": True, + "scheduler_attached": False, + "database_write_allowed": False, + } + + +def _sample_handoff_package(promotion_review): + return { + "promotion_package": promotion_review["sample_promotion_package"], + "operator_acknowledgements": { + key: True for key in ACKNOWLEDGEMENT_LABELS + }, + } + + +def _promotion_review_from_inputs(promotion_package, promotion_review, phase): + if isinstance(promotion_review, dict) and promotion_review: + return promotion_review + + promotion_package = promotion_package or {} + return build_mcp_runtime_promotion_preview( + activation_evidence=promotion_package.get("activation_evidence", {}), + runtime_receipt=promotion_package.get("runtime_receipt", {}), + phase=phase, + ) + + +def _side_effect_free(payload): + return all(not payload.get(key) for key in _BLOCKED_SIDE_EFFECT_KEYS) + + +def build_mcp_manual_fetch_handoff_preview( + *, + promotion_package=None, + promotion_review=None, + operator_acknowledgements=None, + runtime_status=None, + phase=None, +): + """建立 manual fetch handoff review;只輸出審核結果,不執行 fetch。""" + promotion_package = promotion_package or {} + operator_acknowledgements = operator_acknowledgements or {} + review = _promotion_review_from_inputs( + promotion_package, + promotion_review, + phase, + ) + fetch_gate = build_mcp_fetch_gate_preview( + runtime_status or _default_runtime_status(phase), + fetch_requested=False, + execute_readiness=False, + ) + fetch_gate["phase"] = phase + + handoff_payload_received = bool( + promotion_package or promotion_review or operator_acknowledgements + ) + acknowledgement_status = { + key: { + "label": label, + "acknowledged": bool(operator_acknowledgements.get(key)), + } + for key, label in ACKNOWLEDGEMENT_LABELS.items() + } + acknowledgement_complete = all( + item["acknowledged"] for item in acknowledgement_status.values() + ) + promotion_accepted = bool(review.get("runtime_promotion_accepted")) + fetch_gate_closed = bool( + not fetch_gate.get("manual_fetch_gate_open") + and not fetch_gate.get("network_request_allowed") + and not fetch_gate.get("external_network_executed") + ) + side_effect_free = bool( + _side_effect_free(review) + and _side_effect_free(fetch_gate) + ) + + gates = [ + { + "key": "runtime_promotion_payload_or_review_received", + "passed": bool(promotion_package or promotion_review), + "label": "已提供 runtime promotion package 或已審核結果", + }, + { + "key": "runtime_promotion_accepted", + "passed": promotion_accepted, + "label": "runtime promotion 已通過,可進下一段人工交接", + }, + { + "key": "operator_acknowledgements_complete", + "passed": acknowledgement_complete, + "label": "操作員已確認公開頁面、節流、無登入、無 DB、無排程邊界", + }, + { + "key": "fetch_gate_preview_present", + "passed": bool(fetch_gate.get("mode") == "mcp_fetch_gate_planned"), + "label": "已產生 fetch gate planned preview", + }, + { + "key": "fetch_gate_remains_closed_by_api", + "passed": fetch_gate_closed, + "label": "本 API 不打開 fetch、不允許 network request", + }, + { + "key": "handoff_side_effect_free", + "passed": side_effect_free, + "label": "handoff 審核不打 health、不開 DB、不連外、不掛 scheduler", + }, + ] + gates.extend( + { + "key": f"ack_{key}", + "passed": item["acknowledged"], + "label": item["label"], + } + for key, item in acknowledgement_status.items() + ) + blocked_reasons = [ + gate["key"] for gate in gates + if not gate["passed"] + ] + accepted = bool(handoff_payload_received and not blocked_reasons) + + return { + "mode": ( + "mcp_manual_fetch_handoff_review" + if handoff_payload_received + else "mcp_manual_fetch_handoff_preview" + ), + "phase": phase, + "handoff_payload_received": handoff_payload_received, + "promotion_payload_received": bool(promotion_package or promotion_review), + "operator_acknowledgements_received": bool(operator_acknowledgements), + "runtime_promotion_accepted": promotion_accepted, + "operator_acknowledgements_complete": acknowledgement_complete, + "manual_fetch_handoff_accepted": accepted, + "ready_for_manual_fetch_gate_operator_review": accepted, + "manual_fetch_gate_opened_by_api": False, + "network_request_allowed": False, + "fetch_executed": False, + "gate_count": len(gates), + "passed_gate_count": sum(1 for gate in gates if gate["passed"]), + "blocked_reasons": blocked_reasons, + "gates": gates, + "operator_acknowledgement_status": acknowledgement_status, + "promotion_summary": { + "mode": review.get("mode"), + "accepted": promotion_accepted, + "passed_gate_count": review.get("passed_gate_count", 0), + "gate_count": review.get("gate_count", 0), + "blocked_reasons": review.get("blocked_reasons", []), + "ready_for_manual_fetch_gate_review": bool( + review.get("ready_for_manual_fetch_gate_review") + ), + }, + "fetch_gate_summary": { + "mode": fetch_gate.get("mode"), + "manual_fetch_gate_open": bool(fetch_gate.get("manual_fetch_gate_open")), + "network_request_allowed": bool(fetch_gate.get("network_request_allowed")), + "blocked_reasons": fetch_gate.get("blocked_reasons", []), + }, + "mcp_runtime_promotion": review, + "mcp_fetch_gate": fetch_gate, + "sample_handoff_package": _sample_handoff_package(review), + "next_operator_steps": [ + "若 handoff 通過,只代表可進入人工 fetch gate 審核,不代表 API 可直接抓取", + "操作員仍需確認公開頁面範圍、限速策略、紀錄保存與回退方式", + "正式 DB write、scheduler attach、Telegram/AI 摘要仍需各自獨立 gate", + ], + "payload_persisted": False, + "handoff_persisted": False, + "api_executes_health_check": False, + "api_executes_docker": False, + "api_executes_ssh": False, + "api_opens_database_connection": False, + "api_writes_database": False, + "api_uses_external_network": False, + "database_session_created": False, + "database_write_executed": False, + "database_commit_executed": False, + "external_network_executed": False, + "scheduler_attached": False, + "writes_executed": False, + "would_write_database": False, + } diff --git a/services/market_intel/phase.py b/services/market_intel/phase.py index eed1a91..e359b96 100644 --- a/services/market_intel/phase.py +++ b/services/market_intel/phase.py @@ -1,3 +1,3 @@ """市場情報 rollout phase 單一來源。""" -MARKET_INTEL_PHASE = "phase_119_market_intel_mcp_runtime_promotion" +MARKET_INTEL_PHASE = "phase_120_market_intel_mcp_manual_fetch_handoff" diff --git a/templates/market_intel/disabled.html b/templates/market_intel/disabled.html index c1d9d99..9500e75 100644 --- a/templates/market_intel/disabled.html +++ b/templates/market_intel/disabled.html @@ -630,6 +630,32 @@ +
+
+
+

MCP / MANUAL FETCH HANDOFF

+

MCP Manual Fetch Handoff 審核

+
+ +
+
+ loading +
+
+
讀取 MCP Manual Fetch Handoff 審核中...
+
+
+ +
+ +
+
+
+
@@ -1137,6 +1163,7 @@ const mcpActivationEvidenceRoot = document.querySelector('[data-market-intel-mcp-activation-evidence]'); const mcpRuntimeSmokeRoot = document.querySelector('[data-market-intel-mcp-runtime-smoke]'); const mcpRuntimePromotionRoot = document.querySelector('[data-market-intel-mcp-runtime-promotion]'); + const mcpManualFetchHandoffRoot = document.querySelector('[data-market-intel-mcp-manual-fetch-handoff]'); const manualSampleRoot = document.querySelector('[data-market-intel-manual-sample]'); const sampleAcceptanceRoot = document.querySelector('[data-market-intel-sample-acceptance]'); const sampleReviewRoot = document.querySelector('[data-market-intel-sample-review]'); @@ -1153,7 +1180,7 @@ const liveInventoryRoot = document.querySelector('[data-market-intel-live-inventory]'); const approvalRoot = document.querySelector('[data-market-intel-approval]'); const deployRoot = document.querySelector('[data-market-intel-deploy]'); - if (!root && !writerRoot && !cliRoot && !dbProbeRoot && !seedDiffRoot && !legacyBridgeRoot && !mcpReadinessRoot && !mcpPreflightRoot && !mcpActivationRoot && !mcpFetchGateRoot && !mcpCompletionRoot && !mcpActivationEvidenceRoot && !mcpRuntimeSmokeRoot && !mcpRuntimePromotionRoot && !manualSampleRoot && !sampleAcceptanceRoot && !sampleReviewRoot && !schedulerRoot && !matchReviewRoot && !opportunityRoot && !opportunityScoringRoot && !opportunityEvidenceRoot && !opportunityAlertRoot && !migrationRoot && !migrationDrillRoot && !catalogReviewRoot && !liveSmokeRoot && !liveInventoryRoot && !approvalRoot && !deployRoot) return; + if (!root && !writerRoot && !cliRoot && !dbProbeRoot && !seedDiffRoot && !legacyBridgeRoot && !mcpReadinessRoot && !mcpPreflightRoot && !mcpActivationRoot && !mcpFetchGateRoot && !mcpCompletionRoot && !mcpActivationEvidenceRoot && !mcpRuntimeSmokeRoot && !mcpRuntimePromotionRoot && !mcpManualFetchHandoffRoot && !manualSampleRoot && !sampleAcceptanceRoot && !sampleReviewRoot && !schedulerRoot && !matchReviewRoot && !opportunityRoot && !opportunityScoringRoot && !opportunityEvidenceRoot && !opportunityAlertRoot && !migrationRoot && !migrationDrillRoot && !catalogReviewRoot && !liveSmokeRoot && !liveInventoryRoot && !approvalRoot && !deployRoot) return; const meta = root ? root.querySelector('[data-market-intel-preview-meta]') : null; const body = root ? root.querySelector('[data-market-intel-preview-body]') : null; @@ -1218,6 +1245,12 @@ const mcpRuntimePromotionReview = mcpRuntimePromotionRoot ? mcpRuntimePromotionRoot.querySelector('[data-market-intel-mcp-runtime-promotion-review]') : null; const mcpRuntimePromotionRefresh = mcpRuntimePromotionRoot ? mcpRuntimePromotionRoot.querySelector('[data-market-intel-mcp-runtime-promotion-refresh]') : null; const mcpRuntimePromotionEndpoint = "{{ url_for('market_intel.market_intel_mcp_runtime_promotion') }}"; + const mcpManualFetchHandoffMeta = mcpManualFetchHandoffRoot ? mcpManualFetchHandoffRoot.querySelector('[data-market-intel-mcp-manual-fetch-handoff-meta]') : null; + const mcpManualFetchHandoffBody = mcpManualFetchHandoffRoot ? mcpManualFetchHandoffRoot.querySelector('[data-market-intel-mcp-manual-fetch-handoff-body]') : null; + const mcpManualFetchHandoffInput = mcpManualFetchHandoffRoot ? mcpManualFetchHandoffRoot.querySelector('[data-market-intel-mcp-manual-fetch-handoff-input]') : null; + const mcpManualFetchHandoffReview = mcpManualFetchHandoffRoot ? mcpManualFetchHandoffRoot.querySelector('[data-market-intel-mcp-manual-fetch-handoff-review]') : null; + const mcpManualFetchHandoffRefresh = mcpManualFetchHandoffRoot ? mcpManualFetchHandoffRoot.querySelector('[data-market-intel-mcp-manual-fetch-handoff-refresh]') : null; + const mcpManualFetchHandoffEndpoint = "{{ url_for('market_intel.market_intel_mcp_manual_fetch_handoff') }}"; const manualSampleMeta = manualSampleRoot ? manualSampleRoot.querySelector('[data-market-intel-manual-sample-meta]') : null; const manualSampleBody = manualSampleRoot ? manualSampleRoot.querySelector('[data-market-intel-manual-sample-body]') : null; const manualSampleRefresh = manualSampleRoot ? manualSampleRoot.querySelector('[data-market-intel-manual-sample-refresh]') : null; @@ -2546,6 +2579,122 @@ } }; + const renderMcpManualFetchHandoffMeta = data => { + mcpManualFetchHandoffMeta.innerHTML = [ + `mode=${data.mode || 'unknown'}`, + `accepted=${data.manual_fetch_handoff_accepted ? 'yes' : 'no'}`, + `gates=${data.passed_gate_count || 0}/${data.gate_count || 0}`, + `promotion=${data.runtime_promotion_accepted ? 'ok' : 'pending'}`, + `network=${data.network_request_allowed ? 'open' : 'closed'}`, + `persisted=${data.handoff_persisted ? 'yes' : 'no'}` + ].map(item => `${escapeHtml(item)}`).join(''); + }; + + const renderMcpManualFetchHandoffBody = data => { + const blockers = (data.blocked_reasons || []).join(' / '); + const gates = data.gates || []; + const promotion = data.promotion_summary || {}; + const fetchGate = data.fetch_gate_summary || {}; + const steps = data.next_operator_steps || []; + const renderCheck = (key, label, status) => ` +
+
+ ${escapeHtml(key)} + ${escapeHtml(label || '')} +
+ ${escapeHtml(status)} +
+ `; + mcpManualFetchHandoffBody.innerHTML = ` +
此 handoff 只把 runtime promotion 與操作員安全確認交接到人工 fetch gate;API 不打開抓取、不連外、不開 DB、不保存 payload。${blockers ? `阻擋:${escapeHtml(blockers)}` : ''}
+
+
+

HANDOFF GATES

+
${ + gates.length + ? gates.map(item => renderCheck(item.key, item.label, item.passed ? 'PASS' : 'BLOCK')).join('') + : '
尚未提供 handoff gates。
' + }
+
+
+

PROMOTION / FETCH GATE

+
+ ${renderCheck( + 'runtime_promotion', + `${promotion.passed_gate_count || 0}/${promotion.gate_count || 0} gates`, + promotion.accepted ? 'ACCEPTED' : 'PENDING' + )} + ${renderCheck( + 'fetch_gate', + `${fetchGate.mode || 'unknown'} / blockers=${(fetchGate.blocked_reasons || []).length}`, + fetchGate.network_request_allowed ? 'OPEN' : 'CLOSED' + )} + ${renderCheck( + 'api_boundary', + 'no external network / no DB / no scheduler from this API', + data.manual_fetch_gate_opened_by_api ? 'BLOCK' : 'CLOSED' + )} +
+
+
+

NEXT

+
${ + steps.map((item, index) => renderCheck(`step_${index + 1}`, item, 'MANUAL')).join('') + }
+
+
+ `; + if (mcpManualFetchHandoffInput && !mcpManualFetchHandoffInput.value.trim() && data.sample_handoff_package) { + mcpManualFetchHandoffInput.value = JSON.stringify(data.sample_handoff_package, null, 2); + } + }; + + const loadMcpManualFetchHandoff = async () => { + if (!mcpManualFetchHandoffMeta || !mcpManualFetchHandoffBody) return; + mcpManualFetchHandoffBody.innerHTML = '
讀取 MCP Manual Fetch Handoff 審核中...
'; + try { + const response = await fetch(mcpManualFetchHandoffEndpoint, { credentials: 'same-origin' }); + if (!response.ok) throw new Error(`HTTP ${response.status}`); + const data = await response.json(); + renderMcpManualFetchHandoffMeta(data); + renderMcpManualFetchHandoffBody(data); + } catch (error) { + mcpManualFetchHandoffMeta.innerHTML = 'error'; + mcpManualFetchHandoffBody.innerHTML = `
MCP Manual Fetch Handoff 審核讀取失敗:${escapeHtml(error.message)}
`; + } + }; + + const reviewMcpManualFetchHandoff = async () => { + if (!mcpManualFetchHandoffMeta || !mcpManualFetchHandoffBody || !mcpManualFetchHandoffInput) return; + let parsed; + try { + parsed = JSON.parse(mcpManualFetchHandoffInput.value || '{}'); + } catch (error) { + mcpManualFetchHandoffMeta.innerHTML = 'json_error'; + mcpManualFetchHandoffBody.innerHTML = `
JSON 格式錯誤:${escapeHtml(error.message)}
`; + return; + } + mcpManualFetchHandoffBody.innerHTML = '
審核 MCP Manual Fetch Handoff 中...
'; + try { + const response = await fetch(mcpManualFetchHandoffEndpoint, { + method: 'POST', + credentials: 'same-origin', + headers: { + 'Content-Type': 'application/json', + 'X-CSRFToken': csrfToken + }, + body: JSON.stringify({ handoff_package: parsed }) + }); + const data = await response.json(); + if (!response.ok && !data.mode) throw new Error(`HTTP ${response.status}`); + renderMcpManualFetchHandoffMeta(data); + renderMcpManualFetchHandoffBody(data); + } catch (error) { + mcpManualFetchHandoffMeta.innerHTML = 'error'; + mcpManualFetchHandoffBody.innerHTML = `
MCP Manual Fetch Handoff 審核失敗:${escapeHtml(error.message)}
`; + } + }; + const renderManualSampleMeta = data => { manualSampleMeta.innerHTML = [ `mode=${data.mode || 'unknown'}`, @@ -11967,6 +12116,12 @@ if (mcpRuntimePromotionReview) { mcpRuntimePromotionReview.addEventListener('click', reviewMcpRuntimePromotion); } + if (mcpManualFetchHandoffRefresh) { + mcpManualFetchHandoffRefresh.addEventListener('click', loadMcpManualFetchHandoff); + } + if (mcpManualFetchHandoffReview) { + mcpManualFetchHandoffReview.addEventListener('click', reviewMcpManualFetchHandoff); + } if (manualSampleRefresh) { manualSampleRefresh.addEventListener('click', loadManualSample); } @@ -12224,6 +12379,7 @@ loadMcpActivationEvidence(); loadMcpRuntimeSmoke(); loadMcpRuntimePromotion(); + loadMcpManualFetchHandoff(); loadManualSample(); loadSampleAcceptance(); loadSampleReview(); diff --git a/tests/test_market_intel_skeleton.py b/tests/test_market_intel_skeleton.py index 4e16799..4715f01 100644 --- a/tests/test_market_intel_skeleton.py +++ b/tests/test_market_intel_skeleton.py @@ -20,6 +20,9 @@ from services.market_intel.mcp_completion_audit import build_mcp_completion_audi from services.market_intel.mcp_contract import build_mcp_tool_contract_preview from services.market_intel.mcp_deploy_preflight import build_mcp_deploy_preflight_plan from services.market_intel.mcp_fetch_gate import build_mcp_fetch_gate_preview +from services.market_intel.mcp_manual_fetch_handoff import ( + build_mcp_manual_fetch_handoff_preview, +) from services.market_intel.mcp_readiness import build_mcp_readiness_plan from services.market_intel.mcp_runtime_promotion import build_mcp_runtime_promotion_preview from services.market_intel.mcp_runtime_smoke_receipt import build_mcp_runtime_smoke_receipt_preview @@ -949,6 +952,11 @@ def test_market_intel_preview_template_uses_safe_fetch_false_endpoint(): assert "data-market-intel-mcp-runtime-smoke" in template assert "market_intel.market_intel_mcp_runtime_promotion" in template assert "data-market-intel-mcp-runtime-promotion" in template + assert "market_intel.market_intel_mcp_manual_fetch_handoff" in template + assert "data-market-intel-mcp-manual-fetch-handoff" in template + assert "data-market-intel-mcp-manual-fetch-handoff-gates" in template + assert "data-market-intel-mcp-manual-fetch-handoff-summary" in template + assert "data-market-intel-mcp-manual-fetch-handoff-next" in template assert "market_intel.market_intel_manual_sample_plan" in template assert "market_intel.market_intel_manual_sample_acceptance" in template assert "market_intel.market_intel_manual_sample_review" in template @@ -1419,7 +1427,7 @@ def test_legacy_source_bridge_default_is_planned_only(): bridge = MarketIntelService().build_legacy_source_bridge() assert bridge["mode"] == "legacy_source_bridge_planned" - assert bridge["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert bridge["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert bridge["execute_requested"] is False assert bridge["read_only_query_executed"] is False assert bridge["database_connection_opened"] is False @@ -1577,7 +1585,7 @@ def test_mcp_tool_contract_preview_is_read_only_and_whitelisted(): contract = MarketIntelService().build_mcp_tool_contract() assert contract["mode"] == "mcp_tool_contract_preview" - assert contract["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert contract["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert contract["caller"] == "market_intel" assert contract["contract_ready"] is True assert contract["blocked_reasons"] == [] @@ -1710,7 +1718,7 @@ def test_mcp_activation_runbook_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "mcp_activation_runbook_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["deployment_actions_executed"] is False assert data["docker_command_executed"] is False assert data["ssh_command_executed"] is False @@ -1723,7 +1731,7 @@ def test_mcp_fetch_gate_default_blocks_external_fetch(): gate = MarketIntelService().build_mcp_fetch_gate(fetch_requested=True) assert gate["mode"] == "mcp_fetch_gate_planned" - assert gate["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert gate["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert gate["fetch_requested"] is True assert gate["manual_fetch_gate_open"] is False assert gate["network_request_allowed"] is False @@ -1793,7 +1801,7 @@ def test_mcp_fetch_gate_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "mcp_fetch_gate_planned" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["fetch_requested"] is False assert data["network_request_allowed"] is False assert data["external_network_executed"] is False @@ -1807,7 +1815,7 @@ def test_mcp_completion_audit_summarizes_external_and_internal_state(monkeypatch audit = MarketIntelService().build_mcp_completion_audit() assert audit["mode"] == "mcp_completion_audit_preview" - assert audit["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert audit["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert audit["audit_ready_for_operator_review"] is True assert audit["audit_preview_safe"] is True assert audit["external_mcp_runtime_complete"] is False @@ -1881,7 +1889,7 @@ def test_mcp_completion_audit_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "mcp_completion_audit_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["audit_preview_safe"] is True assert data["external_mcp_runtime_complete"] is False assert data["internal_mcp_contract_complete"] is True @@ -1898,11 +1906,11 @@ def test_mcp_completion_audit_route_is_preview_only(): def test_mcp_activation_evidence_preview_is_safe_without_payload(): evidence = build_mcp_activation_evidence_preview( - phase="phase_119_market_intel_mcp_runtime_promotion" + phase="phase_120_market_intel_mcp_manual_fetch_handoff" ) assert evidence["mode"] == "mcp_activation_evidence_preview" - assert evidence["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert evidence["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert evidence["evidence_payload_received"] is False assert evidence["activation_evidence_accepted"] is False assert evidence["ready_for_runtime_promotion"] is False @@ -1927,7 +1935,7 @@ def test_mcp_activation_evidence_accepts_redacted_runtime_evidence(): ] evidence = build_mcp_activation_evidence_preview( evidence=sample, - phase="phase_119_market_intel_mcp_runtime_promotion", + phase="phase_120_market_intel_mcp_manual_fetch_handoff", ) assert evidence["mode"] == "mcp_activation_evidence_review" @@ -1985,12 +1993,12 @@ def test_mcp_activation_evidence_route_get_and_post_are_preview_only(): assert get_response.status_code == 200 assert get_data["mode"] == "mcp_activation_evidence_preview" - assert get_data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert get_data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert get_data["api_executes_health_check"] is False assert get_data["api_writes_database"] is False assert post_response.status_code == 200 assert post_data["mode"] == "mcp_activation_evidence_review" - assert post_data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert post_data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert post_data["activation_evidence_accepted"] is True assert post_data["payload_persisted"] is False assert post_data["api_opens_database_connection"] is False @@ -1999,11 +2007,11 @@ def test_mcp_activation_evidence_route_get_and_post_are_preview_only(): def test_mcp_runtime_smoke_receipt_preview_is_safe_without_payload(): receipt = build_mcp_runtime_smoke_receipt_preview( - phase="phase_119_market_intel_mcp_runtime_promotion" + phase="phase_120_market_intel_mcp_manual_fetch_handoff" ) assert receipt["mode"] == "mcp_runtime_smoke_receipt_preview" - assert receipt["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert receipt["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert receipt["receipt_payload_received"] is False assert receipt["runtime_smoke_receipt_accepted"] is False assert receipt["ready_for_completion_runtime_promotion"] is False @@ -2031,7 +2039,7 @@ def test_mcp_runtime_smoke_receipt_accepts_complete_readiness_receipt(): ] receipt = build_mcp_runtime_smoke_receipt_preview( receipt=sample, - phase="phase_119_market_intel_mcp_runtime_promotion", + phase="phase_120_market_intel_mcp_manual_fetch_handoff", ) assert receipt["mode"] == "mcp_runtime_smoke_receipt_review" @@ -2096,12 +2104,12 @@ def test_mcp_runtime_smoke_receipt_route_get_and_post_are_preview_only(): assert get_response.status_code == 200 assert get_data["mode"] == "mcp_runtime_smoke_receipt_preview" - assert get_data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert get_data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert get_data["api_executes_health_check"] is False assert get_data["api_writes_database"] is False assert post_response.status_code == 200 assert post_data["mode"] == "mcp_runtime_smoke_receipt_review" - assert post_data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert post_data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert post_data["runtime_smoke_receipt_accepted"] is True assert post_data["receipt_persisted"] is False assert post_data["api_opens_database_connection"] is False @@ -2110,11 +2118,11 @@ def test_mcp_runtime_smoke_receipt_route_get_and_post_are_preview_only(): def test_mcp_runtime_promotion_preview_is_safe_without_payload(): promotion = build_mcp_runtime_promotion_preview( - phase="phase_119_market_intel_mcp_runtime_promotion" + phase="phase_120_market_intel_mcp_manual_fetch_handoff" ) assert promotion["mode"] == "mcp_runtime_promotion_preview" - assert promotion["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert promotion["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert promotion["promotion_payload_received"] is False assert promotion["runtime_promotion_accepted"] is False assert promotion["ready_for_completion_runtime_promotion"] is False @@ -2142,7 +2150,7 @@ def test_mcp_runtime_promotion_accepts_evidence_and_receipt_package(): promotion = build_mcp_runtime_promotion_preview( activation_evidence=sample["activation_evidence"], runtime_receipt=sample["runtime_receipt"], - phase="phase_119_market_intel_mcp_runtime_promotion", + phase="phase_120_market_intel_mcp_manual_fetch_handoff", ) assert promotion["mode"] == "mcp_runtime_promotion_review" @@ -2202,23 +2210,133 @@ def test_mcp_runtime_promotion_route_get_and_post_are_preview_only(): assert get_response.status_code == 200 assert get_data["mode"] == "mcp_runtime_promotion_preview" - assert get_data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert get_data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert get_data["api_executes_health_check"] is False assert get_data["api_writes_database"] is False assert post_response.status_code == 200 assert post_data["mode"] == "mcp_runtime_promotion_review" - assert post_data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert post_data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert post_data["runtime_promotion_accepted"] is True assert post_data["promotion_persisted"] is False assert post_data["api_opens_database_connection"] is False assert post_data["api_uses_external_network"] is False +def test_mcp_manual_fetch_handoff_preview_is_safe_without_payload(): + handoff = build_mcp_manual_fetch_handoff_preview( + phase="phase_120_market_intel_mcp_manual_fetch_handoff", + ) + + assert handoff["mode"] == "mcp_manual_fetch_handoff_preview" + assert handoff["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" + assert handoff["handoff_payload_received"] is False + assert handoff["manual_fetch_handoff_accepted"] is False + assert handoff["ready_for_manual_fetch_gate_operator_review"] is False + assert handoff["manual_fetch_gate_opened_by_api"] is False + assert handoff["network_request_allowed"] is False + assert handoff["fetch_executed"] is False + assert handoff["payload_persisted"] is False + assert handoff["handoff_persisted"] is False + assert handoff["api_executes_health_check"] is False + assert handoff["api_opens_database_connection"] is False + assert handoff["api_writes_database"] is False + assert handoff["api_uses_external_network"] is False + assert handoff["database_write_executed"] is False + assert handoff["external_network_executed"] is False + assert handoff["scheduler_attached"] is False + assert "runtime_promotion_payload_or_review_received" in handoff["blocked_reasons"] + assert "operator_acknowledgements_complete" in handoff["blocked_reasons"] + assert "promotion_package" in handoff["sample_handoff_package"] + assert "operator_acknowledgements" in handoff["sample_handoff_package"] + + +def test_mcp_manual_fetch_handoff_accepts_promotion_and_acknowledgements(): + preview = build_mcp_manual_fetch_handoff_preview() + sample = preview["sample_handoff_package"] + handoff = build_mcp_manual_fetch_handoff_preview( + promotion_package=sample["promotion_package"], + operator_acknowledgements=sample["operator_acknowledgements"], + phase="phase_120_market_intel_mcp_manual_fetch_handoff", + ) + + assert handoff["mode"] == "mcp_manual_fetch_handoff_review" + assert handoff["manual_fetch_handoff_accepted"] is True + assert handoff["ready_for_manual_fetch_gate_operator_review"] is True + assert handoff["runtime_promotion_accepted"] is True + assert handoff["operator_acknowledgements_complete"] is True + assert handoff["blocked_reasons"] == [] + assert handoff["passed_gate_count"] == handoff["gate_count"] + assert handoff["promotion_summary"]["accepted"] is True + assert handoff["fetch_gate_summary"]["network_request_allowed"] is False + assert handoff["manual_fetch_gate_opened_by_api"] is False + assert handoff["network_request_allowed"] is False + assert handoff["fetch_executed"] is False + assert handoff["payload_persisted"] is False + assert handoff["handoff_persisted"] is False + assert handoff["api_executes_health_check"] is False + assert handoff["api_writes_database"] is False + assert handoff["external_network_executed"] is False + assert handoff["scheduler_attached"] is False + + +def test_mcp_manual_fetch_handoff_blocks_missing_acknowledgement(): + sample = build_mcp_manual_fetch_handoff_preview()["sample_handoff_package"] + sample["operator_acknowledgements"]["no_scheduler_attach"] = False + + handoff = build_mcp_manual_fetch_handoff_preview( + promotion_package=sample["promotion_package"], + operator_acknowledgements=sample["operator_acknowledgements"], + ) + + assert handoff["manual_fetch_handoff_accepted"] is False + assert handoff["runtime_promotion_accepted"] is True + assert handoff["operator_acknowledgements_complete"] is False + assert "operator_acknowledgements_complete" in handoff["blocked_reasons"] + assert "ack_no_scheduler_attach" in handoff["blocked_reasons"] + assert handoff["network_request_allowed"] is False + assert handoff["database_write_executed"] is False + + +def test_mcp_manual_fetch_handoff_route_get_and_post_are_preview_only(): + from routes.market_intel_routes import market_intel_bp + + app = Flask(__name__) + app.secret_key = "test-secret" + app.register_blueprint(market_intel_bp) + client = app.test_client() + with client.session_transaction() as session: + session["logged_in"] = True + + get_response = client.get("/api/market_intel/mcp_manual_fetch_handoff") + get_data = get_response.get_json() + sample = get_data["sample_handoff_package"] + post_response = client.post( + "/api/market_intel/mcp_manual_fetch_handoff", + json={"handoff_package": sample}, + ) + post_data = post_response.get_json() + + assert get_response.status_code == 200 + assert get_data["mode"] == "mcp_manual_fetch_handoff_preview" + assert get_data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" + assert get_data["api_executes_health_check"] is False + assert get_data["api_writes_database"] is False + assert post_response.status_code == 200 + assert post_data["mode"] == "mcp_manual_fetch_handoff_review" + assert post_data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" + assert post_data["manual_fetch_handoff_accepted"] is True + assert post_data["manual_fetch_gate_opened_by_api"] is False + assert post_data["network_request_allowed"] is False + assert post_data["handoff_persisted"] is False + assert post_data["api_opens_database_connection"] is False + assert post_data["api_uses_external_network"] is False + + def test_manual_sample_plan_preview_blocks_fetch_and_write(): plan = MarketIntelService().build_manual_sample_plan() assert plan["mode"] == "manual_sample_fetch_plan_preview" - assert plan["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert plan["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert plan["ready_for_manual_sample_fetch"] is False assert plan["sample_fetch_executed"] is False assert plan["external_network_executed"] is False @@ -2266,7 +2384,7 @@ def test_manual_sample_plan_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "manual_sample_fetch_plan_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["sample_fetch_executed"] is False assert data["external_network_executed"] is False assert data["database_write_executed"] is False @@ -2277,7 +2395,7 @@ def test_manual_sample_acceptance_preview_blocks_candidate_import(): acceptance = MarketIntelService().build_manual_sample_acceptance() assert acceptance["mode"] == "manual_sample_acceptance_preview" - assert acceptance["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert acceptance["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert acceptance["contract_ready"] is True assert acceptance["sample_result_loaded"] is False assert acceptance["sample_result_accepted"] is False @@ -2319,7 +2437,7 @@ def test_manual_sample_acceptance_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "manual_sample_acceptance_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["sample_result_loaded"] is False assert data["candidate_import_allowed"] is False assert data["external_network_executed"] is False @@ -2331,7 +2449,7 @@ def test_manual_sample_review_preview_is_planned_until_result_loaded(): review = MarketIntelService().build_manual_sample_review() assert review["mode"] == "manual_sample_review_preview" - assert review["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert review["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert review["contract_ready"] is True assert review["sample_result_loaded"] is False assert review["sample_result_reviewed"] is False @@ -2442,7 +2560,7 @@ def test_manual_sample_review_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "manual_sample_review_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["sample_result_loaded"] is False assert data["sample_result_reviewed"] is False assert data["candidate_import_allowed"] is False @@ -2481,7 +2599,7 @@ def test_manual_sample_review_evaluation_preview_accepts_payload_without_persist ) assert review["mode"] == "manual_sample_review_evaluation_preview" - assert review["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert review["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert review["review_request_type"] == "operator_posted_json" assert review["payload_received"] is True assert review["payload_valid_json_object"] is True @@ -2543,7 +2661,7 @@ def test_manual_sample_review_evaluate_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "manual_sample_review_evaluation_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["payload_received"] is True assert data["payload_valid_json_object"] is True assert data["payload_persisted"] is False @@ -2623,7 +2741,7 @@ def test_manual_sample_candidate_handoff_preview_creates_candidates_without_pers ) assert handoff["mode"] == "manual_sample_candidate_handoff_preview" - assert handoff["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert handoff["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert handoff["payload_received"] is True assert handoff["payload_valid_json_object"] is True assert handoff["payload_persisted"] is False @@ -2687,7 +2805,7 @@ def test_manual_sample_candidate_handoff_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "manual_sample_candidate_handoff_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["payload_received"] is True assert data["handoff_ready"] is True assert data["candidate_handoff_created"] is True @@ -2746,7 +2864,7 @@ def test_manual_sample_candidate_queue_draft_preview_builds_review_items_without ) assert queue_draft["mode"] == "manual_sample_candidate_queue_draft_preview" - assert queue_draft["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert queue_draft["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert queue_draft["payload_received"] is True assert queue_draft["payload_valid_json_object"] is True assert queue_draft["payload_persisted"] is False @@ -2820,7 +2938,7 @@ def test_manual_sample_candidate_queue_draft_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "manual_sample_candidate_queue_draft_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["payload_received"] is True assert data["handoff_ready"] is True assert data["queue_draft_ready"] is True @@ -2883,7 +3001,7 @@ def test_manual_sample_candidate_queue_approval_preview_blocks_write_and_maps_ro ) assert approval["mode"] == "manual_sample_candidate_queue_approval_preview" - assert approval["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert approval["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert approval["payload_received"] is True assert approval["payload_valid_json_object"] is True assert approval["payload_persisted"] is False @@ -2961,7 +3079,7 @@ def test_manual_sample_candidate_queue_approval_route_is_post_only_and_no_write( assert response.status_code == 200 assert data["mode"] == "manual_sample_candidate_queue_approval_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["payload_received"] is True assert data["approval_preview_created"] is True assert data["approval_request_created"] is False @@ -3024,7 +3142,7 @@ def test_manual_sample_candidate_queue_transaction_preview_blocks_execution(): ) assert transaction["mode"] == "manual_sample_candidate_queue_transaction_preview" - assert transaction["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert transaction["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert transaction["payload_received"] is True assert transaction["payload_valid_json_object"] is True assert transaction["payload_persisted"] is False @@ -3104,7 +3222,7 @@ def test_manual_sample_candidate_queue_transaction_route_is_post_only_and_no_wri assert response.status_code == 200 assert data["mode"] == "manual_sample_candidate_queue_transaction_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["payload_received"] is True assert data["transaction_preview_created"] is True assert data["transaction_ready"] is False @@ -8815,7 +8933,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_input_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_input_ready"] is False assert data["summary_persistence_telegram_dispatch_report_input_ready"] is False @@ -8890,7 +9008,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_archive "candidate_queue_review_ai_summary_persistence_telegram_dispatch_archive_summary_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_archive_summary_ready"] is False assert ( @@ -9162,7 +9280,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_input_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_input_ready"] is False assert data["summary_persistence_telegram_dispatch_report_input_ready"] is False @@ -9450,7 +9568,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_run_package_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_run_package_ready"] is False assert ( @@ -9760,7 +9878,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_run_readiness_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_run_readiness_ready"] is False assert ( @@ -10063,7 +10181,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_run_receipt_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_run_receipt_passed"] is False assert ( @@ -10322,7 +10440,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_closeout_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_closeout_passed"] is False assert ( @@ -10595,7 +10713,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_archive_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_archive_passed"] is False assert ( @@ -10843,7 +10961,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_archive_summary_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_archive_summary_passed"] is False assert ( @@ -11073,7 +11191,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_handoff_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_handoff_passed"] is False assert data["summary_persistence_telegram_dispatch_report_catalog_handoff_passed"] is False @@ -11310,7 +11428,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_index_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_index_passed"] is False assert data["summary_persistence_telegram_dispatch_report_catalog_index_passed"] is False @@ -11552,7 +11670,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_write_preflight_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_write_preflight_passed"] is False assert ( @@ -11828,7 +11946,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_write_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_write_passed"] is False assert ( @@ -12105,7 +12223,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_run_package_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_run_package_passed"] is False assert ( @@ -12384,7 +12502,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_run_readiness_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_run_readiness_passed"] is False assert ( @@ -12713,7 +12831,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_run_receipt_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_run_receipt_passed"] is False assert ( @@ -12975,7 +13093,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_commit_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_commit_passed"] is False assert ( @@ -13239,7 +13357,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_closeout_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_closeout_passed"] is False assert ( @@ -13509,7 +13627,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_archive_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_archive_passed"] is False assert ( @@ -13797,7 +13915,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_archive_summary_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_archive_summary_passed"] is False assert ( @@ -14084,7 +14202,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_ "candidate_queue_review_ai_summary_persistence_telegram_dispatch_report_catalog_record_final_closeout_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_report_catalog_record_final_closeout_passed"] is False assert ( @@ -14170,7 +14288,7 @@ def test_candidate_queue_writer_preflight_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_preflight_planned" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["read_only_query_executed"] is False assert data["database_connection_opened"] is False @@ -14227,7 +14345,7 @@ def test_candidate_queue_writer_status_route_never_leaks_approval_token(monkeypa assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_cli_blocked" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is True assert data["apply_real_write_requested"] is True assert data["approval_token_present"] is False @@ -14316,7 +14434,7 @@ def test_candidate_queue_writer_postwrite_smoke_route_is_post_only_and_no_write( assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_postwrite_smoke_planned" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["read_only_query_executed"] is False assert data["database_connection_opened"] is False @@ -14370,7 +14488,7 @@ def test_candidate_queue_writer_operator_drill_route_is_post_only_and_no_write() assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_operator_drill_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["operator_drill_ready"] is True assert data["api_executes_cli"] is False assert data["api_reads_approval_token"] is False @@ -14426,7 +14544,7 @@ def test_candidate_queue_writer_run_package_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_run_package_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["package_ready"] is True assert data["package_artifact_created"] is False assert data["api_writes_file"] is False @@ -14492,7 +14610,7 @@ def test_candidate_queue_writer_run_readiness_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_run_readiness_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["ready_for_cli_operator_run"] is True assert data["ready_for_api_database_write"] is False assert data["api_executes_cli"] is False @@ -14794,7 +14912,7 @@ def test_candidate_queue_writer_run_receipt_route_accepts_inline_payload_no_writ assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_run_receipt_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["receipt_passed"] is True assert data["ready_for_api_database_write"] is False assert data["ready_for_scheduler_attach"] is False @@ -14842,7 +14960,7 @@ def test_candidate_queue_writer_run_closeout_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_run_closeout_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["closeout_passed"] is True assert data["ready_for_next_manual_phase"] is True assert data["ready_for_api_database_write"] is False @@ -14891,7 +15009,7 @@ def test_candidate_queue_review_handoff_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_handoff_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["handoff_ready"] is True assert data["ready_for_manual_queue_review"] is True assert data["ready_for_api_database_write"] is False @@ -14949,7 +15067,7 @@ def test_candidate_queue_review_inventory_route_is_post_only_and_no_write(): assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_inventory_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["review_inventory_ready"] is False assert data["ready_for_human_decision_review"] is False @@ -15015,7 +15133,7 @@ def test_candidate_queue_review_decision_route_is_post_only_and_no_write(): assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_decision_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["decision_ready"] is False assert data["ready_for_human_decision_record"] is False assert data["ready_for_api_review_state_update"] is False @@ -15086,7 +15204,7 @@ def test_candidate_queue_review_decision_approval_route_is_post_only_and_no_writ assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_decision_approval_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["approval_ready"] is False assert data["ready_for_review_state_transaction_preview"] is False assert data["ready_for_cli_decision_writer"] is False @@ -15162,7 +15280,7 @@ def test_candidate_queue_review_decision_transaction_route_is_post_only_and_no_w assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_decision_transaction_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["transaction_preview_created"] is False assert data["transaction_ready"] is False assert data["ready_for_manual_shell_update_window"] is False @@ -15244,7 +15362,7 @@ def test_candidate_queue_review_decision_writer_status_route_is_post_only_and_no assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_decision_writer_cli_blocked" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is True assert data["apply_real_write_requested"] is True assert data["approval_token_present"] is False @@ -15330,7 +15448,7 @@ def test_candidate_queue_review_decision_writer_preflight_route_is_post_only_and assert data["mode"] == ( "candidate_queue_review_decision_writer_preflight_preview" ) - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is True assert data["apply_real_write_requested"] is True assert data["read_only_query_executed"] is False @@ -15413,7 +15531,7 @@ def test_candidate_queue_review_decision_writer_postwrite_smoke_route_is_post_on assert data["mode"] == ( "candidate_queue_review_decision_writer_postwrite_smoke_planned" ) - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["read_only_query_executed"] is False assert data["database_connection_opened"] is False @@ -15496,7 +15614,7 @@ def test_candidate_queue_review_decision_writer_operator_drill_route_is_post_onl assert data["mode"] == ( "candidate_queue_review_decision_writer_operator_drill_preview" ) - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["operator_drill_ready"] is False assert data["ready_for_api_review_state_update"] is False assert data["ready_for_api_database_write"] is False @@ -15582,7 +15700,7 @@ def test_candidate_queue_review_decision_writer_run_package_route_is_post_only_a assert data["mode"] == ( "candidate_queue_review_decision_writer_run_package_preview" ) - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["package_ready"] is False assert data["package_artifact_created"] is False assert data["ready_for_api_review_state_update"] is False @@ -15673,7 +15791,7 @@ def test_candidate_queue_review_decision_writer_run_readiness_route_is_post_only "candidate_queue_review_decision_writer_run_readiness_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["ready_for_cli_operator_run"] is False assert data["ready_for_api_review_state_update"] is False @@ -15783,7 +15901,7 @@ def test_candidate_queue_review_decision_writer_run_receipt_route_is_post_only_a "candidate_queue_review_decision_writer_run_receipt_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["receipt_passed"] is False assert data["ready_for_api_review_state_update"] is False @@ -15869,7 +15987,7 @@ def test_candidate_queue_review_decision_writer_run_closeout_route_is_post_only_ "candidate_queue_review_decision_writer_run_closeout_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["closeout_passed"] is False assert data["ready_for_api_review_state_update"] is False @@ -15926,7 +16044,7 @@ def test_candidate_queue_review_decision_post_closeout_inventory_route_is_post_o "candidate_queue_review_decision_post_closeout_inventory_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["post_closeout_inventory_ready"] is False assert data["ready_for_api_review_state_update"] is False @@ -15979,7 +16097,7 @@ def test_candidate_queue_review_completion_archive_route_is_post_only_and_no_wri assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_completion_archive_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["review_completion_archive_ready"] is False assert data["archive_manifest_ready"] is False assert data["ready_for_api_review_state_update"] is False @@ -16032,7 +16150,7 @@ def test_candidate_queue_review_archive_summary_route_is_post_only_and_no_write( assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_archive_summary_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["archive_summary_ready"] is False assert data["summary_input_ready"] is False assert data["ready_for_ai_summary_generation"] is False @@ -16093,7 +16211,7 @@ def test_candidate_queue_review_ai_summary_preflight_route_is_post_only_and_no_w assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_ai_summary_preflight_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["ai_summary_preflight_ready"] is False assert data["ready_for_manual_ollama_summary_run"] is False assert data["ready_for_ai_summary_generation"] is False @@ -16162,7 +16280,7 @@ def test_candidate_queue_review_ai_summary_run_package_route_is_post_only_and_no assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_ai_summary_run_package_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["ai_summary_run_package_ready"] is False assert data["ready_for_manual_ollama_summary_run"] is False assert data["ready_for_ai_summary_generation"] is False @@ -16234,7 +16352,7 @@ def test_candidate_queue_review_ai_summary_output_receipt_route_is_post_only_and assert get_response.status_code == 405 assert response.status_code == 200 assert data["mode"] == "candidate_queue_review_ai_summary_output_receipt_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["ai_summary_output_receipt_ready"] is False assert data["ready_for_summary_persistence_review"] is False assert data["manual_ai_summary_output_provided"] is False @@ -16307,7 +16425,7 @@ def test_candidate_queue_review_ai_summary_persistence_preflight_route_is_post_o "candidate_queue_review_ai_summary_persistence_preflight_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["summary_persistence_preflight_ready"] is False assert data["ready_for_summary_transaction_preview"] is False @@ -16378,7 +16496,7 @@ def test_candidate_queue_review_ai_summary_persistence_transaction_route_is_post "candidate_queue_review_ai_summary_persistence_transaction_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["summary_persistence_transaction_ready"] is False assert data["ready_for_summary_persistence_writer_gate"] is False @@ -16443,7 +16561,7 @@ def test_candidate_queue_review_ai_summary_persistence_writer_preflight_route_is "candidate_queue_review_ai_summary_persistence_writer_preflight_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["summary_persistence_writer_preflight_ready"] is False assert data["ready_for_summary_persistence_run_package"] is False @@ -16514,7 +16632,7 @@ def test_candidate_queue_review_ai_summary_persistence_run_package_route_is_post "candidate_queue_review_ai_summary_persistence_run_package_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["package_ready"] is False assert data["ready_for_summary_persistence_run_readiness"] is False @@ -16587,7 +16705,7 @@ def test_candidate_queue_review_ai_summary_persistence_run_readiness_route_is_po "candidate_queue_review_ai_summary_persistence_run_readiness_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["run_readiness_ready"] is False assert data["summary_persistence_run_readiness_ready"] is False @@ -16664,7 +16782,7 @@ def test_candidate_queue_review_ai_summary_persistence_run_receipt_route_is_post "candidate_queue_review_ai_summary_persistence_run_receipt_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["run_receipt_passed"] is False assert data["summary_persistence_run_receipt_passed"] is False @@ -16741,7 +16859,7 @@ def test_candidate_queue_review_ai_summary_persistence_run_closeout_route_is_pos "candidate_queue_review_ai_summary_persistence_run_closeout_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["closeout_passed"] is False assert data["summary_persistence_closeout_passed"] is False @@ -16818,7 +16936,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_gate_ro "candidate_queue_review_ai_summary_persistence_telegram_dispatch_gate_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_gate_passed"] is False assert data["summary_persistence_telegram_dispatch_gate_passed"] is False @@ -16892,7 +17010,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_run_pac "candidate_queue_review_ai_summary_persistence_telegram_dispatch_run_package_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_run_package_ready"] is False assert data["summary_persistence_telegram_dispatch_run_package_ready"] is False @@ -16971,7 +17089,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_run_rea "candidate_queue_review_ai_summary_persistence_telegram_dispatch_run_readiness_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_run_readiness_ready"] is False assert ( @@ -17058,7 +17176,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_run_rec "candidate_queue_review_ai_summary_persistence_telegram_dispatch_run_receipt_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_run_receipt_passed"] is False assert data["summary_persistence_telegram_dispatch_run_receipt_passed"] is False @@ -17139,7 +17257,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_closeou "candidate_queue_review_ai_summary_persistence_telegram_dispatch_closeout_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_closeout_passed"] is False assert data["summary_persistence_telegram_dispatch_closeout_passed"] is False @@ -17221,7 +17339,7 @@ def test_candidate_queue_review_ai_summary_persistence_telegram_dispatch_archive "candidate_queue_review_ai_summary_persistence_telegram_dispatch_archive_preview" ) assert data["phase"] == ( - "phase_119_market_intel_mcp_runtime_promotion" + "phase_120_market_intel_mcp_manual_fetch_handoff" ) assert data["telegram_dispatch_archive_ready"] is False assert data["summary_persistence_telegram_dispatch_archive_ready"] is False @@ -17304,7 +17422,7 @@ def test_candidate_queue_writer_run_receipt_route_is_post_only_and_no_write(): assert response.status_code == 200 assert data["mode"] == "candidate_queue_writer_run_receipt_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["receipt_passed"] is True assert data["ready_for_next_manual_review"] is True assert data["ready_for_api_database_write"] is False @@ -17329,7 +17447,7 @@ def test_scheduler_plan_preview_blocks_job_attachment(): plan = MarketIntelService().build_scheduler_plan() assert plan["mode"] == "scheduler_attach_plan_preview" - assert plan["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert plan["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert plan["ready_to_attach_scheduler"] is False assert plan["scheduler_attached"] is False assert plan["scheduler_registration_executed"] is False @@ -17367,7 +17485,7 @@ def test_scheduler_plan_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "scheduler_attach_plan_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["scheduler_registration_executed"] is False assert data["crawler_job_started"] is False assert data["external_network_executed"] is False @@ -17378,7 +17496,7 @@ def test_match_review_plan_preview_blocks_auto_confirm(): plan = MarketIntelService().build_match_review_plan() assert plan["mode"] == "match_review_plan_preview" - assert plan["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert plan["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert plan["ready_for_review_queue"] is False assert plan["review_queue_created"] is False assert plan["auto_match_executed"] is False @@ -17414,7 +17532,7 @@ def test_match_review_plan_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "match_review_plan_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["review_queue_created"] is False assert data["auto_confirm_executed"] is False assert data["external_network_executed"] is False @@ -17425,7 +17543,7 @@ def test_opportunity_plan_preview_blocks_alerts_and_ai_summary(): plan = MarketIntelService().build_opportunity_plan() assert plan["mode"] == "opportunity_plan_preview" - assert plan["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert plan["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert plan["ready_for_opportunity_queue"] is False assert plan["opportunity_queue_created"] is False assert plan["threat_alert_dispatched"] is False @@ -17466,7 +17584,7 @@ def test_opportunity_plan_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "opportunity_plan_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["opportunity_queue_created"] is False assert data["threat_alert_dispatched"] is False assert data["ai_summary_generated"] is False @@ -17477,7 +17595,7 @@ def test_opportunity_scoring_plan_preview_blocks_scoring_and_alerts(): plan = MarketIntelService().build_opportunity_scoring_plan() assert plan["mode"] == "opportunity_scoring_plan_preview" - assert plan["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert plan["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert plan["ready_for_scoring_job"] is False assert plan["scoring_job_created"] is False assert plan["score_calculation_executed"] is False @@ -17525,7 +17643,7 @@ def test_opportunity_scoring_plan_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "opportunity_scoring_plan_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["scoring_job_created"] is False assert data["score_calculation_executed"] is False assert data["sample_scores_generated"] is False @@ -17537,7 +17655,7 @@ def test_opportunity_evidence_plan_preview_blocks_queries_and_alerts(): plan = MarketIntelService().build_opportunity_evidence_plan() assert plan["mode"] == "opportunity_evidence_plan_preview" - assert plan["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert plan["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert plan["ready_for_evidence_bundle"] is False assert plan["evidence_bundle_created"] is False assert plan["evidence_query_executed"] is False @@ -17583,7 +17701,7 @@ def test_opportunity_evidence_plan_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "opportunity_evidence_plan_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["evidence_bundle_created"] is False assert data["evidence_query_executed"] is False assert data["sample_evidence_generated"] is False @@ -17596,7 +17714,7 @@ def test_opportunity_alert_plan_preview_blocks_dispatch_and_llm_calls(): plan = MarketIntelService().build_opportunity_alert_plan() assert plan["mode"] == "opportunity_alert_plan_preview" - assert plan["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert plan["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert plan["ready_for_alert_candidates"] is False assert plan["alert_candidate_created"] is False assert plan["alert_queue_created"] is False @@ -17681,7 +17799,7 @@ def test_opportunity_alert_plan_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "opportunity_alert_plan_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["alert_candidate_created"] is False assert data["alert_queue_created"] is False assert data["review_queue_created"] is False @@ -17759,7 +17877,7 @@ def test_mcp_deploy_preflight_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "mcp_external_deploy_preflight_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["deployment_actions_executed"] is False assert data["docker_command_executed"] is False assert data["ssh_command_executed"] is False @@ -17774,7 +17892,7 @@ def test_mcp_readiness_default_is_planned_only(monkeypatch): readiness = MarketIntelService().build_mcp_readiness() assert readiness["mode"] == "mcp_readiness_planned" - assert readiness["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert readiness["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert readiness["execute_requested"] is False assert readiness["router_enabled"] is False assert readiness["external_mcp_complete"] is False @@ -18165,6 +18283,7 @@ def test_deployment_readiness_reports_app_only_release_gate(): assert readiness["checks"]["mcp_activation_evidence_preview_safe"] is True assert readiness["checks"]["mcp_runtime_smoke_receipt_preview_safe"] is True assert readiness["checks"]["mcp_runtime_promotion_preview_safe"] is True + assert readiness["checks"]["mcp_manual_fetch_handoff_preview_safe"] is True assert readiness["checks"]["scheduler_plan_preview_safe"] is True assert readiness["checks"]["manual_sample_plan_preview_safe"] is True assert readiness["checks"]["manual_sample_acceptance_preview_safe"] is True @@ -18539,6 +18658,7 @@ def test_deployment_readiness_reports_app_only_release_gate(): assert "/api/market_intel/mcp_activation_evidence" in readiness["production_smoke_targets"] assert "/api/market_intel/mcp_runtime_smoke_receipt" in readiness["production_smoke_targets"] assert "/api/market_intel/mcp_runtime_promotion" in readiness["production_smoke_targets"] + assert "/api/market_intel/mcp_manual_fetch_handoff" in readiness["production_smoke_targets"] assert "/api/market_intel/scheduler_plan" in readiness["production_smoke_targets"] assert "/api/market_intel/manual_sample_plan" in readiness["production_smoke_targets"] assert "/api/market_intel/manual_sample_acceptance" in readiness["production_smoke_targets"] @@ -18895,6 +19015,14 @@ def test_deployment_readiness_reports_app_only_release_gate(): assert readiness["mcp_runtime_promotion"]["api_executes_health_check"] is False assert readiness["mcp_runtime_promotion"]["api_writes_database"] is False assert readiness["mcp_runtime_promotion"]["api_uses_external_network"] is False + assert readiness["mcp_manual_fetch_handoff"]["mode"] == "mcp_manual_fetch_handoff_preview" + assert readiness["mcp_manual_fetch_handoff"]["handoff_payload_received"] is False + assert readiness["mcp_manual_fetch_handoff"]["payload_persisted"] is False + assert readiness["mcp_manual_fetch_handoff"]["handoff_persisted"] is False + assert readiness["mcp_manual_fetch_handoff"]["manual_fetch_gate_opened_by_api"] is False + assert readiness["mcp_manual_fetch_handoff"]["network_request_allowed"] is False + assert readiness["mcp_manual_fetch_handoff"]["api_writes_database"] is False + assert readiness["mcp_manual_fetch_handoff"]["api_uses_external_network"] is False assert readiness["manual_sample_plan"]["mode"] == "manual_sample_fetch_plan_preview" assert readiness["manual_sample_plan"]["sample_fetch_executed"] is False assert readiness["manual_sample_plan"]["external_network_executed"] is False @@ -22514,7 +22642,7 @@ def test_migration_apply_drill_planned_is_safe_and_manual_only(): drill = MarketIntelService().build_migration_apply_drill() assert drill["mode"] == "migration_apply_drill_preview" - assert drill["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert drill["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert drill["execute_requested"] is False assert drill["schema_state"] == "planned_no_db_probe" assert drill["drill_ready_for_operator_review"] is True @@ -22629,7 +22757,7 @@ def test_migration_apply_drill_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "migration_apply_drill_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["migration_executed"] is False assert data["rollback_executed"] is False @@ -22641,7 +22769,7 @@ def test_migration_catalog_review_planned_is_safe_and_diagnostic(): review = MarketIntelService().build_migration_catalog_review() assert review["mode"] == "migration_catalog_review_preview" - assert review["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert review["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert review["execute_requested"] is False assert review["catalog_state"] == "planned_no_probe" assert review["seed_state"] == "planned_no_probe" @@ -22756,7 +22884,7 @@ def test_migration_catalog_review_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "migration_catalog_review_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["catalog_state"] == "planned_no_probe" assert data["migration_executed"] is False @@ -22769,7 +22897,7 @@ def test_migration_live_smoke_planned_is_preview_only(): smoke = MarketIntelService().build_migration_live_smoke() assert smoke["mode"] == "migration_live_smoke_preview" - assert smoke["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert smoke["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert smoke["execute_requested"] is False assert smoke["smoke_result"] == "planned_no_execution" assert smoke["live_smoke_passed"] is False @@ -22831,7 +22959,7 @@ def test_migration_live_smoke_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "migration_live_smoke_preview" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["smoke_result"] == "planned_no_execution" assert data["migration_executed"] is False @@ -22844,7 +22972,7 @@ def test_live_db_inventory_planned_is_preview_only(): inventory = MarketIntelService().build_live_db_inventory() assert inventory["mode"] == "live_db_inventory_planned" - assert inventory["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert inventory["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert inventory["execute_requested"] is False assert inventory["read_only_query_executed"] is False assert inventory["database_connection_opened"] is False @@ -22988,7 +23116,7 @@ def test_live_db_inventory_route_is_preview_only(): assert response.status_code == 200 assert data["mode"] == "live_db_inventory_planned" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["read_only_query_executed"] is False assert data["database_write_executed"] is False @@ -23224,7 +23352,7 @@ def test_candidate_queue_writer_cli_script_outputs_blocked_gate(tmp_path): assert result.returncode == 0 assert data["mode"] == "candidate_queue_writer_cli_blocked" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["apply_real_write_requested"] is False assert data["writes_executed"] is False @@ -23253,7 +23381,7 @@ def test_review_decision_writer_cli_script_outputs_blocked_gate_without_login_en assert result.returncode == 0 assert data["mode"] == "candidate_queue_review_decision_writer_cli_blocked" - assert data["phase"] == "phase_119_market_intel_mcp_runtime_promotion" + assert data["phase"] == "phase_120_market_intel_mcp_manual_fetch_handoff" assert data["execute_requested"] is False assert data["apply_real_write_requested"] is False assert data["approval_token_present"] is False