chore: clean up extraction hygiene docs and guards

src/wf_mcp/workflow_surface/constants.py

@@ -1,7 +1,7 @@
 """Compatibility shim for workflow API constants.
 
 New code should import these literals from `wf_api.constants`. This module stays
-so older MCP workflow-surface imports keep working during extraction.
+so older MCP workflow-surface imports keep working until callers migrate.
 """
 
 from wf_api.constants import (

src/wf_mcp/workflow_surface/handlers.py

@@ -15,7 +15,7 @@ class WorkflowSurfaceHandlers(WorkflowApi):
 
     New code should construct `WorkflowApi(context_from_service(service))`
     directly. This shim keeps tests and legacy broker artifact tools working
-    while the MCP surface is migrated.
+    for legacy callers.
     """
 
     def __init__(self, service: WfMcpService) -> None:

src/wf_mcp/workflow_surface/next_actions.py

@@ -1,7 +1,7 @@
 """Compatibility shim for workflow API next-action guidance.
 
 New code should import from `wf_api.next_actions`. This module stays so older
-MCP workflow-surface imports keep working during extraction.
+MCP workflow-surface imports keep working until callers migrate.
 """
 
 from wf_api.next_actions import NextActionPatchExample, NextActions, NextActionTool

src/wf_mcp/workflow_surface/refs.py

@@ -1,7 +1,7 @@
 """Compatibility shim for workflow API capability refs.
 
 New code should import from `wf_api.refs`. This module stays so older MCP
-workflow-surface imports keep working during extraction.
+workflow-surface imports keep working until callers migrate.
 """
 
 from wf_api.refs import (

src/wf_mcp/workflow_surface/runtime_dependencies.py

@@ -1,7 +1,7 @@
 """Compatibility shim for workflow runtime dependency resolution.
 
 New code should import from `wf_api.runtime_dependencies`. This module stays so
-older MCP workflow-surface imports keep working during extraction.
+older MCP workflow-surface imports keep working until callers migrate.
 """
 
 from __future__ import annotations

src/wf_mcp/workflow_surface/wrapper_hints.py

@@ -1,7 +1,7 @@
 """Compatibility shim for workflow API wrapper authoring hints.
 
 New code should import from `wf_api.wrapper_hints`. This module stays so older
-MCP workflow-surface imports keep working during extraction.
+MCP workflow-surface imports keep working until callers migrate.
 """
 
 from wf_api.wrapper_hints import (