succession-cli 0.2.0__tar.gz

succession_cli-0.2.0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+dist/
+build/
+
+# Node
+node_modules/
+web/dist/
+.vite/
+
+# Foundry
+contracts/out/
+contracts/cache/
+contracts/broadcast/
+contracts/lib/
+
+# Local state — never commit memory stores, keys, or credentials
+*.db
+*.db-wal
+*.db-shm
+.env
+.env.*
+!.env.example
+.succession/
+demo-state/
+
+# Netlify CLI link state (machine-local)
+.netlify/
+
+# Local run artifacts
+transfer-runs/
+deployments/local.json
+deployments/transfers-local.json
+
+# Recording scratch
+.record-state/

succession_cli-0.2.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.5
+Name: succession-cli
+Version: 0.2.0
+Summary: The property layer for agent memory — SMP export/hash/import, provenance, valuation, sealing, and transfer.
+Project-URL: Homepage, https://github.com/linoxbt/Succession
+Project-URL: Source, https://github.com/linoxbt/Succession
+Project-URL: Issues, https://github.com/linoxbt/Succession/issues
+License: MIT
+Keywords: agent,base,erc-8004,memory,merkle,provenance
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.11
+Requires-Dist: eth-account>=0.13.0
+Requires-Dist: eth-utils>=5.0.0
+Requires-Dist: pycryptodome>=3.20
+Requires-Dist: sibyl-memory-client>=0.8.0
+Provides-Extra: acp
+Requires-Dist: virtuals-acp>=0.3.23; extra == 'acp'
+Provides-Extra: chain
+Requires-Dist: web3>=7.0; extra == 'chain'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.2; extra == 'mcp'
+Requires-Dist: web3>=7.0; extra == 'mcp'
+Provides-Extra: service
+Requires-Dist: fastapi>=0.115; extra == 'service'
+Requires-Dist: httpx>=0.27; extra == 'service'
+Requires-Dist: uvicorn>=0.32; extra == 'service'
+Provides-Extra: test
+Requires-Dist: eth-tester>=0.12.0b1; extra == 'test'
+Requires-Dist: fastapi>=0.115; extra == 'test'
+Requires-Dist: httpx>=0.27; extra == 'test'
+Requires-Dist: py-evm==0.12.1b1; extra == 'test'
+Requires-Dist: pytest-cov>=5.0; extra == 'test'
+Requires-Dist: pytest>=8.0; extra == 'test'
+Requires-Dist: web3>=7.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# `succession` — the SMP pipeline
+
+The Python core of Succession: export a tenant's memory into a Succession
+Memory Package, hash and sign it, import it into a fresh tenant, and prove the
+result matches what was committed on-chain.
+
+See the [repository README](../../README.md) for the full picture. Quick start:
+
+```bash
+pip install -e ".[dev]"
+pytest
+```

succession_cli-0.2.0/README.md

@@ -0,0 +1,12 @@
+# `succession` — the SMP pipeline
+
+The Python core of Succession: export a tenant's memory into a Succession
+Memory Package, hash and sign it, import it into a fresh tenant, and prove the
+result matches what was committed on-chain.
+
+See the [repository README](../../README.md) for the full picture. Quick start:
+
+```bash
+pip install -e ".[dev]"
+pytest
+```

succession_cli-0.2.0/hatch_build.py

@@ -0,0 +1,57 @@
+"""Ship the two files an installed CLI cannot work without.
+
+`contracts/out/artifacts.json` is a Foundry build product and gitignored, and
+`deployments/base-sepolia.json` lives at the repo root. Neither is under
+`src/succession/`, so neither reached the wheel, and the chain commands — the
+three the product is actually about — were unreachable for anyone who installed
+rather than cloned.
+
+Copying them into `src/succession/data/` at build time keeps one copy in the
+repo as the source of truth while making the wheel self-contained. The ABI has
+to be compiled first; a build without it is refused rather than producing a
+wheel that installs cleanly and then fails on the first chain read, which is the
+failure mode this whole file exists to prevent.
+"""
+
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+ROOT = Path(__file__).resolve().parents[2]
+DATA = Path(__file__).resolve().parent / "src" / "succession" / "data"
+
+SOURCES = {
+    "artifacts.json": ROOT / "contracts" / "out" / "artifacts.json",
+    "base-sepolia.json": ROOT / "deployments" / "base-sepolia.json",
+}
+
+
+class SuccessionBuildHook(BuildHookInterface):
+    PLUGIN_NAME = "succession-data"
+
+    def initialize(self, version: str, build_data: dict) -> None:
+        DATA.mkdir(parents=True, exist_ok=True)
+        (DATA / "__init__.py").write_text(
+            '"""Data files shipped with the wheel. See hatch_build.py."""\n',
+            encoding="utf-8",
+        )
+
+        # The copies under `data/` are tracked in git, which is what makes
+        # `pip install git+https://…` work: a build from a clone has no
+        # `contracts/out/` because that directory is a gitignored Foundry
+        # output. So a missing source here refreshes nothing rather than
+        # failing, and the tracked copy ships as-is.
+        for name, path in SOURCES.items():
+            if path.is_file():
+                shutil.copyfile(path, DATA / name)
+            elif not (DATA / name).is_file():
+                raise RuntimeError(
+                    f"{name} is neither built nor tracked. Run `npm run build` "
+                    "in contracts/ and commit "
+                    f"packages/succession/src/succession/data/{name}; a wheel "
+                    "without it installs cleanly and then fails on every chain "
+                    "command, which is worse than a failed build."
+                )

succession_cli-0.2.0/pyproject.toml

@@ -0,0 +1,83 @@
+[project]
+# The command is `succession`; the distribution cannot be. That name has been
+# taken on PyPI since 2016 by an unrelated library, so `pipx install succession`
+# installs someone else's linked lists and no succession command at all — which
+# is exactly what the app used to tell buyers to run.
+name = "succession-cli"
+version = "0.2.0"
+description = "The property layer for agent memory — SMP export/hash/import, provenance, valuation, sealing, and transfer."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+keywords = ["agent", "memory", "erc-8004", "provenance", "merkle", "base"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Security :: Cryptography",
+]
+
+dependencies = [
+    "sibyl-memory-client>=0.8.0",
+    "eth-account>=0.13.0",
+    "eth-utils>=5.0.0",
+    "pycryptodome>=3.20",
+]
+
+[project.urls]
+Homepage = "https://github.com/linoxbt/Succession"
+Source = "https://github.com/linoxbt/Succession"
+Issues = "https://github.com/linoxbt/Succession/issues"
+
+[project.optional-dependencies-note]
+# virtuals-acp is an extra rather than a hard dependency: it pulls a socket
+# client and wants wallet credentials, and the SMP pipeline must stay runnable
+# without either.
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-cov>=5.0"]
+service = ["fastapi>=0.115", "uvicorn>=0.32", "httpx>=0.27"]
+acp = ["virtuals-acp>=0.3.23"]
+chain = ["web3>=7.0"]
+mcp = ["mcp>=1.2", "web3>=7.0"]
+# Everything the full suite needs. `dev` alone runs the pure-pipeline tests;
+# `test` additionally executes the compiled contract bytecode in py-evm and
+# drives the FastAPI layer through starlette's TestClient, which needs httpx.
+# Without this the suite fails at *collection* on a fresh install, which is a
+# worse failure than a red test: it looks like the code is broken.
+test = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "httpx>=0.27",
+    "fastapi>=0.115",
+    "web3>=7.0",
+    "py-evm==0.12.1b1",
+    "eth-tester>=0.12.0b1",
+]
+
+[project.scripts]
+succession = "succession.cli:main"
+succession-acp = "succession.acp_cli:main"
+succession-mcp = "succession.mcp_server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/succession"]
+# `data/` is gitignored because it is copied in from the repo at build time, and
+# hatchling honours VCS ignores when selecting files. `artifacts` is the
+# override for exactly this case: build products that must ship anyway.
+artifacts = ["src/succession/data/*.json", "src/succession/data/__init__.py"]
+
+# The ABI and the deployment record are copied in from the repo at build time.
+# Without them an installed CLI cannot reach the chain at all. See hatch_build.py.
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = "hatch_build.py"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

succession_cli-0.2.0/src/succession/__init__.py

@@ -0,0 +1,52 @@
+"""Succession — the property layer for agent memory.
+
+Public surface:
+
+    from succession import export_tenant, import_package, open_tenant
+
+Everything else is reachable through the submodules: :mod:`succession.smp` for
+the package format, :mod:`succession.merkle` for the integrity scheme,
+:mod:`succession.valuation`, :mod:`succession.dataroom`, :mod:`succession.seal`,
+and :mod:`succession.certificate`.
+"""
+
+from .canonical import canonical_bytes, canonical_json
+from .export import ExportResult, build_package, export_tenant, read_all
+from .importer import ImportResult, IntegrityMismatch, import_package, verify_package
+from .memory.sibyl import SibylMemory, open_tenant
+from .merkle import MerkleTree, build_tree, to_hex, verify_proof
+from .provenance import SignatureError, sign_header, verify_header
+from .redaction import Disclosure, Sensitivity, mark, read_disclosure
+from .smp import DATA_CATEGORIES, SMP_CATEGORIES, SMP_VERSION, SMPPackage
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "DATA_CATEGORIES",
+    "SMP_CATEGORIES",
+    "SMP_VERSION",
+    "Disclosure",
+    "ExportResult",
+    "ImportResult",
+    "IntegrityMismatch",
+    "MerkleTree",
+    "SMPPackage",
+    "Sensitivity",
+    "SibylMemory",
+    "SignatureError",
+    "build_package",
+    "build_tree",
+    "canonical_bytes",
+    "canonical_json",
+    "export_tenant",
+    "import_package",
+    "mark",
+    "open_tenant",
+    "read_all",
+    "read_disclosure",
+    "sign_header",
+    "to_hex",
+    "verify_header",
+    "verify_package",
+    "verify_proof",
+]