riftpoint 1.0.0__tar.gz

riftpoint-1.0.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: riftpoint
+Version: 1.0.0
+Summary: High-performance multiversal checkpointer for LangGraph powered by Janus-Tachyon-RS
+Keywords: agentic-ai,checkpointer,janus,langchain,langgraph,multiverse,speculative-execution,state-management
+Author: Eduardo Ruiz
+Author-email: Eduardo Ruiz <eduardo.j.ruiz@gmail.com>
+License-Expression: MIT OR Apache-2.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: janus-tachyon-rs>=0.2.1,<0.3.0
+Requires-Dist: langchain-core>=1.6.3,<2.0.0
+Requires-Dist: langgraph>=1.2.11,<2.0.0
+Requires-Dist: loguru>=0.7.3,<1.0.0
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/goldenphoenix713/RiftPoint
+Project-URL: Repository, https://github.com/goldenphoenix713/RiftPoint
+Project-URL: Issues, https://github.com/goldenphoenix713/RiftPoint/issues
+Project-URL: Documentation, https://github.com/goldenphoenix713/RiftPoint#readme
+Description-Content-Type: text/markdown
+
+# RiftPoint 🌌
+
+[![CI](https://github.com/goldenphoenix713/RiftPoint/actions/workflows/ci.yml/badge.svg)](https://github.com/goldenphoenix713/RiftPoint/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/release/python-3110/)
+[![Core: Tachyon-RS](https://img.shields.io/badge/core-Janus--Tachyon--RS-orange.svg)](https://github.com/goldenphoenix713/janus)
+
+> **High-performance multiversal checkpointer and speculative state engine for LangGraph, powered by Janus-Tachyon-RS.**
+
+---
+
+## 🌟 Overview
+
+In standard LLM agent workflows, exploring alternative reasoning paths, evaluating multiple tool-use strategies, or testing speculative futures requires expensive state copying or complex DAG orchestration.
+
+**RiftPoint** bridges [**LangGraph**](https://github.com/langchain-ai/langgraph) with the Rust-backed [**`janus-tachyon-rs`**](https://github.com/goldenphoenix713/janus) engine to provide:
+
+- **Multiversal Branching:** Instant state forks into candidate realities with near-zero memory duplication penalty.
+- **Speculative Tool Calling:** Concurrent execution of divergent tool-use strategies across distinct timeline branches.
+- **Multiverse Collapse:** Automatic scoring of candidate timelines (via LLM-as-a-judge, heuristics, or consensus) to commit winning trajectories to `main` while pruning discarded paths.
+- **Full State Travel & Tracing:** Interactive time travel, undo/redo, and timeline visualization via Mermaid.js and Matplotlib.
+
+---
+
+## 📚 Planning & Architecture Documentation
+
+Detailed architectural blueprints and implementation phases are documented in [docs/planning](docs/planning/README.md):
+
+- **[Master Architecture & Overview Plan](docs/planning/overview_plan.md)**
+- **[Performance Benchmarks & Multiverse Capability Report](docs/BENCHMARKS.md)**
+- **[Future Directions & Strategic Roadmap](docs/FUTURE_DIRECTIONS.md)**
+- **[Phase 1: Core Janus Bridge & Sync Checkpointer](docs/planning/phase_1_core_bridge_and_sync_checkpointer.md)**
+- **[Phase 2: Asynchronous Checkpointer](docs/planning/phase_2_async_checkpointer.md)**
+- **[Phase 3: Branching & Speculative Execution Engine](docs/planning/phase_3_branching_and_speculative_runner.md)**
+- **[Phase 4: Multiverse Collapse & Evaluation Engine](docs/planning/phase_4_multiverse_collapse_and_evaluation.md)**
+- **[Phase 5: Visualization, Serialization & Tracing](docs/planning/phase_5_visualization_and_serialization.md)**
+
+---
+
+## 🚀 Quickstart
+
+### Installation
+
+```bash
+pip install riftpoint
+```
+
+*Or install with `uv`:*
+
+```bash
+uv add riftpoint
+```
+
+### Basic Example
+
+```python
+from langgraph.graph import StateGraph
+from riftpoint import RiftCheckpointSaver
+
+# Initialize the Janus-backed checkpointer
+checkpointer = RiftCheckpointSaver()
+
+# Build your LangGraph workflow
+builder = StateGraph(...)
+# ... define nodes and edges ...
+graph = builder.compile(checkpointer=checkpointer)
+
+# Run workflow with multiversal checkpointing
+config = {"configurable": {"thread_id": "session-1"}}
+result = graph.invoke({"messages": [...]}, config=config)
+
+# Render the timeline DAG as a Mermaid diagram
+print(checkpointer.visualize("session-1"))
+```
+
+---
+
+## 🛠️ Developer Commands
+
+Development workflows use `uv`:
+
+```bash
+# Sync dependencies
+uv sync --all-groups
+
+# Run tests with coverage requirement (>= 70%)
+uv run pytest
+
+# Lint and format
+uv run ruff check --fix
+uv run ruff format
+
+# Type check
+uv run mypy src tests
+
+# Code complexity check (Radon Grade B or better)
+uv run python scripts/check_radon.py src
+```
+
+---
+
+## 📚 Documentation & Roadmap
+
+- **[Documentation Site](https://riftpoint.readthedocs.io/):** Full guides, API reference, and tutorials.
+- **[Roadmap to v1.0](docs/ROADMAP_V1.md):** 5-pillar production readiness checklist toward GA release.
+- **[Future Directions](docs/FUTURE_DIRECTIONS.md):** Long-term vision and feature exploration horizon.
+
+---
+
+## 📄 License
+
+This project is dual-licensed under:
+
+- **MIT License** ([LICENSE-MIT](LICENSE-MIT))
+- **Apache License, Version 2.0** ([LICENSE-APACHE](LICENSE-APACHE))

riftpoint-1.0.0/README.md

@@ -0,0 +1,114 @@
+# RiftPoint 🌌
+
+[![CI](https://github.com/goldenphoenix713/RiftPoint/actions/workflows/ci.yml/badge.svg)](https://github.com/goldenphoenix713/RiftPoint/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/release/python-3110/)
+[![Core: Tachyon-RS](https://img.shields.io/badge/core-Janus--Tachyon--RS-orange.svg)](https://github.com/goldenphoenix713/janus)
+
+> **High-performance multiversal checkpointer and speculative state engine for LangGraph, powered by Janus-Tachyon-RS.**
+
+---
+
+## 🌟 Overview
+
+In standard LLM agent workflows, exploring alternative reasoning paths, evaluating multiple tool-use strategies, or testing speculative futures requires expensive state copying or complex DAG orchestration.
+
+**RiftPoint** bridges [**LangGraph**](https://github.com/langchain-ai/langgraph) with the Rust-backed [**`janus-tachyon-rs`**](https://github.com/goldenphoenix713/janus) engine to provide:
+
+- **Multiversal Branching:** Instant state forks into candidate realities with near-zero memory duplication penalty.
+- **Speculative Tool Calling:** Concurrent execution of divergent tool-use strategies across distinct timeline branches.
+- **Multiverse Collapse:** Automatic scoring of candidate timelines (via LLM-as-a-judge, heuristics, or consensus) to commit winning trajectories to `main` while pruning discarded paths.
+- **Full State Travel & Tracing:** Interactive time travel, undo/redo, and timeline visualization via Mermaid.js and Matplotlib.
+
+---
+
+## 📚 Planning & Architecture Documentation
+
+Detailed architectural blueprints and implementation phases are documented in [docs/planning](docs/planning/README.md):
+
+- **[Master Architecture & Overview Plan](docs/planning/overview_plan.md)**
+- **[Performance Benchmarks & Multiverse Capability Report](docs/BENCHMARKS.md)**
+- **[Future Directions & Strategic Roadmap](docs/FUTURE_DIRECTIONS.md)**
+- **[Phase 1: Core Janus Bridge & Sync Checkpointer](docs/planning/phase_1_core_bridge_and_sync_checkpointer.md)**
+- **[Phase 2: Asynchronous Checkpointer](docs/planning/phase_2_async_checkpointer.md)**
+- **[Phase 3: Branching & Speculative Execution Engine](docs/planning/phase_3_branching_and_speculative_runner.md)**
+- **[Phase 4: Multiverse Collapse & Evaluation Engine](docs/planning/phase_4_multiverse_collapse_and_evaluation.md)**
+- **[Phase 5: Visualization, Serialization & Tracing](docs/planning/phase_5_visualization_and_serialization.md)**
+
+---
+
+## 🚀 Quickstart
+
+### Installation
+
+```bash
+pip install riftpoint
+```
+
+*Or install with `uv`:*
+
+```bash
+uv add riftpoint
+```
+
+### Basic Example
+
+```python
+from langgraph.graph import StateGraph
+from riftpoint import RiftCheckpointSaver
+
+# Initialize the Janus-backed checkpointer
+checkpointer = RiftCheckpointSaver()
+
+# Build your LangGraph workflow
+builder = StateGraph(...)
+# ... define nodes and edges ...
+graph = builder.compile(checkpointer=checkpointer)
+
+# Run workflow with multiversal checkpointing
+config = {"configurable": {"thread_id": "session-1"}}
+result = graph.invoke({"messages": [...]}, config=config)
+
+# Render the timeline DAG as a Mermaid diagram
+print(checkpointer.visualize("session-1"))
+```
+
+---
+
+## 🛠️ Developer Commands
+
+Development workflows use `uv`:
+
+```bash
+# Sync dependencies
+uv sync --all-groups
+
+# Run tests with coverage requirement (>= 70%)
+uv run pytest
+
+# Lint and format
+uv run ruff check --fix
+uv run ruff format
+
+# Type check
+uv run mypy src tests
+
+# Code complexity check (Radon Grade B or better)
+uv run python scripts/check_radon.py src
+```
+
+---
+
+## 📚 Documentation & Roadmap
+
+- **[Documentation Site](https://riftpoint.readthedocs.io/):** Full guides, API reference, and tutorials.
+- **[Roadmap to v1.0](docs/ROADMAP_V1.md):** 5-pillar production readiness checklist toward GA release.
+- **[Future Directions](docs/FUTURE_DIRECTIONS.md):** Long-term vision and feature exploration horizon.
+
+---
+
+## 📄 License
+
+This project is dual-licensed under:
+
+- **MIT License** ([LICENSE-MIT](LICENSE-MIT))
+- **Apache License, Version 2.0** ([LICENSE-APACHE](LICENSE-APACHE))

riftpoint-1.0.0/pyproject.toml

@@ -0,0 +1,274 @@
+[project]
+name = "riftpoint"
+version = "1.0.0"
+description = "High-performance multiversal checkpointer for LangGraph powered by Janus-Tachyon-RS"
+readme = "README.md"
+license = "MIT OR Apache-2.0"
+requires-python = ">=3.11"
+keywords = [
+    "agentic-ai",
+    "checkpointer",
+    "janus",
+    "langchain",
+    "langgraph",
+    "multiverse",
+    "speculative-execution",
+    "state-management",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "janus-tachyon-rs>=0.2.1,<0.3.0",
+    "langchain-core>=1.6.3,<2.0.0",
+    "langgraph>=1.2.11,<2.0.0",
+    "loguru>=0.7.3,<1.0.0",
+]
+
+[[project.authors]]
+name = "Eduardo Ruiz"
+email = "eduardo.j.ruiz@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/goldenphoenix713/RiftPoint"
+Repository = "https://github.com/goldenphoenix713/RiftPoint"
+Issues = "https://github.com/goldenphoenix713/RiftPoint/issues"
+Documentation = "https://github.com/goldenphoenix713/RiftPoint#readme"
+
+[build-system]
+requires = ["uv_build>=0.10.0,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "certifi>=2026.7.22",
+    "matplotlib>=3.8.0,<4.0.0",
+    "mypy>=2.3.1,<3.0.0",
+    "pre-commit>=4.0.0,<5.0.0",
+    "pytest>=9.1.1,<10.0.0",
+    "pytest-cov>=6.0.0,<7.0.0",
+    "radon>=6.0.1,<7.0.0",
+    "ruff>=0.16.7,<1.0.0",
+]
+docs = [
+    "mkdocs>=1.6.0,<2.0.0",
+    "mkdocs-material>=9.5.0,<10.0.0",
+    "mkdocstrings[python]>=0.28.0,<1.0.0",
+    "pymdown-extensions>=10.14.0,<11.0.0",
+]
+
+[tool.uv]
+exclude-newer = "2026-09-12T00:00:00Z"
+
+[tool.ruff]
+target-version = "py311"
+line-length = 88
+indent-width = 4
+exclude = [
+    ".git",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    ".venv",
+    "build",
+    "dist",
+    "node_modules",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "YTT",
+    "S",
+    "BLE",
+    "FBT",
+    "B",
+    "A",
+    "COM",
+    "C4",
+    "DTZ",
+    "T10",
+    "EM",
+    "EXE",
+    "ISC",
+    "ICN",
+    "G",
+    "INP",
+    "PIE",
+    "T20",
+    "PYI",
+    "PT",
+    "Q",
+    "RSE",
+    "RET",
+    "SLF",
+    "SLOT",
+    "SIM",
+    "TID",
+    "TCH",
+    "INT",
+    "ARG",
+    "PTH",
+    "ERA",
+    "PGH",
+    "PL",
+    "TRY",
+    "FLY",
+    "PERF",
+    "FURB",
+    "LOG",
+    "RUF",
+]
+ignore = [
+    "COM812",
+    "ISC001",
+]
+fixable = ["ALL"]
+unfixable = []
+
+[tool.ruff.lint.flake8-bandit]
+check-typed-exception = true
+
+[tool.ruff.lint.isort]
+known-first-party = ["riftpoint"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*" = [
+    "S101",
+    "ARG",
+    "FBT",
+    "PLR2004",
+    "S105",
+    "S106",
+    "INP001",
+    "SLF001",
+]
+"test*" = [
+    "S101",
+    "ARG",
+    "FBT",
+    "PLR2004",
+    "S105",
+    "S106",
+    "INP001",
+    "SLF001",
+]
+"scripts/**/*" = [
+    "INP001",
+    "T201",
+]
+"examples/**/*" = [
+    "INP001",
+    "T201",
+    "S101",
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_unused_configs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_return_any = true
+warn_unreachable = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+disallow_untyped_calls = true
+disallow_subclassing_any = true
+no_implicit_optional = true
+show_error_codes = true
+show_column_numbers = true
+pretty = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+
+[[tool.mypy.overrides]]
+module = [
+    "radon.*",
+    "matplotlib.*",
+]
+ignore_missing_imports = true
+
+[tool.radon]
+cc_min = "A"
+cc_max = "B"
+show_complexity = true
+mi_min = "B"
+show_mi = true
+total_average = true
+exclude = "test*,tests/*,.venv/*,build/*,dist/*"
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+python_files = [
+    "test_*.py",
+    "*_test.py",
+]
+python_functions = ["test_*"]
+python_classes = ["Test*"]
+addopts = [
+    "-ra",
+    "-q",
+    "--cov=src",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+    "--cov-fail-under=90",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["src"]
+omit = [
+    "tests/*",
+    "test*",
+    "*/__pycache__/*",
+]
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+skip_covered = false
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "if self.debug:",
+    "if settings.DEBUG",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if 0:",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    'class .*\bProtocol\):',
+    '@(abc\.)?abstractmethod',
+]
+
+[tool.coverage.html]
+directory = "htmlcov"