AGENTS

This repository implements PortaLedger with a CatOpt bridge for cross-domain provenance sharing.
Architecture:
porta ledger core: Python package under src/portaledger with LocalProblem, SharedVariable, PlanDelta, ProvenanceEvent, Attestation, PortaLedger.
Bridge: src/portaledger/bridge.py with PortaBridge and bridge_to_catopt to map to CatOpt-like GoC primitives.
Governance: src/portaledger/governance.py implementing a light governance ledger anchored to a SQLite store.
Tests: tests/test_portaledger.py validating core signing/logging and bridge behavior.
Build/test: test.sh runs python3 -m build and pytest.
Packaging: pyproject.toml configured for setuptools with dependencies (cryptography).

How to run:

Conventions:

Minimal production-grade persistence (SQLite in-memory by default) for testability.
Do not depend on network; tests are deterministic.