feat(graph): add breakpoint and checkpoint functionality

[ogabrielluiz]

Summary

Adds breakpoint and checkpoint functionality to the Graph class, enabling pause/resume execution at specific vertices.

Breakpoints: Pause graph execution before a specific vertex runs

• graph.add_breakpoint(vertex_id) - Set a pause point
• graph.resume() - Continue after pause
• graph.is_paused - Check if paused
• graph.get_breakpoint_checkpoint() - Get state at pause point

Checkpoints: Save/restore graph execution state

• graph._get_graph_snapshot() - Capture current state (JSON-serializable)
• graph.restore_from_snapshot(snapshot) - Restore from saved state

Changes

• Add breakpoint system to Graph class (add/remove/clear/resume)
• Add checkpoint save/restore functionality
• Fix JSON serialization in RunnableVerticesManager (sets to lists)
• Add validation for snapshot restoration
• Add exception cleanup for breakpoint state
• Add tests for breakpoints and checkpoints

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/graph-breakpoints

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}