likang
994d06aaea
- 新增 selector_candidate_demo，移除 provenance intent 后枚举候选 selector - 对候选分支执行有界重建与严格 STEP 比较 - 仅在候选遍历完整且唯一 strict 通过时生成 selector 映射记录 - 增加 selector 候选搜索、预算限制和记录生成的测试 - 保持生产 selector resolver 不受 Demo 逻辑影响 - 更新 CADFS 能力台账，记录 IMPRINT 派生 profile 的 lineage selector 缺口
78 lines
4.2 KiB
Python
78 lines
4.2 KiB
Python
"""Derive engine-facing feature metadata from the v3 operation registry.
|
|
|
|
``profile_schema.json.operation_contracts`` is the only feature-operation
|
|
registry. The engine needs a compact view while validating materialized CDSL,
|
|
but that view is intentionally derived at load time instead of maintained as a
|
|
second hand-written ``feature_atomic_ids`` table.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
|
|
|
|
def materialized_feature_contracts(profile: dict[str, Any]) -> dict[str, dict[str, Any]]:
|
|
"""Return required engine metadata derived from each v3 operation contract.
|
|
|
|
Author-owned params are supplied by the tool schema. Server-injected
|
|
``params.*`` paths become required only after materialization, while
|
|
injected feature selectors are represented outside the params object.
|
|
"""
|
|
raw_contracts = profile.get("operation_contracts")
|
|
if not isinstance(raw_contracts, dict) or not raw_contracts:
|
|
raise ValueError("profile schema has no operation_contracts registry")
|
|
derived: dict[str, dict[str, Any]] = {}
|
|
for atomic_id, raw in raw_contracts.items():
|
|
if not isinstance(atomic_id, str) or not atomic_id or not isinstance(raw, dict):
|
|
raise ValueError("operation contract registry has an invalid entry")
|
|
if raw.get("atomic_id") != atomic_id:
|
|
raise ValueError(f"operation contract key and atomic_id disagree for {atomic_id}")
|
|
shape = raw.get("fragment_shape")
|
|
params_schema = raw.get("author_params_schema")
|
|
injected_paths = raw.get("server_injected_paths")
|
|
selector_policy = raw.get("selector_policy")
|
|
nested_selector_policies = raw.get("nested_selector_policies") or {}
|
|
runtime_capability = raw.get("runtime_capability")
|
|
if (
|
|
not isinstance(shape, dict)
|
|
or not isinstance(params_schema, dict)
|
|
or not isinstance(injected_paths, list)
|
|
or not isinstance(selector_policy, dict)
|
|
or not isinstance(nested_selector_policies, dict)
|
|
):
|
|
raise ValueError(f"operation contract is incomplete for {atomic_id}")
|
|
if not isinstance(runtime_capability, dict) or not all(
|
|
isinstance(runtime_capability.get(flag), bool)
|
|
for flag in (
|
|
"body_mutating", "requires_active_body", "replayable", "requires_selector", "open_profile_ok",
|
|
)
|
|
):
|
|
raise ValueError(f"operation runtime_capability is invalid for {atomic_id}")
|
|
properties = params_schema.get("properties")
|
|
required = params_schema.get("required")
|
|
if not isinstance(properties, dict) or not isinstance(required, list):
|
|
raise ValueError(f"operation author params are invalid for {atomic_id}")
|
|
if not all(isinstance(name, str) and name in properties for name in required):
|
|
raise ValueError(f"operation required params are invalid for {atomic_id}")
|
|
if not all(isinstance(path, str) and isinstance(policy, dict) for path, policy in nested_selector_policies.items()):
|
|
raise ValueError(f"operation nested selector policies are invalid for {atomic_id}")
|
|
materialized_required = list(dict.fromkeys(required))
|
|
for path in injected_paths:
|
|
if not isinstance(path, str):
|
|
raise ValueError(f"operation injection path is invalid for {atomic_id}")
|
|
if path.startswith("params.") and path.count(".") == 1:
|
|
materialized_required.append(path.removeprefix("params."))
|
|
elif path != "feature.selectors":
|
|
raise ValueError(f"operation injection path is unsupported for {atomic_id}")
|
|
materialized_required = list(dict.fromkeys(materialized_required))
|
|
derived[atomic_id] = {
|
|
"required_params": materialized_required,
|
|
"optional_params": [name for name in properties if name not in materialized_required],
|
|
"requires_sketch": shape.get("sketch") == "required",
|
|
"selector_slot": selector_policy.get("slot"),
|
|
"selector_token_kind": selector_policy.get("token_kind"),
|
|
"nested_selector_policies": dict(nested_selector_policies),
|
|
"runtime_capability": dict(runtime_capability),
|
|
}
|
|
return derived
|