feat(maf): Phase 5 - action coordinator, approval flow, frontend MAF roundtable pages

- Backend: action_coordinator, capability_snapshot, event_normalizer, tool_executor updates
- Backend: approved_tool_executor with write guard, action leases, migration script
- Frontend: maf-roundtable module (API client, event timeline, approval cards, fact flow panel)
- Frontend: MafRoutes, MafSessionsPage, MafRunDetailPage
- Tests: action_leases, migration_phase5, phase5_entry_e2e, real_write_e2e/http_e2e
- Docs: update implementation plan

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
董宏凯andCursor committed 2026-08-02 13:07:21 +08:00
1 parent 21c4c898e7
commit f82363d81f
55 files changed
+6304 -167

No files matched your search

@@ -11,6 +11,7 @@ under ``confirm_high_risk``).
from __future__ import annotations
from collections.abc import Mapping
from typing import Any
_DEFAULT_SIDE_EFFECT = "write"
@@ -42,15 +43,52 @@ def resolve_tool_metadata(
tool_name: str,
*,
config_extra: dict[str, Any] | None = None,
) -> dict[str, str]:
"""Return ``{name, tool_name, side_effect, risk_level}`` for one tool."""
maf_metadata: Mapping[str, Any] | None = None,
) -> dict[str, Any]:
"""Return trusted metadata for one tool.
Precedence is intentionally server-only and explicit:
1. MAF deployment metadata keyed by the exact runtime tool name;
2. existing server ``ToolConfig`` extras;
3. the curated built-in allow-list;
4. conservative ``write`` / ``R3`` fallback.
``maf_metadata`` is passed by the application while building a frozen
capability snapshot. It is never accepted from a session request or a
model message.
"""
side = _DEFAULT_SIDE_EFFECT
risk = _DEFAULT_RISK_LEVEL
if config_extra:
if config_extra.get("side_effect"):
side = str(config_extra["side_effect"])
if config_extra.get("risk_level"):
risk = str(config_extra["risk_level"])
target_key_fields: list[str] = []
target_key_namespace = "default"
registered = maf_metadata.get(tool_name) if maf_metadata else None
if registered is not None:
candidate_side = registered.get("side_effect") if isinstance(registered, Mapping) else getattr(registered, "side_effect", None)
candidate_risk = registered.get("risk_level") if isinstance(registered, Mapping) else getattr(registered, "risk_level", None)
if candidate_side in {"read", "skill", "write"}:
side = str(candidate_side)
if candidate_risk in {"R0", "R1", "R2", "R3", "R4"}:
risk = str(candidate_risk)
candidate_fields = registered.get("target_key_fields") if isinstance(registered, Mapping) else getattr(registered, "target_key_fields", None)
candidate_namespace = registered.get("target_key_namespace") if isinstance(registered, Mapping) else getattr(registered, "target_key_namespace", None)
if isinstance(candidate_fields, list) and all(isinstance(item, str) for item in candidate_fields):
target_key_fields = list(candidate_fields)
if isinstance(candidate_namespace, str) and candidate_namespace:
target_key_namespace = candidate_namespace
elif config_extra:
candidate_side = config_extra.get("side_effect")
candidate_risk = config_extra.get("risk_level")
if candidate_side in {"read", "skill", "write"}:
side = str(candidate_side)
if candidate_risk in {"R0", "R1", "R2", "R3", "R4"}:
risk = str(candidate_risk)
candidate_fields = config_extra.get("target_key_fields")
candidate_namespace = config_extra.get("target_key_namespace")
if isinstance(candidate_fields, list) and all(isinstance(item, str) for item in candidate_fields):
target_key_fields = list(candidate_fields)
if isinstance(candidate_namespace, str) and candidate_namespace:
target_key_namespace = candidate_namespace
elif tool_name in _BUILTIN_METADATA:
side, risk = _BUILTIN_METADATA[tool_name]
return {
@@ -58,4 +96,6 @@ def resolve_tool_metadata(
"tool_name": tool_name,
"side_effect": side,
"risk_level": risk,
"target_key_fields": target_key_fields,
"target_key_namespace": target_key_namespace,
}