Move interactive breakpoint demo from test to README example

Replace the always-skipped test_workflow_breakpoint_interactive (and its
companion BreakpointWorkflow) with a runnable example snippet in the
README's debugging section. Skipped tests accumulate as noise and rot
silently; a README example is more discoverable for users and easier to
keep accurate.

The two automated tests (thread-placement assertions for both modes plus
the defensive hook test) remain and continue to provide regression
protection.

Author: elidlocke

README.md

@@ -1248,10 +1248,50 @@ onto the asyncio main thread instead of a worker thread pool. This lets `breakpo
 inside workflow code open an interactive REPL — without it, pdb hangs because its `input()` call would run on a
 thread that does not own the controlling TTY.
 
+A minimal runnable example:
+
 ```python
-worker = Worker(client, task_queue=..., workflows=[MyWorkflow], debug_mode=True)
+import asyncio
+from datetime import timedelta
+
+from temporalio import workflow
+from temporalio.client import Client
+from temporalio.worker import Worker
+
+
+@workflow.defn(sandboxed=False)
+class DebugMeWorkflow:
+    @workflow.run
+    async def run(self) -> str:
+        x = 42
+        breakpoint()  # interactive pdb prompt opens here
+        return f"x was {x}"
+
+
+async def main() -> None:
+    client = await Client.connect("localhost:7233")
+    async with Worker(
+        client,
+        task_queue="debug-me",
+        workflows=[DebugMeWorkflow],
+        debug_mode=True,
+    ):
+        result = await client.execute_workflow(
+            DebugMeWorkflow.run,
+            id="debug-me-wf",
+            task_queue="debug-me",
+            task_timeout=timedelta(minutes=10),  # see caveat below
+        )
+        print(result)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
 ```
 
+Run with `python debug_me.py` (not under pytest, which captures stdin and breaks the REPL). At the `(Pdb)`
+prompt try `p x`, `n`, `c`, `q`.
+
 Two caveats when pausing at a breakpoint inside a workflow:
 
 1. **Workflow task timeout.** Temporal expires a workflow task after ~10 seconds by default. If you sit at the

tests/worker/test_breakpoint_hang.py

@@ -18,8 +18,6 @@
 import threading
 import uuid
 
-import pytest
-
 from temporalio import workflow
 from temporalio.client import Client
 from temporalio.worker import Worker
@@ -89,49 +87,6 @@ async def test_workflow_runs_on_main_thread_in_debug_mode(client: Client):
     )
 
 
-@workflow.defn(sandboxed=False)
-class BreakpointWorkflow:
-    """Workflow that calls breakpoint() — for manual interactive testing only.
-
-    Run via:
-      uv run pytest tests/worker/test_breakpoint_hang.py::test_workflow_breakpoint_interactive \\
-          -E time-skipping -s --no-header -p no:cacheprovider
-
-    The `-s` flag disables pytest's stdin/stdout capture so pdb's REPL is
-    usable. At the prompt try: `p x`, `n`, `c`, `q`.
-    """
-
-    @workflow.run
-    async def run(self) -> str:
-        x = 42
-        y = "workflow state"
-        print(
-            f"\n[BreakpointWorkflow] about to hit breakpoint(); thread={threading.current_thread().name}"
-        )
-        breakpoint()
-        return f"x={x}, y={y!r}"
-
-
-@pytest.mark.skip(
-    reason="interactive — invoke directly with `pytest -s` to drive the pdb REPL"
-)
-async def test_workflow_breakpoint_interactive(client: Client):
-    """Drive a real pdb session inside a workflow. Skipped in CI."""
-    task_queue = f"tq-{uuid.uuid4()}"
-    async with Worker(
-        client,
-        task_queue=task_queue,
-        workflows=[BreakpointWorkflow],
-        debug_mode=True,
-    ):
-        result = await client.execute_workflow(
-            BreakpointWorkflow.run,
-            id=f"wf-{uuid.uuid4()}",
-            task_queue=task_queue,
-        )
-    print(f"\n[BreakpointWorkflow] result={result!r}")
-
-
 def test_breakpoint_hook_raises_on_workflow_thread(client: Client):
     """The defensive hook fails loudly when breakpoint() is called from a
     `temporal_workflow_*` thread without debug mode."""