V10.503 新增市場情報 writer review handoff gate
This commit is contained in:
OoO
@@ -4,6 +4,7 @@
|
||||
================================================================================
|
||||
|
||||
【已完成】
|
||||
- V10.503 新增市場情報 MCP Fetch Candidate Queue Writer Review Handoff 安全預覽 gate：只審核 post-closeout inventory review 通過後的人工 candidate queue review 交接包，確認 inventory linkage、handoff identity、target table、row count、artifact paths、review contract、forbidden API actions 與 operator confirmation；API 不讀 token、不執行 CLI、不開 DB、不寫 queue、不更新 review_state、不掛 scheduler。
|
||||
- V10.502 修正 AiderHeal 自動修復診斷鏈：先做 ADR-020 檔案白名單再打 110 preflight，`tests/` finding 會明確略過而不誤報 repo preflight；Code Review 完成通知會把全數不在白名單的 finding 標成需人工處理，不再宣稱已觸發 AiderHeal；白名單放行 `services/routes/database` 子目錄 Python 檔，preflight 通知帶 stderr/stdout 細節，健康檢查同時接受 `/health` 回 `ok` 與 `healthy`。
|
||||
- V10.501 新增市場情報 MCP Fetch Candidate Queue Writer Post-Closeout Inventory Review 安全預覽 gate：只審核 closeout review 後由操作員 shell 完成的 live inventory read-only 摘要，確認 closeout linkage、row count、inventory artifact、closeout review artifact、read-only query result、missing/duplicate rows 與 operator confirmation；API 不讀 token、不執行 CLI、不開 DB、不寫 queue、不做 inventory query、不掛 scheduler。
|
||||
- V10.500 新增市場情報 MCP Fetch Candidate Queue Writer Run Closeout Review 安全預覽 gate：只審核 receipt review 通過後的 operator closeout 摘要，確認 receipt linkage、closeout artifact、receipt review artifact、post-closeout inventory plan、writer output / post-write smoke / backup manifest、rollback note 與 operator confirmation；API 不讀 receipt 原文、不讀 token、不執行 CLI、不開 DB、不寫 queue、不做 post-closeout query、不掛 scheduler。
|
||||
|
||||
@@ -350,7 +350,7 @@ YOUTUBE_API_KEY = os.getenv('YOUTUBE_API_KEY', '')
|
||||
# ==========================================
|
||||
# 系統版本與路徑
|
||||
# ==========================================
|
||||
SYSTEM_VERSION = "V10.502"
|
||||
SYSTEM_VERSION = "V10.503"
|
||||
LOG_FILE_PATH = os.path.join(BASE_DIR, 'logs/system.log')
|
||||
public_url = PUBLIC_URL # 用於模板顯示
|
||||
|
||||
|
||||
@@ -173,6 +173,7 @@ EwoooC 目前已有 MOMO EDM / 節慶活動資料、`promo_products`、PChome
|
||||
- 2026-05-31 追加 MCP fetch candidate queue writer run receipt review gate：`services.market_intel.mcp_fetch_candidate_queue_writer_run_receipt_review` 與 `/api/market_intel/mcp_fetch_candidate_queue_writer_run_receipt_review` 在 run readiness 通過後審核 operator shell writer run 的 receipt 摘要，檢查 readiness linkage、run package id、候選/dedupe keys、writer output artifact、post-write smoke artifact、backup path、operator confirmations 與 token redaction；API/UI 不讀 receipt 原文、不讀 approval token、不執行 CLI、不開 DB、不寫 queue、不做 post-write query、不掛 scheduler，只放行到 closeout review。
|
||||
- 2026-05-31 追加 MCP fetch candidate queue writer run closeout review gate：`services.market_intel.mcp_fetch_candidate_queue_writer_run_closeout_review` 與 `/api/market_intel/mcp_fetch_candidate_queue_writer_run_closeout_review` 在 receipt review 通過後審核 operator closeout 摘要，檢查 receipt linkage、closeout artifact、receipt review artifact、post-closeout inventory plan、writer output / post-write smoke / backup manifest、rollback note 與 operator confirmations；API/UI 不讀 receipt 原文、不讀 approval token、不執行 CLI、不開 DB、不寫 queue、不做 post-closeout query、不掛 scheduler，只放行到 read-only post-closeout inventory review。
|
||||
- 2026-05-31 追加 MCP fetch candidate queue writer post-closeout inventory review gate：`services.market_intel.mcp_fetch_candidate_queue_writer_post_closeout_inventory_review` 與 `/api/market_intel/mcp_fetch_candidate_queue_writer_post_closeout_inventory_review` 在 closeout review 通過後審核 operator live inventory read-only 摘要，檢查 closeout linkage、row count、inventory artifact、closeout review artifact、read-only query result、missing/duplicate rows 與 operator confirmations；API/UI 不讀 approval token、不執行 CLI、不開 DB、不寫 queue、不做 inventory query、不掛 scheduler，只放行到 candidate queue review handoff。
|
||||
- 2026-05-31 追加 MCP fetch candidate queue writer review handoff gate：`services.market_intel.mcp_fetch_candidate_queue_writer_review_handoff` 與 `/api/market_intel/mcp_fetch_candidate_queue_writer_review_handoff` 在 post-closeout inventory review 通過後審核 operator candidate queue review handoff 摘要，檢查 inventory linkage、handoff identity、target table、row count、artifact paths、review contract、forbidden API actions 與 operator confirmations；API/UI 不讀 approval token、不執行 CLI、不開 DB、不寫 queue、不更新 review_state、不掛 scheduler，只放行到人工 candidate queue review。
|
||||
- 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 才能升級。
|
||||
|
||||
@@ -51,6 +51,7 @@
|
||||
- 2026-05-31 追記：同步市場情報 MCP fetch candidate queue writer run receipt review gate 後的 `services/market_intel/deployment_readiness.py` 行數；本次新增 `services/market_intel/mcp_fetch_candidate_queue_writer_run_receipt_review.py` 為 688 行，略過 600 行提醒門檻。暫不拆分的理由是 receipt gate 需同時審核 readiness linkage、receipt identity、artifact path policy、operator confirmation、token redaction 與 side-effect blocklist；若下一段 closeout gate 重複相同 path/side-effect policy，應抽出 `mcp_fetch_candidate_queue_writer_policy.py`。
|
||||
- 2026-05-31 追記：同步市場情報 MCP fetch candidate queue writer run closeout review gate 後的 `services/market_intel/deployment_readiness.py` 行數；本次新增 `services/market_intel/mcp_fetch_candidate_queue_writer_run_closeout_review.py` 為 724 行，略過 600 行提醒門檻。暫不拆分的理由是 closeout gate 需同時審核 receipt review linkage、artifact manifest preservation、rollback note、read-only inventory next-step、lightweight preview sample 與 side-effect blocklist；若下一段 post-closeout inventory gate 重複 path/side-effect policy，應抽出 `mcp_fetch_candidate_queue_writer_policy.py`。
|
||||
- 2026-05-31 追記：同步市場情報 MCP fetch candidate queue writer post-closeout inventory review gate 後的 `services/market_intel/deployment_readiness.py` 行數；本次新增 `services/market_intel/mcp_fetch_candidate_queue_writer_post_closeout_inventory_review.py` 為 649 行，略過 600 行提醒門檻。暫不拆分的理由是 inventory gate 需同時審核 closeout linkage、read-only inventory 摘要、artifact path policy、operator boundary confirmation 與 side-effect blocklist；後續若 candidate queue review handoff 再複用同一套 path/side-effect policy，應抽出 `mcp_fetch_candidate_queue_writer_policy.py`。
|
||||
- 2026-05-31 追記：同步市場情報 MCP fetch candidate queue writer review handoff gate 後的 `services/market_intel/deployment_readiness.py` 行數；本次將 sample payload 抽到 `services/market_intel/mcp_fetch_candidate_queue_writer_review_handoff_sample.py`（105 行），主 gate `services/market_intel/mcp_fetch_candidate_queue_writer_review_handoff.py` 降為 571 行，低於 600 行提醒門檻；後續若 candidate queue review inventory 繼續複用 path/side-effect policy，應抽出 `mcp_fetch_candidate_queue_writer_policy.py`。
|
||||
- 2026-05-24 追記：同步背景 Code Review 111 fallback 保護合併後的 `services/code_review_pipeline_service.py` 行數；此處只更新 inventory，不變更 Code Review 行為。
|
||||
- 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，不變更模組化決策。
|
||||
@@ -103,7 +104,7 @@
|
||||
| 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 |
|
||||
| 917 | `routes/market_intel_routes.py` | P2 market intel Blueprint | page route / API route glue / MCP gate route registration helper |
|
||||
| 1583 | `services/market_intel/deployment_readiness.py` | P2 market intel deployment readiness | preflight gates / readiness payload / route contract helpers |
|
||||
| 1655 | `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 |
|
||||
|
||||
## 市場情報開發前置禁區
|
||||
|
||||
@@ -98,6 +98,7 @@
|
||||
- 2026-05-31 起，`V10.500` 新增市場情報 MCP Fetch Candidate Queue Writer Run Closeout Review gate：在 receipt review 通過後只審核 operator closeout 摘要，要求 receipt linkage、closeout artifact、receipt review artifact、post-closeout inventory plan、writer output / post-write smoke / backup manifest、rollback note 與 operator confirmation 對齊；仍不讀 receipt 原文、不讀 token、不執行 CLI、不開 DB、不寫 queue、不做 post-closeout query、不掛 scheduler，只放行到 read-only post-closeout inventory review。
|
||||
- 2026-05-31 起，`V10.501` 新增市場情報 MCP Fetch Candidate Queue Writer Post-Closeout Inventory Review gate：在 closeout review 通過後只審核 operator live inventory read-only 摘要，要求 closeout linkage、row count、inventory artifact、closeout review artifact、read-only query result、missing/duplicate rows 與 operator confirmation 對齊；仍不讀 token、不執行 CLI、不開 DB、不寫 queue、不做 inventory query、不掛 scheduler，只放行到 candidate queue review handoff。
|
||||
- 2026-05-31 起，`V10.502` 修正 AiderHeal 自動修復診斷鏈：先檢查 ADR-020 檔案白名單再執行 110 preflight，`tests/` finding 會明確略過而不誤報 repo preflight；Code Review 完成通知會把全數不在白名單的 finding 標成需人工處理，不再宣稱已觸發 AiderHeal；白名單放行 `services/routes/database` 子目錄 Python 檔，preflight 通知帶遠端錯誤細節，健康檢查接受 `/health` 回 `healthy`。
|
||||
- 2026-05-31 起，`V10.503` 新增市場情報 MCP Fetch Candidate Queue Writer Review Handoff gate：在 post-closeout inventory review 通過後只審核 operator candidate queue review handoff 摘要，要求 inventory linkage、handoff identity、target table、row count、artifact paths、review contract、forbidden API actions 與 operator confirmation 對齊；仍不讀 token、不執行 CLI、不開 DB、不寫 queue、不更新 review_state、不掛 scheduler，只放行到人工 candidate queue review。
|
||||
|
||||
## 3. 12 Agent 決策信封整合
|
||||
|
||||
|
||||
@@ -13,6 +13,7 @@
|
||||
## 📅 詳細更新日誌 (考古存檔)
|
||||
|
||||
### 2026-05-24：PChome 近門檻身份回收第二輪
|
||||
- **V10.503 市場情報 MCP Fetch Candidate Queue Writer Review Handoff gate**: 新增 `/api/market_intel/mcp_fetch_candidate_queue_writer_review_handoff` 與 UI preview，只審核 post-closeout inventory review 通過後的 operator candidate queue review handoff 摘要；要求 inventory linkage、handoff identity、target table、row count、artifact paths、review contract、forbidden API actions 與 operator confirmation 對齊，且 API 不讀 token、不執行 CLI、不開 DB、不寫 queue、不更新 review_state、不掛 scheduler，只放行到人工 candidate queue review。
|
||||
- **V10.502 AiderHeal 自動修復診斷鏈修正**: `execute_code_fix()` 改為先檢查 ADR-020 檔案白名單再執行 110 preflight，避免 `tests/...` 這類不得自動修的 finding 被誤報成 `/home/wooo/ewoooc` preflight 失敗；Code Review 完成通知會把全數不在白名單的 finding 標成需人工處理，不再宣稱已觸發 AiderHeal；白名單同步放行 `services/routes/database` 子目錄 Python 檔，preflight 通知帶 stderr/stdout 細節，健康檢查接受正式 `/health` 回傳的 `healthy`。
|
||||
- **V10.501 市場情報 MCP Fetch Candidate Queue Writer Post-Closeout Inventory Review gate**: 新增 `/api/market_intel/mcp_fetch_candidate_queue_writer_post_closeout_inventory_review` 與 UI preview，只審核 closeout review 通過後的 operator live inventory read-only 摘要；要求 closeout linkage、row count、inventory artifact、closeout review artifact、read-only query result、missing/duplicate rows 與 operator confirmation 對齊，且 API 不讀 token、不執行 CLI、不開 DB、不寫 queue、不做 inventory query、不掛 scheduler，只放行到 candidate queue review handoff。
|
||||
- **V10.500 市場情報 MCP Fetch Candidate Queue Writer Run Closeout Review gate**: 新增 `/api/market_intel/mcp_fetch_candidate_queue_writer_run_closeout_review` 與 UI preview，只審核 receipt review 通過後的 operator closeout 摘要；要求 receipt linkage、closeout artifact、receipt review artifact、post-closeout inventory plan、writer output / post-write smoke / backup manifest、rollback note 與 operator confirmation 對齊，且 API 不讀 receipt 原文、不讀 token、不執行 CLI、不開 DB、不寫 queue、不做 post-closeout query、不掛 scheduler，只放行到 read-only post-closeout inventory review。
|
||||
|
||||
@@ -46,6 +46,9 @@ from services.market_intel.mcp_fetch_candidate_queue_writer_run_closeout_review
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_post_closeout_inventory_review import (
|
||||
build_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review_preview,
|
||||
)
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_review_handoff import (
|
||||
build_mcp_fetch_candidate_queue_writer_review_handoff_preview,
|
||||
)
|
||||
|
||||
|
||||
@market_intel_bp.route("/api/market_intel/mcp_fetch_run_package", methods=["GET", "POST"])
|
||||
@@ -602,3 +605,60 @@ def market_intel_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review
|
||||
phase=service.phase,
|
||||
)
|
||||
)
|
||||
|
||||
|
||||
@market_intel_bp.route(
|
||||
"/api/market_intel/mcp_fetch_candidate_queue_writer_review_handoff",
|
||||
methods=["GET", "POST"],
|
||||
)
|
||||
@login_required
|
||||
def market_intel_mcp_fetch_candidate_queue_writer_review_handoff():
|
||||
writer_post_closeout_inventory_review_package = {}
|
||||
writer_post_closeout_inventory_review_result = None
|
||||
operator_handoff = None
|
||||
if request.method == "POST":
|
||||
payload = request.get_json(silent=True) or {}
|
||||
package = (
|
||||
payload.get("writer_review_handoff_package")
|
||||
or payload.get("candidate_queue_writer_review_handoff")
|
||||
or payload.get("review_handoff")
|
||||
or payload.get("operator_handoff_review")
|
||||
or payload.get("operator_handoff")
|
||||
or payload
|
||||
)
|
||||
writer_post_closeout_inventory_review_package = (
|
||||
package.get("writer_post_closeout_inventory_review_package")
|
||||
or package.get("candidate_queue_writer_post_closeout_inventory_review")
|
||||
or package.get("writer_post_closeout_inventory_review")
|
||||
or package.get("post_closeout_inventory_review_package")
|
||||
or package.get("post_closeout_inventory_review")
|
||||
or package.get("operator_inventory_review")
|
||||
or {}
|
||||
)
|
||||
writer_post_closeout_inventory_review_result = (
|
||||
package.get("writer_post_closeout_inventory_review_result")
|
||||
or package.get(
|
||||
"mcp_fetch_candidate_queue_writer_post_closeout_inventory_review"
|
||||
)
|
||||
)
|
||||
operator_handoff = (
|
||||
package.get("operator_handoff")
|
||||
or package.get("candidate_queue_review_handoff")
|
||||
or package.get("writer_review_handoff")
|
||||
or package.get("handoff_payload")
|
||||
or package.get("handoff")
|
||||
)
|
||||
|
||||
service = MarketIntelService()
|
||||
return jsonify(
|
||||
build_mcp_fetch_candidate_queue_writer_review_handoff_preview(
|
||||
writer_post_closeout_inventory_review_package=(
|
||||
writer_post_closeout_inventory_review_package
|
||||
),
|
||||
writer_post_closeout_inventory_review_result=(
|
||||
writer_post_closeout_inventory_review_result
|
||||
),
|
||||
operator_handoff=operator_handoff,
|
||||
phase=service.phase,
|
||||
)
|
||||
)
|
||||
|
||||
@@ -102,6 +102,9 @@ from services.market_intel.mcp_fetch_candidate_queue_writer_run_closeout_review
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_post_closeout_inventory_review import (
|
||||
build_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review_preview,
|
||||
)
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_review_handoff import (
|
||||
build_mcp_fetch_candidate_queue_writer_review_handoff_preview,
|
||||
)
|
||||
from services.market_intel.mcp_manual_fetch_handoff import (
|
||||
build_mcp_manual_fetch_handoff_preview,
|
||||
)
|
||||
@@ -271,6 +274,11 @@ PRODUCTION_SMOKE_TARGETS = (
|
||||
)
|
||||
+ PRODUCTION_SMOKE_TARGETS[-1:]
|
||||
)
|
||||
PRODUCTION_SMOKE_TARGETS = (
|
||||
PRODUCTION_SMOKE_TARGETS[:-1]
|
||||
+ ("/api/market_intel/mcp_fetch_candidate_queue_writer_review_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):
|
||||
@@ -355,6 +363,11 @@ def build_deployment_readiness_preview(*, service, market_intel_tables, schema_s
|
||||
phase=service.phase,
|
||||
)
|
||||
)
|
||||
mcp_fetch_candidate_queue_writer_review_handoff = (
|
||||
build_mcp_fetch_candidate_queue_writer_review_handoff_preview(
|
||||
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()
|
||||
@@ -1180,6 +1193,64 @@ def build_deployment_readiness_preview(*, service, market_intel_tables, schema_s
|
||||
"scheduler_attached"
|
||||
]
|
||||
),
|
||||
"mcp_fetch_candidate_queue_writer_review_handoff_preview_safe": bool(
|
||||
mcp_fetch_candidate_queue_writer_review_handoff["mode"]
|
||||
== "mcp_fetch_candidate_queue_writer_review_handoff_preview"
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"payload_persisted"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"review_handoff_persisted"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"handoff_file_written"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"package_artifact_created"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"api_writes_file"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"api_executes_cli"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"api_reads_approval_token"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"api_opens_database_connection"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"api_writes_database"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"api_updates_review_state"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"api_inventory_query_executed"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"database_write_executed"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"database_commit_executed"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"cli_executed"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"file_written"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"scheduler_attached"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"candidate_queue_persisted"
|
||||
]
|
||||
and not mcp_fetch_candidate_queue_writer_review_handoff[
|
||||
"candidate_review_state_updated"
|
||||
]
|
||||
),
|
||||
"candidate_queue_writer_postwrite_smoke_planned_safe": bool(
|
||||
candidate_queue_writer_postwrite_smoke["mode"]
|
||||
== "candidate_queue_writer_postwrite_smoke_planned"
|
||||
@@ -1506,6 +1577,7 @@ def build_deployment_readiness_preview(*, service, market_intel_tables, schema_s
|
||||
"mcp_fetch_candidate_queue_writer_run_receipt_review": mcp_fetch_candidate_queue_writer_run_receipt_review,
|
||||
"mcp_fetch_candidate_queue_writer_run_closeout_review": mcp_fetch_candidate_queue_writer_run_closeout_review,
|
||||
"mcp_fetch_candidate_queue_writer_post_closeout_inventory_review": mcp_fetch_candidate_queue_writer_post_closeout_inventory_review,
|
||||
"mcp_fetch_candidate_queue_writer_review_handoff": mcp_fetch_candidate_queue_writer_review_handoff,
|
||||
"scheduler_plan": scheduler_plan,
|
||||
"manual_sample_plan": manual_sample_plan,
|
||||
"manual_sample_acceptance": manual_sample_acceptance,
|
||||
|
||||
@@ -0,0 +1,571 @@
|
||||
"""市場情報 MCP fetch candidate queue writer review handoff。
|
||||
|
||||
本模組只審核 post-closeout inventory review 之後的 operator handoff 摘要；
|
||||
API/UI 不讀 approval token、不執行 CLI、不開 DB、不寫 queue、不寫檔、
|
||||
不做 inventory query、不掛 scheduler。
|
||||
"""
|
||||
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_preflight import TARGET_TABLE
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_run_readiness import (
|
||||
ARTIFACT_PREFIX,
|
||||
)
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_post_closeout_inventory_review import (
|
||||
FORBIDDEN_SECRET_KEYS,
|
||||
SAFE_SECRET_METADATA_KEYS,
|
||||
_as_dict,
|
||||
_as_list,
|
||||
_blocked_side_effects,
|
||||
_contains_forbidden_key,
|
||||
_safe_int,
|
||||
_safe_path,
|
||||
_safe_text,
|
||||
build_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review_preview,
|
||||
)
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_review_handoff_sample import (
|
||||
build_sample_writer_review_handoff_package,
|
||||
)
|
||||
|
||||
_HANDOFF_BLOCKED_SIDE_EFFECT_KEYS = (
|
||||
"allow_api_candidate_review_update",
|
||||
"allow_api_execution",
|
||||
"allow_api_file_write",
|
||||
"allow_api_queue_write",
|
||||
"allow_cli_execution",
|
||||
"allow_database_write",
|
||||
"api_candidate_review_update_executed",
|
||||
"api_created_review_handoff_file",
|
||||
"api_created_review_queue",
|
||||
"api_executed_candidate_review",
|
||||
"api_inventory_query_executed",
|
||||
"api_review_handoff_persisted",
|
||||
"api_review_state_update_executed",
|
||||
"api_updates_review_state",
|
||||
"api_writes_review_queue",
|
||||
"candidate_queue_review_created_by_api",
|
||||
"candidate_queue_review_handoff_file_written",
|
||||
"candidate_queue_review_handoff_persisted",
|
||||
"candidate_queue_review_started_by_api",
|
||||
"candidate_review_file_written",
|
||||
"candidate_review_queue_written",
|
||||
"handoff_file_written",
|
||||
"handoff_persisted",
|
||||
"manual_review_record_written",
|
||||
"queue_review_persisted",
|
||||
"review_queue_file_written",
|
||||
"review_queue_row_written",
|
||||
"review_state_update_executed",
|
||||
)
|
||||
|
||||
|
||||
def _blocked_handoff_side_effects(payload):
|
||||
found = list(_blocked_side_effects(payload))
|
||||
|
||||
def visit(value, path):
|
||||
if isinstance(value, dict):
|
||||
for key, item in value.items():
|
||||
normalized_key = str(key).lower()
|
||||
key_path = f"{path}.{key}" if path else key
|
||||
if normalized_key in _HANDOFF_BLOCKED_SIDE_EFFECT_KEYS and bool(item):
|
||||
found.append(key_path)
|
||||
visit(item, key_path)
|
||||
elif isinstance(value, list):
|
||||
for index, item in enumerate(value):
|
||||
visit(item, f"{path}[{index}]")
|
||||
|
||||
visit(payload, "")
|
||||
return sorted(set(found))
|
||||
|
||||
|
||||
def _inventory_review_from_inputs(inventory_package, inventory_result, phase):
|
||||
if isinstance(inventory_result, dict) and inventory_result:
|
||||
return inventory_result
|
||||
|
||||
inventory_package = _as_dict(inventory_package)
|
||||
return build_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review_preview(
|
||||
writer_run_closeout_review_package=(
|
||||
inventory_package.get("writer_run_closeout_review_package")
|
||||
or inventory_package.get("candidate_queue_writer_run_closeout_review")
|
||||
or inventory_package.get("writer_run_closeout_review")
|
||||
or inventory_package.get("run_closeout_review_package")
|
||||
or {}
|
||||
),
|
||||
writer_run_closeout_review_result=(
|
||||
inventory_package.get("writer_run_closeout_review_result")
|
||||
or inventory_package.get(
|
||||
"mcp_fetch_candidate_queue_writer_run_closeout_review"
|
||||
)
|
||||
),
|
||||
operator_inventory=(
|
||||
inventory_package.get("operator_inventory")
|
||||
or inventory_package.get("post_closeout_inventory")
|
||||
or inventory_package.get("writer_post_closeout_inventory")
|
||||
or inventory_package.get("inventory_payload")
|
||||
or inventory_package.get("inventory")
|
||||
),
|
||||
phase=phase,
|
||||
)
|
||||
|
||||
|
||||
def _inventory_review_summary(inventory_result):
|
||||
inventory_result = _as_dict(inventory_result)
|
||||
operator_inventory = _as_dict(inventory_result.get("operator_inventory_summary"))
|
||||
side_effects_clear = bool(
|
||||
not inventory_result.get("payload_persisted")
|
||||
and not inventory_result.get("post_closeout_inventory_review_persisted")
|
||||
and not inventory_result.get("post_closeout_inventory_persisted")
|
||||
and not inventory_result.get("post_closeout_inventory_file_written")
|
||||
and not inventory_result.get("inventory_file_written")
|
||||
and not inventory_result.get("package_artifact_created")
|
||||
and not inventory_result.get("network_request_allowed")
|
||||
and not inventory_result.get("api_executes_cli")
|
||||
and not inventory_result.get("api_reads_approval_token")
|
||||
and not inventory_result.get("api_opens_database_connection")
|
||||
and not inventory_result.get("api_writes_database")
|
||||
and not inventory_result.get("api_writes_file")
|
||||
and not inventory_result.get("api_uses_external_network")
|
||||
and not inventory_result.get("api_inventory_query_executed")
|
||||
and not inventory_result.get("post_closeout_query_executed_by_api")
|
||||
and not inventory_result.get("database_write_executed")
|
||||
and not inventory_result.get("cli_executed")
|
||||
and not inventory_result.get("file_written")
|
||||
and not inventory_result.get("scheduler_attached")
|
||||
and not inventory_result.get("candidate_queue_created")
|
||||
and not inventory_result.get("candidate_queue_persisted")
|
||||
and not inventory_result.get("candidate_review_state_updated")
|
||||
)
|
||||
return {
|
||||
"mode": inventory_result.get("mode"),
|
||||
"accepted": bool(
|
||||
inventory_result.get(
|
||||
"mcp_fetch_candidate_queue_writer_post_closeout_inventory_review_accepted"
|
||||
)
|
||||
),
|
||||
"ready_for_candidate_queue_review_handoff": bool(
|
||||
inventory_result.get("ready_for_candidate_queue_review_handoff")
|
||||
),
|
||||
"inventory_review_id": _safe_text(
|
||||
operator_inventory.get("inventory_review_id"), 160
|
||||
),
|
||||
"closeout_id": _safe_text(operator_inventory.get("closeout_id"), 160),
|
||||
"run_package_id": _safe_text(
|
||||
operator_inventory.get("run_package_id"), 160
|
||||
),
|
||||
"receipt_id": _safe_text(operator_inventory.get("receipt_id"), 160),
|
||||
"target_table": _safe_text(operator_inventory.get("target_table"), 160),
|
||||
"payload_row_count": _safe_int(operator_inventory.get("payload_row_count")),
|
||||
"found_row_count": _safe_int(operator_inventory.get("found_row_count")),
|
||||
"inventory_artifact_path": _safe_text(
|
||||
operator_inventory.get("inventory_artifact_path")
|
||||
),
|
||||
"closeout_review_artifact_path": _safe_text(
|
||||
operator_inventory.get("closeout_review_artifact_path")
|
||||
),
|
||||
"read_only_query_result_path": _safe_text(
|
||||
operator_inventory.get("read_only_query_result_path")
|
||||
),
|
||||
"inventory_artifact_path_safe": bool(
|
||||
operator_inventory.get("inventory_artifact_path_safe")
|
||||
),
|
||||
"closeout_review_artifact_path_safe": bool(
|
||||
operator_inventory.get("closeout_review_artifact_path_safe")
|
||||
),
|
||||
"read_only_query_result_path_safe": bool(
|
||||
operator_inventory.get("read_only_query_result_path_safe")
|
||||
),
|
||||
"side_effects_clear": side_effects_clear,
|
||||
"blocked_reasons": inventory_result.get("blocked_reasons", []),
|
||||
}
|
||||
|
||||
|
||||
def _operator_handoff_summary(operator_handoff):
|
||||
operator_handoff = _as_dict(operator_handoff)
|
||||
confirmations = _as_dict(operator_handoff.get("operator_confirmations"))
|
||||
contract = _as_dict(operator_handoff.get("review_contract"))
|
||||
required_columns = [
|
||||
_safe_text(item, 120)
|
||||
for item in _as_list(contract.get("required_columns"))
|
||||
if _safe_text(item, 120)
|
||||
]
|
||||
allowed_manual_actions = [
|
||||
_safe_text(item, 120)
|
||||
for item in _as_list(contract.get("allowed_manual_actions"))
|
||||
if _safe_text(item, 120)
|
||||
]
|
||||
forbidden_api_actions = [
|
||||
_safe_text(item, 120)
|
||||
for item in _as_list(contract.get("forbidden_api_actions"))
|
||||
if _safe_text(item, 120)
|
||||
]
|
||||
return {
|
||||
"provided_keys": sorted(operator_handoff.keys()),
|
||||
"handoff_id": _safe_text(operator_handoff.get("handoff_id"), 160),
|
||||
"inventory_review_id": _safe_text(
|
||||
operator_handoff.get("inventory_review_id"), 160
|
||||
),
|
||||
"closeout_id": _safe_text(operator_handoff.get("closeout_id"), 160),
|
||||
"run_package_id": _safe_text(operator_handoff.get("run_package_id"), 160),
|
||||
"receipt_id": _safe_text(operator_handoff.get("receipt_id"), 160),
|
||||
"target_table": _safe_text(operator_handoff.get("target_table"), 160),
|
||||
"payload_row_count": _safe_int(operator_handoff.get("payload_row_count")),
|
||||
"expected_payload_row_count": _safe_int(
|
||||
operator_handoff.get("expected_payload_row_count")
|
||||
or operator_handoff.get("payload_row_count")
|
||||
),
|
||||
"expected_review_state": _safe_text(
|
||||
operator_handoff.get("expected_review_state")
|
||||
or contract.get("expected_review_state"),
|
||||
80,
|
||||
),
|
||||
"contract_expected_review_state": _safe_text(
|
||||
contract.get("expected_review_state"), 80
|
||||
),
|
||||
"required_columns": required_columns,
|
||||
"allowed_manual_actions": allowed_manual_actions,
|
||||
"forbidden_api_actions": forbidden_api_actions,
|
||||
"review_scope": _safe_text(operator_handoff.get("review_scope"), 120),
|
||||
"next_queue": _safe_text(operator_handoff.get("next_queue"), 120),
|
||||
"review_queue_artifact_path": _safe_text(
|
||||
operator_handoff.get("review_queue_artifact_path")
|
||||
),
|
||||
"inventory_artifact_path": _safe_text(
|
||||
operator_handoff.get("inventory_artifact_path")
|
||||
),
|
||||
"handoff_artifact_path": _safe_text(
|
||||
operator_handoff.get("handoff_artifact_path")
|
||||
),
|
||||
"review_queue_artifact_path_safe": _safe_path(
|
||||
operator_handoff.get("review_queue_artifact_path"),
|
||||
prefixes=(ARTIFACT_PREFIX,),
|
||||
suffixes=(".json",),
|
||||
),
|
||||
"inventory_artifact_path_safe": _safe_path(
|
||||
operator_handoff.get("inventory_artifact_path"),
|
||||
prefixes=(ARTIFACT_PREFIX,),
|
||||
suffixes=(".json",),
|
||||
),
|
||||
"handoff_artifact_path_safe": _safe_path(
|
||||
operator_handoff.get("handoff_artifact_path"),
|
||||
prefixes=(ARTIFACT_PREFIX,),
|
||||
suffixes=(".json",),
|
||||
),
|
||||
"inventory_reviewed": bool(confirmations.get("inventory_reviewed")),
|
||||
"inventory_artifacts_preserved": bool(
|
||||
confirmations.get("inventory_artifacts_preserved")
|
||||
),
|
||||
"candidate_queue_review_only": bool(
|
||||
confirmations.get("candidate_queue_review_only")
|
||||
),
|
||||
"manual_review_only": bool(
|
||||
confirmations.get("manual_review_only")
|
||||
or confirmations.get("candidate_queue_review_only")
|
||||
),
|
||||
"manual_review_required": bool(confirmations.get("manual_review_required")),
|
||||
"no_approval_token_payload": bool(
|
||||
confirmations.get("no_approval_token_payload")
|
||||
),
|
||||
"no_api_cli_execution": bool(confirmations.get("no_api_cli_execution")),
|
||||
"no_api_database_write": bool(confirmations.get("no_api_database_write")),
|
||||
"no_api_inventory_query": bool(
|
||||
confirmations.get("no_api_inventory_query")
|
||||
),
|
||||
"no_api_file_write": bool(confirmations.get("no_api_file_write")),
|
||||
"no_scheduler_attach": bool(confirmations.get("no_scheduler_attach")),
|
||||
"no_api_review_state_update": bool(
|
||||
confirmations.get("no_api_review_state_update")
|
||||
),
|
||||
"no_api_queue_insert": bool(confirmations.get("no_api_queue_insert")),
|
||||
"api_execution_allowed": bool(operator_handoff.get("api_execution_allowed")),
|
||||
"real_write_allowed_by_api": bool(
|
||||
operator_handoff.get("real_write_allowed_by_api")
|
||||
),
|
||||
"api_candidate_review_allowed": bool(
|
||||
operator_handoff.get("api_candidate_review_allowed")
|
||||
),
|
||||
"api_updates_review_state": bool(operator_handoff.get("api_updates_review_state")),
|
||||
"secret_or_token_submitted_to_api": _contains_forbidden_key(
|
||||
operator_handoff,
|
||||
FORBIDDEN_SECRET_KEYS,
|
||||
safe_keys=SAFE_SECRET_METADATA_KEYS,
|
||||
),
|
||||
"blocked_side_effects": _blocked_handoff_side_effects(operator_handoff),
|
||||
}
|
||||
|
||||
|
||||
def _handoff_gates(*, inventory_received, handoff_received, inventory, handoff):
|
||||
operator_confirmed_boundaries = bool(
|
||||
handoff["inventory_reviewed"]
|
||||
and handoff["inventory_artifacts_preserved"]
|
||||
and handoff["candidate_queue_review_only"]
|
||||
and handoff["manual_review_only"]
|
||||
and handoff["manual_review_required"]
|
||||
and handoff["no_approval_token_payload"]
|
||||
and handoff["no_api_cli_execution"]
|
||||
and handoff["no_api_database_write"]
|
||||
and handoff["no_api_inventory_query"]
|
||||
and handoff["no_api_file_write"]
|
||||
and handoff["no_api_review_state_update"]
|
||||
and handoff["no_api_queue_insert"]
|
||||
and handoff["no_scheduler_attach"]
|
||||
)
|
||||
contract_valid = bool(
|
||||
handoff["expected_review_state"] == "needs_review"
|
||||
and handoff["contract_expected_review_state"] == "needs_review"
|
||||
and {"dedupe_key", "review_state"}.issubset(set(handoff["required_columns"]))
|
||||
and handoff["allowed_manual_actions"]
|
||||
)
|
||||
forbids_api_mutations = bool(
|
||||
{"update_review_state", "insert_missing_queue_row"}.issubset(
|
||||
set(handoff["forbidden_api_actions"])
|
||||
)
|
||||
and handoff["no_api_review_state_update"]
|
||||
and handoff["no_api_queue_insert"]
|
||||
)
|
||||
return [
|
||||
{
|
||||
"key": "post_closeout_inventory_review_payload_or_result_received",
|
||||
"label": "已提供 post-closeout inventory review package 或已審核結果",
|
||||
"passed": inventory_received,
|
||||
},
|
||||
{
|
||||
"key": "post_closeout_inventory_review_accepted",
|
||||
"label": "post-closeout inventory review gate 必須已通過",
|
||||
"passed": inventory["accepted"],
|
||||
},
|
||||
{
|
||||
"key": "post_closeout_inventory_ready_for_handoff",
|
||||
"label": "inventory review 必須只放行到 candidate queue review handoff",
|
||||
"passed": inventory["ready_for_candidate_queue_review_handoff"],
|
||||
},
|
||||
{
|
||||
"key": "post_closeout_inventory_side_effect_free",
|
||||
"label": "inventory review 未顯示 API 執行、寫 DB、寫檔、查 DB 或掛 scheduler",
|
||||
"passed": inventory["side_effects_clear"],
|
||||
},
|
||||
{
|
||||
"key": "post_closeout_inventory_identity_recorded",
|
||||
"label": "inventory review 必須保留 inventory_review_id、closeout_id、run_package_id 與 receipt_id",
|
||||
"passed": bool(
|
||||
inventory["inventory_review_id"]
|
||||
and inventory["closeout_id"]
|
||||
and inventory["run_package_id"]
|
||||
and inventory["receipt_id"]
|
||||
),
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_payload_received",
|
||||
"label": "已提供 operator candidate queue review handoff 摘要",
|
||||
"passed": handoff_received,
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_identity_recorded",
|
||||
"label": "handoff 必須記錄 handoff_id、inventory_review_id、closeout_id、run_package_id 與 receipt_id",
|
||||
"passed": bool(
|
||||
handoff["handoff_id"]
|
||||
and handoff["inventory_review_id"]
|
||||
and handoff["closeout_id"]
|
||||
and handoff["run_package_id"]
|
||||
and handoff["receipt_id"]
|
||||
),
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_identity_matches_inventory",
|
||||
"label": "handoff identity 必須對齊 inventory review",
|
||||
"passed": bool(
|
||||
handoff["inventory_review_id"] == inventory["inventory_review_id"]
|
||||
and handoff["closeout_id"] == inventory["closeout_id"]
|
||||
and handoff["run_package_id"] == inventory["run_package_id"]
|
||||
and handoff["receipt_id"] == inventory["receipt_id"]
|
||||
),
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_target_table_safe",
|
||||
"label": "target table 必須是 market_alert_review_queue",
|
||||
"passed": handoff["target_table"] == TARGET_TABLE,
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_row_count_matches_inventory",
|
||||
"label": "handoff row count 必須對齊 inventory payload rows",
|
||||
"passed": bool(
|
||||
handoff["expected_payload_row_count"]
|
||||
and handoff["expected_payload_row_count"]
|
||||
== inventory["payload_row_count"]
|
||||
and handoff["payload_row_count"] == inventory["payload_row_count"]
|
||||
and inventory["found_row_count"] == inventory["payload_row_count"]
|
||||
),
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_artifact_paths_safe",
|
||||
"label": "review queue、inventory 與 handoff artifact paths 必須安全",
|
||||
"passed": bool(
|
||||
handoff["review_queue_artifact_path_safe"]
|
||||
and handoff["inventory_artifact_path_safe"]
|
||||
and handoff["handoff_artifact_path_safe"]
|
||||
and handoff["inventory_artifact_path"]
|
||||
== inventory["inventory_artifact_path"]
|
||||
),
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_scope_safe",
|
||||
"label": "handoff 僅能交接到 manual candidate queue review",
|
||||
"passed": bool(
|
||||
handoff["review_scope"] == "candidate_queue_review"
|
||||
and handoff["next_queue"] == "manual_candidate_queue_review"
|
||||
),
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_contract_valid",
|
||||
"label": "review contract 必須鎖定 needs_review、必備欄位與人工操作",
|
||||
"passed": contract_valid,
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_forbids_api_mutations",
|
||||
"label": "review contract 必須禁止 API 更新 review_state 或補寫 queue row",
|
||||
"passed": forbids_api_mutations,
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_operator_boundaries_confirmed",
|
||||
"label": "操作員確認僅進人工 review，且 API 未執行 CLI/DB/query/file/scheduler",
|
||||
"passed": operator_confirmed_boundaries,
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_no_api_execution_or_real_write",
|
||||
"label": "handoff payload 不得允許 API execution、real write 或 API review update",
|
||||
"passed": bool(
|
||||
not handoff["api_execution_allowed"]
|
||||
and not handoff["real_write_allowed_by_api"]
|
||||
and not handoff["api_candidate_review_allowed"]
|
||||
and not handoff["api_updates_review_state"]
|
||||
),
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_no_secret_or_token_key",
|
||||
"label": "handoff payload 不得包含 secret、cookie、password 或 token key",
|
||||
"passed": not handoff["secret_or_token_submitted_to_api"],
|
||||
},
|
||||
{
|
||||
"key": "candidate_queue_review_handoff_side_effect_free",
|
||||
"label": "handoff payload 不得要求 API 寫檔、執行、查 DB、寫 DB 或掛 scheduler",
|
||||
"passed": not handoff["blocked_side_effects"],
|
||||
},
|
||||
]
|
||||
|
||||
|
||||
def build_mcp_fetch_candidate_queue_writer_review_handoff_preview(
|
||||
*,
|
||||
writer_post_closeout_inventory_review_package=None,
|
||||
writer_post_closeout_inventory_review_result=None,
|
||||
operator_handoff=None,
|
||||
phase=None,
|
||||
):
|
||||
"""建立 writer review handoff；不執行查詢、寫檔或寫入。"""
|
||||
writer_post_closeout_inventory_review_package = _as_dict(
|
||||
writer_post_closeout_inventory_review_package
|
||||
)
|
||||
inventory_result_received = bool(
|
||||
isinstance(writer_post_closeout_inventory_review_result, dict)
|
||||
and writer_post_closeout_inventory_review_result
|
||||
)
|
||||
handoff_valid_object = (
|
||||
isinstance(operator_handoff, dict) if operator_handoff is not None else True
|
||||
)
|
||||
handoff_payload = _as_dict(operator_handoff)
|
||||
inventory_received = bool(
|
||||
writer_post_closeout_inventory_review_package or inventory_result_received
|
||||
)
|
||||
inventory_result = (
|
||||
_inventory_review_from_inputs(
|
||||
writer_post_closeout_inventory_review_package,
|
||||
writer_post_closeout_inventory_review_result,
|
||||
phase,
|
||||
)
|
||||
if inventory_received
|
||||
else {}
|
||||
)
|
||||
payload_received = bool(
|
||||
inventory_received or handoff_payload or operator_handoff is not None
|
||||
)
|
||||
handoff_received = bool(handoff_payload)
|
||||
inventory = _inventory_review_summary(inventory_result)
|
||||
handoff = _operator_handoff_summary(handoff_payload)
|
||||
gates = _handoff_gates(
|
||||
inventory_received=inventory_received,
|
||||
handoff_received=handoff_received and handoff_valid_object,
|
||||
inventory=inventory,
|
||||
handoff=handoff,
|
||||
)
|
||||
blocked_reasons = [gate["key"] for gate in gates if not gate["passed"]]
|
||||
if not handoff_valid_object:
|
||||
blocked_reasons.append("operator_handoff_payload_valid_object")
|
||||
accepted = bool(payload_received and not blocked_reasons)
|
||||
|
||||
return {
|
||||
"mode": (
|
||||
"mcp_fetch_candidate_queue_writer_review_handoff"
|
||||
if payload_received
|
||||
else "mcp_fetch_candidate_queue_writer_review_handoff_preview"
|
||||
),
|
||||
"phase": phase,
|
||||
"writer_review_handoff_payload_received": payload_received,
|
||||
"review_handoff_payload_received": payload_received,
|
||||
"writer_post_closeout_inventory_review_received": inventory_received,
|
||||
"operator_handoff_received": handoff_received,
|
||||
"operator_handoff_valid_object": handoff_valid_object,
|
||||
"writer_post_closeout_inventory_review_accepted": inventory["accepted"],
|
||||
"mcp_fetch_candidate_queue_writer_review_handoff_accepted": accepted,
|
||||
"candidate_queue_writer_review_handoff_ready": accepted,
|
||||
"ready_for_candidate_queue_review_inventory": accepted,
|
||||
"ready_for_candidate_queue_human_review": accepted,
|
||||
"ready_for_candidate_queue_review_decision": False,
|
||||
"ready_for_api_database_write": False,
|
||||
"ready_for_real_write": False,
|
||||
"ready_for_scheduler_attach": False,
|
||||
"ready_for_candidate_queue_review_api_update": False,
|
||||
"ready_for_api_review_state_update": False,
|
||||
"network_request_allowed": False,
|
||||
"api_executes_cli": False,
|
||||
"api_reads_approval_token": False,
|
||||
"api_opens_database_connection": False,
|
||||
"api_writes_database": False,
|
||||
"api_writes_file": False,
|
||||
"api_uses_external_network": False,
|
||||
"api_inventory_query_executed": False,
|
||||
"api_candidate_review_update_executed": False,
|
||||
"api_updates_review_state": False,
|
||||
"post_closeout_query_executed_by_api": False,
|
||||
"payload_row_count": handoff["payload_row_count"],
|
||||
"gate_count": len(gates),
|
||||
"passed_gate_count": sum(1 for gate in gates if gate["passed"]),
|
||||
"blocked_reasons": blocked_reasons,
|
||||
"gates": gates,
|
||||
"writer_post_closeout_inventory_review_summary": inventory,
|
||||
"operator_handoff_summary": handoff,
|
||||
"sample_writer_review_handoff_package": (
|
||||
build_sample_writer_review_handoff_package()
|
||||
),
|
||||
"next_operator_steps": [
|
||||
"Handoff 通過後，只代表可交給人工 candidate queue review inventory",
|
||||
"API/UI 仍不得自動寫 review state、補寫 queue row、讀 token 或掛 scheduler",
|
||||
"後續 review 必須引用已審核 artifact，並保留人工決策紀錄與 false-positive 保護",
|
||||
],
|
||||
"payload_persisted": False,
|
||||
"review_handoff_persisted": False,
|
||||
"writer_review_handoff_persisted": False,
|
||||
"candidate_queue_review_handoff_persisted": False,
|
||||
"candidate_queue_review_handoff_file_written": False,
|
||||
"handoff_file_written": False,
|
||||
"review_queue_file_written": False,
|
||||
"candidate_review_file_written": False,
|
||||
"package_artifact_created": False,
|
||||
"database_session_created": False,
|
||||
"database_commit_executed": False,
|
||||
"database_write_executed": False,
|
||||
"external_network_executed": False,
|
||||
"cli_executed": False,
|
||||
"file_written": False,
|
||||
"writes_executed": False,
|
||||
"would_write_database": False,
|
||||
"scheduler_attached": False,
|
||||
"candidate_queue_created": False,
|
||||
"candidate_queue_persisted": False,
|
||||
"candidate_review_state_updated": False,
|
||||
}
|
||||
@@ -0,0 +1,105 @@
|
||||
"""Sample payload for the market intel candidate queue review handoff gate."""
|
||||
|
||||
from copy import deepcopy
|
||||
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_preflight import TARGET_TABLE
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_run_readiness import (
|
||||
ARTIFACT_PREFIX,
|
||||
)
|
||||
from services.market_intel.mcp_fetch_candidate_queue_writer_post_closeout_inventory_review import (
|
||||
build_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review_preview,
|
||||
)
|
||||
|
||||
|
||||
_SAMPLE_WRITER_REVIEW_HANDOFF_PACKAGE = None
|
||||
|
||||
|
||||
def build_sample_writer_review_handoff_package():
|
||||
global _SAMPLE_WRITER_REVIEW_HANDOFF_PACKAGE
|
||||
if _SAMPLE_WRITER_REVIEW_HANDOFF_PACKAGE is not None:
|
||||
return deepcopy(_SAMPLE_WRITER_REVIEW_HANDOFF_PACKAGE)
|
||||
|
||||
inventory_preview = (
|
||||
build_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review_preview()
|
||||
)
|
||||
inventory_package = inventory_preview[
|
||||
"sample_writer_post_closeout_inventory_review_package"
|
||||
]
|
||||
inventory_result = (
|
||||
build_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review_preview(
|
||||
writer_run_closeout_review_package=inventory_package[
|
||||
"writer_run_closeout_review_package"
|
||||
],
|
||||
writer_run_closeout_review_result=inventory_package[
|
||||
"writer_run_closeout_review_result"
|
||||
],
|
||||
operator_inventory=inventory_package["operator_inventory"],
|
||||
)
|
||||
)
|
||||
inventory = inventory_result["operator_inventory_summary"]
|
||||
operator_handoff = {
|
||||
"handoff_id": "market-intel-candidate-writer-review-handoff-sample",
|
||||
"inventory_review_id": inventory["inventory_review_id"],
|
||||
"closeout_id": inventory["closeout_id"],
|
||||
"run_package_id": inventory["run_package_id"],
|
||||
"receipt_id": inventory["receipt_id"],
|
||||
"target_table": TARGET_TABLE,
|
||||
"payload_row_count": inventory["payload_row_count"],
|
||||
"expected_payload_row_count": inventory["payload_row_count"],
|
||||
"expected_review_state": "needs_review",
|
||||
"review_scope": "candidate_queue_review",
|
||||
"next_queue": "manual_candidate_queue_review",
|
||||
"review_queue_artifact_path": (
|
||||
ARTIFACT_PREFIX
|
||||
+ "candidate-queue-review-handoff-review-queue-sample.json"
|
||||
),
|
||||
"inventory_artifact_path": inventory["inventory_artifact_path"],
|
||||
"handoff_artifact_path": (
|
||||
ARTIFACT_PREFIX
|
||||
+ "candidate-queue-review-handoff-sample.json"
|
||||
),
|
||||
"review_contract": {
|
||||
"expected_review_state": "needs_review",
|
||||
"required_columns": [
|
||||
"dedupe_key",
|
||||
"review_state",
|
||||
"momo_product_id",
|
||||
"pchome_product_id",
|
||||
],
|
||||
"allowed_manual_actions": [
|
||||
"mark_matched",
|
||||
"mark_low_score",
|
||||
"mark_identity_veto",
|
||||
"request_fresh_search",
|
||||
],
|
||||
"forbidden_api_actions": [
|
||||
"update_review_state",
|
||||
"insert_missing_queue_row",
|
||||
"execute_matching_decision",
|
||||
],
|
||||
},
|
||||
"operator_confirmations": {
|
||||
"inventory_reviewed": True,
|
||||
"inventory_artifacts_preserved": True,
|
||||
"candidate_queue_review_only": True,
|
||||
"manual_review_only": True,
|
||||
"manual_review_required": True,
|
||||
"no_approval_token_payload": True,
|
||||
"no_api_cli_execution": True,
|
||||
"no_api_database_write": True,
|
||||
"no_api_inventory_query": True,
|
||||
"no_api_file_write": True,
|
||||
"no_api_review_state_update": True,
|
||||
"no_api_queue_insert": True,
|
||||
"no_scheduler_attach": True,
|
||||
},
|
||||
"api_execution_allowed": False,
|
||||
"real_write_allowed_by_api": False,
|
||||
"api_candidate_review_allowed": False,
|
||||
}
|
||||
_SAMPLE_WRITER_REVIEW_HANDOFF_PACKAGE = {
|
||||
"writer_post_closeout_inventory_review_package": inventory_package,
|
||||
"writer_post_closeout_inventory_review_result": inventory_result,
|
||||
"operator_handoff": operator_handoff,
|
||||
}
|
||||
return deepcopy(_SAMPLE_WRITER_REVIEW_HANDOFF_PACKAGE)
|
||||
@@ -1,3 +1,3 @@
|
||||
"""市場情報 rollout phase 單一來源。"""
|
||||
|
||||
MARKET_INTEL_PHASE = "phase_134_market_intel_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review"
|
||||
MARKET_INTEL_PHASE = "phase_135_market_intel_mcp_fetch_candidate_queue_writer_review_handoff"
|
||||
|
||||
@@ -1020,6 +1020,32 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="market-intel-panel" data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff>
|
||||
<div class="market-intel-preview-head">
|
||||
<div>
|
||||
<p class="market-intel-muted momo-mono mb-1">MCP / REVIEW HANDOFF</p>
|
||||
<h2 class="market-intel-preview-title">MCP Candidate Queue Writer Review Handoff</h2>
|
||||
</div>
|
||||
<button class="market-intel-icon-button" type="button" title="重新整理 MCP Writer Review Handoff" data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-refresh>
|
||||
<i class="fas fa-rotate-right" aria-hidden="true"></i>
|
||||
</button>
|
||||
</div>
|
||||
<div class="market-intel-preview-meta" data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-meta>
|
||||
<span class="market-intel-pill">loading</span>
|
||||
</div>
|
||||
<div data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-body>
|
||||
<div class="market-intel-empty">讀取 MCP Writer Review Handoff 中...</div>
|
||||
</div>
|
||||
<div class="market-intel-control-row mt-3">
|
||||
<textarea class="market-intel-json-input" rows="9" spellcheck="false" data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-input placeholder="writer post-closeout inventory review and handoff JSON"></textarea>
|
||||
<div class="market-intel-control-actions">
|
||||
<button class="market-intel-icon-button" type="button" title="審核 MCP Writer Review Handoff JSON" data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-review>
|
||||
<i class="fas fa-check" aria-hidden="true"></i>
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="market-intel-panel" data-market-intel-manual-sample>
|
||||
<div class="market-intel-preview-head">
|
||||
<div>
|
||||
@@ -1542,6 +1568,7 @@
|
||||
const mcpFetchCandidateQueueWriterRunReceiptReviewRoot = document.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-run-receipt-review]');
|
||||
const mcpFetchCandidateQueueWriterRunCloseoutReviewRoot = document.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-run-closeout-review]');
|
||||
const mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewRoot = document.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-post-closeout-inventory-review]');
|
||||
const mcpFetchCandidateQueueWriterReviewHandoffRoot = document.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-review-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]');
|
||||
@@ -1558,7 +1585,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 && !mcpManualFetchHandoffRoot && !mcpFetchTargetReviewRoot && !mcpFetchRunPackageRoot && !mcpFetchRunReadinessRoot && !mcpFetchRunReceiptRoot && !mcpFetchResultParserReviewRoot && !mcpFetchCandidateHandoffReviewRoot && !mcpFetchCandidateQueueReviewRoot && !mcpFetchCandidateQueueWriterPreflightRoot && !mcpFetchCandidateQueueWriterCliReviewRoot && !mcpFetchCandidateQueueWriterRunPackageReviewRoot && !mcpFetchCandidateQueueWriterRunReadinessRoot && !mcpFetchCandidateQueueWriterRunReceiptReviewRoot && !mcpFetchCandidateQueueWriterRunCloseoutReviewRoot && !mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewRoot && !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 && !mcpFetchTargetReviewRoot && !mcpFetchRunPackageRoot && !mcpFetchRunReadinessRoot && !mcpFetchRunReceiptRoot && !mcpFetchResultParserReviewRoot && !mcpFetchCandidateHandoffReviewRoot && !mcpFetchCandidateQueueReviewRoot && !mcpFetchCandidateQueueWriterPreflightRoot && !mcpFetchCandidateQueueWriterCliReviewRoot && !mcpFetchCandidateQueueWriterRunPackageReviewRoot && !mcpFetchCandidateQueueWriterRunReadinessRoot && !mcpFetchCandidateQueueWriterRunReceiptReviewRoot && !mcpFetchCandidateQueueWriterRunCloseoutReviewRoot && !mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewRoot && !mcpFetchCandidateQueueWriterReviewHandoffRoot && !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;
|
||||
@@ -1713,6 +1740,12 @@
|
||||
const mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewReview = mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewRoot ? mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewRoot.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-post-closeout-inventory-review-review]') : null;
|
||||
const mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewRefresh = mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewRoot ? mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewRoot.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-post-closeout-inventory-review-refresh]') : null;
|
||||
const mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewEndpoint = "{{ url_for('market_intel.market_intel_mcp_fetch_candidate_queue_writer_post_closeout_inventory_review') }}";
|
||||
const mcpFetchCandidateQueueWriterReviewHandoffMeta = mcpFetchCandidateQueueWriterReviewHandoffRoot ? mcpFetchCandidateQueueWriterReviewHandoffRoot.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-meta]') : null;
|
||||
const mcpFetchCandidateQueueWriterReviewHandoffBody = mcpFetchCandidateQueueWriterReviewHandoffRoot ? mcpFetchCandidateQueueWriterReviewHandoffRoot.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-body]') : null;
|
||||
const mcpFetchCandidateQueueWriterReviewHandoffInput = mcpFetchCandidateQueueWriterReviewHandoffRoot ? mcpFetchCandidateQueueWriterReviewHandoffRoot.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-input]') : null;
|
||||
const mcpFetchCandidateQueueWriterReviewHandoffReview = mcpFetchCandidateQueueWriterReviewHandoffRoot ? mcpFetchCandidateQueueWriterReviewHandoffRoot.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-review]') : null;
|
||||
const mcpFetchCandidateQueueWriterReviewHandoffRefresh = mcpFetchCandidateQueueWriterReviewHandoffRoot ? mcpFetchCandidateQueueWriterReviewHandoffRoot.querySelector('[data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-refresh]') : null;
|
||||
const mcpFetchCandidateQueueWriterReviewHandoffEndpoint = "{{ url_for('market_intel.market_intel_mcp_fetch_candidate_queue_writer_review_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;
|
||||
@@ -4941,6 +4974,131 @@
|
||||
}
|
||||
};
|
||||
|
||||
const renderMcpFetchCandidateQueueWriterReviewHandoffMeta = data => {
|
||||
mcpFetchCandidateQueueWriterReviewHandoffMeta.innerHTML = [
|
||||
`mode=${data.mode || 'unknown'}`,
|
||||
`accepted=${data.mcp_fetch_candidate_queue_writer_review_handoff_accepted ? 'yes' : 'no'}`,
|
||||
`gates=${data.passed_gate_count || 0}/${data.gate_count || 0}`,
|
||||
`rows=${data.payload_row_count || 0}`,
|
||||
`inventory=${data.ready_for_candidate_queue_review_inventory ? 'ready' : 'blocked'}`,
|
||||
`state=${data.api_updates_review_state ? 'api' : 'manual'}`
|
||||
].map(item => `<span class="market-intel-pill">${escapeHtml(item)}</span>`).join('');
|
||||
};
|
||||
|
||||
const renderMcpFetchCandidateQueueWriterReviewHandoffBody = data => {
|
||||
const blockers = (data.blocked_reasons || []).join(' / ');
|
||||
const gates = data.gates || [];
|
||||
const inventory = data.writer_post_closeout_inventory_review_summary || {};
|
||||
const handoff = data.operator_handoff_summary || {};
|
||||
const steps = data.next_operator_steps || [];
|
||||
const renderCheck = (key, label, status) => `
|
||||
<div class="market-intel-check">
|
||||
<div>
|
||||
<strong>${escapeHtml(key)}</strong>
|
||||
<small>${escapeHtml(label || '')}</small>
|
||||
</div>
|
||||
<span>${escapeHtml(status)}</span>
|
||||
</div>
|
||||
`;
|
||||
mcpFetchCandidateQueueWriterReviewHandoffBody.innerHTML = `
|
||||
<div class="market-intel-empty mb-3">此 review handoff 只把已通過的 post-closeout inventory 交接給人工 candidate queue review；API 不更新 review_state、不補寫 queue row、不讀 approval token、不執行 CLI、不掛 scheduler。${blockers ? `阻擋：${escapeHtml(blockers)}` : ''}</div>
|
||||
<div class="market-intel-deploy-grid">
|
||||
<div data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-gates>
|
||||
<p class="market-intel-deploy-section-title">HANDOFF GATES</p>
|
||||
<div class="market-intel-check-list">${
|
||||
gates.length
|
||||
? gates.map(item => renderCheck(item.key, item.label, item.passed ? 'PASS' : 'BLOCK')).join('')
|
||||
: '<div class="market-intel-empty">尚未提供 handoff gates。</div>'
|
||||
}</div>
|
||||
</div>
|
||||
<div data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-inventory>
|
||||
<p class="market-intel-deploy-section-title">INVENTORY LINK</p>
|
||||
<div class="market-intel-check-list">
|
||||
${renderCheck('inventory_review', `${inventory.accepted ? 'accepted' : 'pending'} / rows=${inventory.payload_row_count || 0}`, inventory.accepted ? 'ACCEPTED' : 'PENDING')}
|
||||
${renderCheck('inventory_review_id', inventory.inventory_review_id || 'missing', inventory.inventory_review_id ? 'LINKED' : 'BLOCK')}
|
||||
${renderCheck('found_rows', `${inventory.found_row_count || 0}/${inventory.payload_row_count || 0}`, inventory.found_row_count === inventory.payload_row_count ? 'MATCH' : 'BLOCK')}
|
||||
${renderCheck('api_boundary', 'no DB / no queue write / no review_state update / no scheduler', inventory.side_effects_clear ? 'CLOSED' : 'BLOCK')}
|
||||
</div>
|
||||
</div>
|
||||
<div data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-handoff>
|
||||
<p class="market-intel-deploy-section-title">HANDOFF SUMMARY</p>
|
||||
<div class="market-intel-check-list">
|
||||
${renderCheck('handoff_id', handoff.handoff_id || 'missing', handoff.handoff_id ? 'RECORDED' : 'BLOCK')}
|
||||
${renderCheck('target_table', handoff.target_table || 'missing', handoff.target_table === 'market_alert_review_queue' ? 'SAFE' : 'BLOCK')}
|
||||
${renderCheck('review_scope', handoff.review_scope || 'missing', handoff.review_scope === 'candidate_queue_review' ? 'SAFE' : 'BLOCK')}
|
||||
${renderCheck('next_queue', handoff.next_queue || 'missing', handoff.next_queue === 'manual_candidate_queue_review' ? 'MANUAL' : 'BLOCK')}
|
||||
${renderCheck('row_count', String(handoff.payload_row_count || 0), handoff.payload_row_count === inventory.payload_row_count ? 'MATCH' : 'BLOCK')}
|
||||
</div>
|
||||
</div>
|
||||
<div data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-contract>
|
||||
<p class="market-intel-deploy-section-title">REVIEW CONTRACT</p>
|
||||
<div class="market-intel-check-list">
|
||||
${renderCheck('review_queue_artifact_path', handoff.review_queue_artifact_path || 'missing', handoff.review_queue_artifact_path_safe ? 'SAFE' : 'BLOCK')}
|
||||
${renderCheck('inventory_artifact_path', handoff.inventory_artifact_path || 'missing', handoff.inventory_artifact_path_safe ? 'SAFE' : 'BLOCK')}
|
||||
${renderCheck('handoff_artifact_path', handoff.handoff_artifact_path || 'missing', handoff.handoff_artifact_path_safe ? 'SAFE' : 'BLOCK')}
|
||||
${renderCheck('operator_boundaries', 'manual only / no API DB query/write/file/CLI/scheduler', handoff.inventory_reviewed && handoff.inventory_artifacts_preserved && handoff.candidate_queue_review_only && handoff.manual_review_required && handoff.no_api_database_write && handoff.no_api_inventory_query && handoff.no_api_cli_execution && handoff.no_api_file_write && handoff.no_scheduler_attach ? 'CONFIRMED' : 'BLOCK')}
|
||||
</div>
|
||||
</div>
|
||||
<div data-market-intel-mcp-fetch-candidate-queue-writer-review-handoff-next>
|
||||
<p class="market-intel-deploy-section-title">BOUNDARY / NEXT</p>
|
||||
<div class="market-intel-check-list">
|
||||
${renderCheck('api_side_effects', 'no review_state update / no DB write / no queue write / no scheduler', data.api_updates_review_state || data.api_writes_database || data.candidate_queue_persisted || data.scheduler_attached ? 'BLOCK' : 'CLOSED')}
|
||||
${steps.map((item, index) => renderCheck(`step_${index + 1}`, item, 'NEXT')).join('')}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
`;
|
||||
if (mcpFetchCandidateQueueWriterReviewHandoffInput && !mcpFetchCandidateQueueWriterReviewHandoffInput.value.trim() && data.sample_writer_review_handoff_package) {
|
||||
mcpFetchCandidateQueueWriterReviewHandoffInput.value = JSON.stringify(data.sample_writer_review_handoff_package, null, 2);
|
||||
}
|
||||
};
|
||||
|
||||
const loadMcpFetchCandidateQueueWriterReviewHandoff = async () => {
|
||||
if (!mcpFetchCandidateQueueWriterReviewHandoffMeta || !mcpFetchCandidateQueueWriterReviewHandoffBody) return;
|
||||
mcpFetchCandidateQueueWriterReviewHandoffBody.innerHTML = '<div class="market-intel-empty">讀取 MCP Writer Review Handoff 中...</div>';
|
||||
try {
|
||||
const response = await fetch(mcpFetchCandidateQueueWriterReviewHandoffEndpoint, { credentials: 'same-origin' });
|
||||
if (!response.ok) throw new Error(`HTTP ${response.status}`);
|
||||
const data = await response.json();
|
||||
renderMcpFetchCandidateQueueWriterReviewHandoffMeta(data);
|
||||
renderMcpFetchCandidateQueueWriterReviewHandoffBody(data);
|
||||
} catch (error) {
|
||||
mcpFetchCandidateQueueWriterReviewHandoffMeta.innerHTML = '<span class="market-intel-pill">error</span>';
|
||||
mcpFetchCandidateQueueWriterReviewHandoffBody.innerHTML = `<div class="market-intel-empty">MCP Writer Review Handoff 讀取失敗：${escapeHtml(error.message)}</div>`;
|
||||
}
|
||||
};
|
||||
|
||||
const reviewMcpFetchCandidateQueueWriterReviewHandoff = async () => {
|
||||
if (!mcpFetchCandidateQueueWriterReviewHandoffMeta || !mcpFetchCandidateQueueWriterReviewHandoffBody || !mcpFetchCandidateQueueWriterReviewHandoffInput) return;
|
||||
let parsed;
|
||||
try {
|
||||
parsed = JSON.parse(mcpFetchCandidateQueueWriterReviewHandoffInput.value || '{}');
|
||||
} catch (error) {
|
||||
mcpFetchCandidateQueueWriterReviewHandoffMeta.innerHTML = '<span class="market-intel-pill">json_error</span>';
|
||||
mcpFetchCandidateQueueWriterReviewHandoffBody.innerHTML = `<div class="market-intel-empty">JSON 格式錯誤：${escapeHtml(error.message)}</div>`;
|
||||
return;
|
||||
}
|
||||
mcpFetchCandidateQueueWriterReviewHandoffBody.innerHTML = '<div class="market-intel-empty">審核 MCP Writer Review Handoff 中...</div>';
|
||||
try {
|
||||
const response = await fetch(mcpFetchCandidateQueueWriterReviewHandoffEndpoint, {
|
||||
method: 'POST',
|
||||
credentials: 'same-origin',
|
||||
headers: {
|
||||
'Content-Type': 'application/json',
|
||||
'X-CSRFToken': csrfToken
|
||||
},
|
||||
body: JSON.stringify({ writer_review_handoff_package: parsed })
|
||||
});
|
||||
const data = await response.json();
|
||||
if (!response.ok && !data.mode) throw new Error(`HTTP ${response.status}`);
|
||||
renderMcpFetchCandidateQueueWriterReviewHandoffMeta(data);
|
||||
renderMcpFetchCandidateQueueWriterReviewHandoffBody(data);
|
||||
} catch (error) {
|
||||
mcpFetchCandidateQueueWriterReviewHandoffMeta.innerHTML = '<span class="market-intel-pill">error</span>';
|
||||
mcpFetchCandidateQueueWriterReviewHandoffBody.innerHTML = `<div class="market-intel-empty">MCP Writer Review Handoff 審核失敗：${escapeHtml(error.message)}</div>`;
|
||||
}
|
||||
};
|
||||
|
||||
const renderManualSampleMeta = data => {
|
||||
manualSampleMeta.innerHTML = [
|
||||
`mode=${data.mode || 'unknown'}`,
|
||||
@@ -14452,6 +14610,12 @@
|
||||
if (mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewReview) {
|
||||
mcpFetchCandidateQueueWriterPostCloseoutInventoryReviewReview.addEventListener('click', reviewMcpFetchCandidateQueueWriterPostCloseoutInventoryReview);
|
||||
}
|
||||
if (mcpFetchCandidateQueueWriterReviewHandoffRefresh) {
|
||||
mcpFetchCandidateQueueWriterReviewHandoffRefresh.addEventListener('click', loadMcpFetchCandidateQueueWriterReviewHandoff);
|
||||
}
|
||||
if (mcpFetchCandidateQueueWriterReviewHandoffReview) {
|
||||
mcpFetchCandidateQueueWriterReviewHandoffReview.addEventListener('click', reviewMcpFetchCandidateQueueWriterReviewHandoff);
|
||||
}
|
||||
if (manualSampleRefresh) {
|
||||
manualSampleRefresh.addEventListener('click', loadManualSample);
|
||||
}
|
||||
@@ -14724,6 +14888,7 @@
|
||||
loadMcpFetchCandidateQueueWriterRunReceiptReview();
|
||||
loadMcpFetchCandidateQueueWriterRunCloseoutReview();
|
||||
loadMcpFetchCandidateQueueWriterPostCloseoutInventoryReview();
|
||||
loadMcpFetchCandidateQueueWriterReviewHandoff();
|
||||
loadManualSample();
|
||||
loadSampleAcceptance();
|
||||
loadSampleReview();
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user