pactree 0.0.1__tar.gz

pactree-0.0.1/.gitignore

@@ -0,0 +1,157 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# PyCharm
+.idea/
+*.iml
+
+# Claude AI context files
+CLAUDE.md
+CLAUDE.local.md
+
+# VS Code
+.vscode/
+*.code-workspace
+
+# macOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Claude AI context files
+CLAUDE.md
+CLAUDE.local.md
+AGENTS.md
+
+# Documentation and planning (hidden)
+.docs/
+
+# Test runs and behavior observation (hidden)
+.samples/
+internal/*
+# Archived tests (not part of CI/CD)
+archived_tests/
+
+.tmp/
+
+tests/tmp/
+
+.tools/
+
+# Auto-generated model settings files
+**/model_settings.json
+**/bundled_models.json
+.comprehensive_test_runs/
+.internal/
+.checkpoints/
+.claude/
+screenshots/
+# In-tree provider extension packages — each has its own git repo and
+# ships as a standalone pip-installable package. Parent repo doesn't
+# track them. See providers/claude-code/ for the first one.
+egregore/providers/claude-code/
+egregore/providers/opencode/
+egregore/providers/codex/
+graphify-out/

pactree-0.0.1/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: pactree
+Version: 0.0.1
+Summary: Deterministic context trees for AI agents and applications.
+Project-URL: Homepage, https://github.com/earldennison/egregore-v2
+Project-URL: Repository, https://github.com/earldennison/egregore-v2
+Author: Earl Dennison Tan
+License-Expression: MIT
+Keywords: agent,context,pact,pactree,tree
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT 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 :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# Pactree
+
+Pactree is a deterministic context-tree substrate for AI agents and
+applications. It is designed to make context explicit: ordered, queryable,
+branchable, compact on disk, and stable across Python and Rust runtimes.
+
+The project centers on the `.pact` file format and a Rust engine for
+context trees, operations, selectors, projections, traces, and rewind/fork
+workflows. The Python package provides the ergonomic host API that applications
+use to build, inspect, and persist those trees.
+
+Core goals:
+
+- deterministic tree layout for agent context
+- compact content-addressed storage
+- branch, rewind, and what-if workflows
+- provider-facing projections without losing substrate structure
+- a clean Python API backed by a canonical Rust implementation
+
+This is an early `0.0.x` release while the standalone package is being split
+out. The public namespace is available now; the Pactree engine binary and Python
+bindings will land in the next extraction releases.

pactree-0.0.1/README.md

@@ -0,0 +1,22 @@
+# Pactree
+
+Pactree is a deterministic context-tree substrate for AI agents and
+applications. It is designed to make context explicit: ordered, queryable,
+branchable, compact on disk, and stable across Python and Rust runtimes.
+
+The project centers on the `.pact` file format and a Rust engine for
+context trees, operations, selectors, projections, traces, and rewind/fork
+workflows. The Python package provides the ergonomic host API that applications
+use to build, inspect, and persist those trees.
+
+Core goals:
+
+- deterministic tree layout for agent context
+- compact content-addressed storage
+- branch, rewind, and what-if workflows
+- provider-facing projections without losing substrate structure
+- a clean Python API backed by a canonical Rust implementation
+
+This is an early `0.0.x` release while the standalone package is being split
+out. The public namespace is available now; the Pactree engine binary and Python
+bindings will land in the next extraction releases.

pactree-0.0.1/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pactree"
+version = "0.0.1"
+description = "Deterministic context trees for AI agents and applications."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "Earl Dennison Tan" }]
+keywords = ["context", "tree", "agent", "pact", "pactree"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/earldennison/egregore-v2"
+Repository = "https://github.com/earldennison/egregore-v2"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pactree"]

pactree-0.0.1/src/pactree/__init__.py

@@ -0,0 +1,18 @@
+"""Pactree Python shim.
+
+The real Pactree runtime is being extracted from Egregore. This package is a
+small, import-safe placeholder for the future standalone API.
+"""
+
+from __future__ import annotations
+
+from ._version import __version__
+from .context import Context
+from .engine import EngineUnavailableError, engine_available
+
+__all__ = [
+    "Context",
+    "EngineUnavailableError",
+    "__version__",
+    "engine_available",
+]

pactree-0.0.1/src/pactree/_version.py

@@ -0,0 +1,3 @@
+"""Package version."""
+
+__version__ = "0.0.1"

pactree-0.0.1/src/pactree/context.py

@@ -0,0 +1,16 @@
+"""Context facade placeholder."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .engine import EngineUnavailableError
+
+
+class Context:
+    """Placeholder for the Pactree context API."""
+
+    def __init__(self, *_: Any, **__: Any) -> None:
+        raise EngineUnavailableError(
+            "pactree 0.0.1 exposes the package namespace; the Pactree engine is not bundled yet"
+        )

pactree-0.0.1/src/pactree/engine.py

@@ -0,0 +1,13 @@
+"""Pactree engine availability."""
+
+from __future__ import annotations
+
+
+class EngineUnavailableError(RuntimeError):
+    """Raised when an early package release needs the Pactree engine."""
+
+
+def engine_available() -> bool:
+    """Return whether the Pactree engine is bundled with this Python package."""
+
+    return False

pactree-0.0.1/src/pactree/file.py

@@ -0,0 +1,25 @@
+"""File API placeholder for `.pact` storage."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .engine import EngineUnavailableError
+
+
+def _not_wired() -> EngineUnavailableError:
+    return EngineUnavailableError(
+        "pactree 0.0.1 exposes the package namespace; the Pactree engine is not bundled yet"
+    )
+
+
+def info(*_: Any, **__: Any) -> dict[str, Any]:
+    raise _not_wired()
+
+
+def materialize(*_: Any, **__: Any) -> dict[str, Any]:
+    raise _not_wired()
+
+
+def validate(*_: Any, **__: Any) -> dict[str, Any]:
+    raise _not_wired()

pactree-0.0.1/src/pactree/py.typed

@@ -0,0 +1 @@
+

pactree-0.0.1/tests/test_imports.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+import pytest
+
+import pactree
+from pactree import file
+from pactree.engine import EngineUnavailableError
+
+
+def test_shim_import_surface() -> None:
+    assert pactree.__version__ == "0.0.1"
+    assert pactree.engine_available() is False
+
+
+def test_runtime_calls_are_explicitly_unavailable() -> None:
+    with pytest.raises(EngineUnavailableError):
+        pactree.Context()
+
+    with pytest.raises(EngineUnavailableError):
+        file.info("session.pact")

pactree-0.0.1/uv.lock

@@ -0,0 +1,8 @@
+version = 1
+revision = 3
+requires-python = ">=3.11"
+
+[[package]]
+name = "pactree"
+version = "0.0.1"
+source = { editable = "." }