feat: add Super Alpha research, management and MCP workflows

backend/app/research_access/service.py

@@ -25,6 +25,7 @@ from ..research.workspace_contracts import FieldAvailabilityInput
 from ..schemas import JobInput
 from ..submission import CheckInput, correlation_allows_check, create_check_job, local_alpha, source
 from ..submission import fingerprint as submission_fingerprint
+from ..superalpha.access import SuperResearchAccess
 from ..worldquant import WqError
 from .contracts import DirectCandidate, History
 from .queries import EvidenceQueries, page
@@ -37,7 +38,7 @@ class ResearchError(Exception):
                      "retry_after": retry_after, "affected_items": affected_items or []}
 
 
-class ResearchAccess:
+class ResearchAccess(SuperResearchAccess):
     def __init__(self, db, principal, client, public_origin):
         self.db, self.principal, self.client = db, principal, client
         self.public_origin = public_origin.rstrip("/")
@@ -71,6 +72,10 @@ class ResearchAccess:
     async def capabilities(self, args):
         return {**await self.backtests.capabilities(), "max_candidates": 100,
                 "settings_schema": DirectCandidate.model_json_schema(),
+                "superalpha": {"plan_with": "save_superalpha_plan", "build_with": "build_superalpha_candidates",
+                    "preview_with": "preview_superalpha_selection", "read_selection_with": "get_superalpha_selection",
+                    "job_with": "get_refresh_job", "backtest_with": "submit_backtests", "platform_batch_size": 1,
+                    "component_evidence": "预览与实际组件分别记录，未知不能认定为同池"},
                 "confirmation": "调用者须已获本批执行授权；直接提交后返回稳定运行 ID",
                 "duplicate_policies": ["reject", "rerun"], "permissions": sorted(self.principal.scopes),
                 "metadata_only": True, "actual_platform_allowance": None,
@@ -159,15 +164,23 @@ class ResearchAccess:
     async def metadata(self, args):
         q = args.query
         metadata = ResearchMetadata(self.db)
+        if q.kind == "superalpha":
+            from ..superalpha.metadata import metadata as super_metadata
+            return await super_metadata(self.db)
         if q.kind == "scopes":
             return {"source": "worldquant_platform", **await platform_options(self.client)}
         if q.kind == "operators":
-            data = await metadata.operators(q.q, q.category, limit=q.limit, offset=q.offset)
+            data = await metadata.operators(q.q, q.category, limit=q.limit, offset=q.offset, stage=q.stage)
             return {**data, "status": "available" if data["fetched_at"] else "not_cached",
                     "has_more": q.offset + len(data["items"]) < data["total"]}
         if q.kind == "settings":
             data = await metadata.get("settings")
             items = data["content"].get("items", [])
+            special = {"selectionHandling", "selectionLimit", "componentActivation"}
+            if q.alpha_type == "REGULAR":
+                items = [{**r, "fields": {k: v for k, v in r.get("fields", {}).items() if k not in special}} for r in items]
+            else:
+                items = [{**r, "super_settings_completeness": "cached" if special <= r.get("fields", {}).keys() else "unknown"} for r in items]
             return {"status": "available" if data["fetched_at"] else "not_cached",
                     "fetched_at": data["fetched_at"], **page(items[q.offset:q.offset+q.limit], len(items), q.limit, q.offset)}
         data = await metadata.get(availability_key(q.field_id, q.scope))
@@ -201,14 +214,16 @@ class ResearchAccess:
 
     async def refresh_job(self, args):
         job = await self.db.get(Job, args.job_id)
-        if not job or job.kind not in {"catalog_sync", "field_sync", "pnl_refresh", "self_correlation", "submission_check"}:
+        if not job or job.kind not in {"catalog_sync", "field_sync", "pnl_refresh", "self_correlation", "submission_check", "super_selection_preview"}:
             raise ResearchError("NOT_FOUND", "研究刷新任务不存在")
         result = await self.business.get_job_status(args.job_id)
         query = select(JobItem).where(JobItem.job_id == job.id, JobItem.error.is_not(None))
         total = await self.db.scalar(select(func.count()).select_from(query.subquery()))
         errors = list(await self.db.scalars(query.order_by(JobItem.alpha_id).limit(args.limit).offset(args.offset)))
         result.pop("errors", None)
-        return {**result, "job_id": job.id, "artifact_reference": job.payload,
+        artifact = ({"job_id": job.id, "snapshot_id": job.checkpoint.get("snapshot_id"), "read_with": "get_superalpha_selection"}
+                    if job.kind == "super_selection_preview" else job.payload)
+        return {**result, "job_id": job.id, "artifact_reference": artifact,
                 "errors": page([{"alpha_id": e.alpha_id, "error": e.error} for e in errors], total, args.limit, args.offset)}
 
     async def check_self_correlation(self, args):
@@ -306,7 +321,11 @@ class ResearchAccess:
                 invalid.append(c.client_item_id)
         if invalid:
             raise ResearchError("UNSUPPORTED_SETTINGS", "已缓存平台设置不支持这些组合；可显式刷新后重试", affected_items=invalid)
-        return {"settings_validation": "cached", "fetched_at": snapshot["fetched_at"], "field_validation": "unknown"}
+        result = {"settings_validation": "cached", "fetched_at": snapshot["fetched_at"], "field_validation": "unknown"}
+        if any(c.alpha_type == "SUPER" for c in candidates):
+            from ..superalpha.settings import validate_settings
+            result["super_settings_validation"] = await validate_settings(self.db, [c.settings for c in candidates if c.alpha_type == "SUPER"])
+        return result
 
     async def submit(self, args):
         previous, digest = await self.previous("submit_backtests", args)