first slice: operation context scaffolding

splitting WorkflowSurfaceHandlers (because it is BIG)

tests/wf_api/test_operation_context.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+import ast
+import json
+from pathlib import Path
+
+from wf_api.operation_context import WorkflowOperationContext
+from wf_cli.context import load_cli_context
+from wf_mcp.broker.service.workflow_operation_context import context_from_service
+
+
+def test_wf_api_operation_context_imports_no_wf_mcp() -> None:
+    path = Path(__file__).resolve().parents[2] / "src" / "wf_api" / "operation_context.py"
+    tree = ast.parse(path.read_text(encoding="utf-8"), filename=str(path))
+
+    violations: list[str] = []
+    for node in ast.walk(tree):
+        if isinstance(node, ast.ImportFrom) and node.module is not None:
+            if node.module.startswith("wf_mcp"):
+                violations.append(f"{node.lineno}: from {node.module} import ...")
+        elif isinstance(node, ast.Import):
+            for alias in node.names:
+                if alias.name.startswith("wf_mcp"):
+                    violations.append(f"{node.lineno}: import {alias.name}")
+
+    assert violations == []
+
+
+def test_context_from_service_exposes_existing_store_objects(tmp_path: Path) -> None:
+    config_path = tmp_path / "wf_mcp.config.json"
+    config_path.write_text(
+        json.dumps(
+            {
+                "store_root": ".wf_mcp_store",
+                "connections": [
+                    {
+                        "id": "demo.personal",
+                        "server": "demo",
+                        "account": "personal",
+                    }
+                ],
+            }
+        ),
+        encoding="utf-8",
+    )
+    cli_context = load_cli_context(config_path)
+
+    operation_context = context_from_service(cli_context.service)
+
+    assert isinstance(operation_context, WorkflowOperationContext)
+    assert operation_context.artifact_store is cli_context.service.artifact_store
+    assert operation_context.draft_workspace_store is cli_context.service.draft_workspace_store
+    assert operation_context.run_store is cli_context.service.run_store
+    assert operation_context.capability_sources is cli_context.service.capability_sources
+
+
+def test_context_from_service_delegates_specs_and_events(tmp_path: Path) -> None:
+    config_path = tmp_path / "wf_mcp.config.json"
+    config_path.write_text(
+        json.dumps({"store_root": ".wf_mcp_store", "connections": []}),
+        encoding="utf-8",
+    )
+    cli_context = load_cli_context(config_path)
+    operation_context = context_from_service(cli_context.service)
+
+    event = object()
+    operation_context.events.record_event(event)
+
+    assert cli_context.service.list_events()[-1] is event