Coverage (two tiers)
- Integration —
[tests/test_provenance.py](../../tests/test_provenance.py): live Node + ContentStore. Submits CAT0 and CAT1 once (module-scoped fixture), then asserts full provenance records (Order Function/Structure pairing, Invoice stage refs, BOM log + Plant / InfraStructure snapshots) and CAT0/CAT1 data lineage equality (ni:/ content id). Needs Session 1 below. This is also the only live coverage of the ephemeral Executor path (Factory → Executor → Invoice/BOM); there is no dedicatedtest_executor*.pymodule. See[BOM.md](../provenance/BOM.md)and[LineageOfProvenance.md](../provenance/LineageOfProvenance.md). - Unit — the other
tests/test_*.pymodules: mocked / in-process / source guards (lineage helpers, named binds, ports, IaaS utils, ContentMesh RPC, Node CLI, etc.). No live Node required.[tests/test_ipfs_client.py](../../tests/test_ipfs_client.py)is thin Kubo smoke (@requires_kubo; skips if:5001is down). Control-plane Python (§6e) uses*_id/put_dir; minted JSON stays*_uri/contentId(§6d). §6fhl:resolve/emit/intake:[tests/test_hl_resolve.py](../../tests/test_hl_resolve.py). §6i Structure marker.applied-structure.id(+ plantapplied_structure_id):[tests/test_structure_root_id.py](../../tests/test_structure_root_id.py)/[tests/test_plant_utils.py](../../tests/test_plant_utils.py). §6j Process/Plant/Ray Order ABI (input_dir_id, Rayinput_id/layout_id, obj_storestructure_id):[tests/test_transport_port.py](../../tests/test_transport_port.py)/[tests/test_infrastructure_transport_utils.py](../../tests/test_infrastructure_transport_utils.py)/[tests/test_infrastructure_obj_store_utils.py](../../tests/test_infrastructure_obj_store_utils.py)/[tests/test_ray_io_partitions.py](../../tests/test_ray_io_partitions.py). §6p CAS-native opaquepart-*partition I/O (no Kubo CAR mint):[tests/test_ray_io_partitions.py](../../tests/test_ray_io_partitions.py). §6q legacy CID transport gate (historical; remint retired in §6s):[tests/test_infrastructure_transport_utils.py](../../tests/test_infrastructure_transport_utils.py). §6s retire legacy CID read + Docker T&D (fail closed; CAS-only transport):[tests/test_infrastructure_transport_utils.py](../../tests/test_infrastructure_transport_utils.py)/[tests/test_address_store_cas_only.py](../../tests/test_address_store_cas_only.py)/[tests/test_content_store_ensure_binding.py](../../tests/test_content_store_ensure_binding.py). §6k dual-modecat(content_id=)/ dropcidDiraliases:[tests/test_cas_http.py](../../tests/test_cas_http.py)/[tests/test_meshclient_rpc_surface.py](../../tests/test_meshclient_rpc_surface.py)/[tests/test_function_source_id.py](../../tests/test_function_source_id.py). Registry claims / HTTP coherence (unit; live consumer[notebooks/cats_lineage_demo.py](../../notebooks/cats_lineage_demo.py)): index parity[tests/test_registry_parity.py](../../tests/test_registry_parity.py); claims → HTTP reachability[tests/test_registry_reachability.py](../../tests/test_registry_reachability.py); post-execute projection[tests/test_handoff_projection.py](../../tests/test_handoff_projection.py); handoff + Order slot helpers[tests/test_handoff_coherence.py](../../tests/test_handoff_coherence.py); envelope content equivalence (mesh ≡ HTTP per subcomponent)[tests/test_content_equiv_bom.py](../../tests/test_content_equiv_bom.py)/[tests/test_content_equiv_invoice.py](../../tests/test_content_equiv_invoice.py)/[tests/test_content_equiv_order.py](../../tests/test_content_equiv_order.py); stageLineage directory-manifest hops[tests/test_manifest_equiv.py](../../tests/test_manifest_equiv.py). These do not assert that all HTTP content lives in the registry. For mesh-reachable LDP hints inhl:, setCAT_NODE_HOSTto an address peers can open (loopback only warns).
- Install CATs (
uv sync --extra ops --group devfor mesh demos and tests;devprovidespytest)
- Root Dependency: see
[NodeLifeCycle.md](./NodeLifeCycle.md)—make node-startsoft-probes ContentStore (Kubo optional §6r/§6s). Host Kubo detail:[IPFS.md](../storage/IPFS.md).
- Session 1 a. Create the environment
cd cats
uv sync --extra ops --group devuv run(below) uses this.venvautomatically — no manual activation needed. b. Start Docker daemon — needed for Structure MinIO scratch + Plant / KubeRay (not Docker Kubo T&D peers, retired §6s). See[DEMO.md](./DEMO.md)step 0.tests/test_provenance.pyskips if the daemon is down. c. Start CAT Node — follow[NodeLifeCycle.md](./NodeLifeCycle.md).
make content-store-ensure # optional operator tooling
make node-start- Session 2: a. List integration tests without running them:
uv run pytest --collect-only tests/test_provenance.pyb. Run integration tests (provenance + data lineage):
# Live Node: CAT0/CAT1 once; full provenance records + data lineage equality
uv run pytest -s tests/test_provenance.pypytestalso invokes cleanup viatests/conftest.pyat session start (session autouse fixture). c. Run unit tests (everything except the live provenance module). All at once:
uv run pytest -s tests/ --ignore=tests/test_provenance.py Or per file:
# ComputePort / PlantPort / JobHandle + Process/InfraFunction surface guards
uv run pytest -s tests/test_compute_plant_ports.py
# Order-submitted vs ContentMesh bootstrap ContentStore binding
uv run pytest -s tests/test_content_store_ensure_binding.py
# Function source directory ids + pickle/named-bind hybrid on function_id
uv run pytest -s tests/test_function_source_id.py
# InfraStructure content_store_utils / ContentStore
uv run pytest -s tests/test_infrastructure_content_store_utils.py
# InfraStructure obj_store_utils / ObjectStore / JobHandle
uv run pytest -s tests/test_infrastructure_obj_store_utils.py
# InfraStructure transport_utils / TransportContext
uv run pytest -s tests/test_infrastructure_transport_utils.py
# Optional CatsIPFSClient Kubo RPC smoke (skips if :5001 down; not required for CAS)
uv run pytest -s tests/test_ipfs_client.py
# ContentMesh.linkOrder — combined Function/Structure lineage helper
uv run pytest -s tests/test_link_order.py
# ContentMesh.linkStructure — Structure lineage twin of linkProcess
uv run pytest -s tests/test_link_structure.py
# BOM registry — Node-local data→BOM / init / link* (§6d content_id / bom_ids)
# Contract: docs/provenance/BomRegistry.md
uv run pytest -s tests/test_bom_registry.py
# CAS-over-HTTP — CasHttpStore, ni:/digest, manifests, locators, AddressStore
uv run pytest -s tests/test_cas_http.py tests/test_address_store_cas_only.py
# Phase 2b / §6f — URI address + ni:/hl: proof, Order/Invoice LDP, hl: resolve/emit
uv run pytest -s tests/test_phase2b_uri.py tests/test_hl_resolve.py
# ContentMesh CAS + CAT_NODE_* endpoints (no ipfs CLI / legacy CID)
uv run pytest -s tests/test_meshclient_rpc_surface.py
# Named-bind JSON leaves vs pickle for Function Order slots
uv run pytest -s tests/test_named_binds.py
# AQ-safe Node CLI (start/stop/status/ensure)
uv run pytest -s tests/test_node_lifecycle_cli.py
# Plant plant_utils / PlantContext
uv run pytest -s tests/test_plant_utils.py
# Process / InfraFunction public-surface discipline
uv run pytest -s tests/test_process_public_surface.py
# Terraform module-cache readiness (InfraStructure.initialize)
uv run pytest -s tests/test_structure_modules_installed.py
# Structure root_id staging + getEnhancedBom materialize (+ §6i marker)
uv run pytest -s tests/test_structure_root_id.py
# TransportPort Protocol (Function) + Executor as_transport_port facade
uv run pytest -s tests/test_transport_port.py