Metadata-Version: 2.4
Name: cf-semantics-store
Version: 0.1.0
Summary: Workspace-local RDF semantics store boundary for Cogniflow
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: cf-service-contracts>=0.1.0
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"

# cf-semantics-store

`cf_semantics_store` is the owner package for the workspace-local RDF semantics-store boundary.

Today the package owns:

- workspace-local RDF store directory layout
- catalog-managed named-graph artifacts and dataset-state metadata as an owner-controlled management layer
- local TDB2 storage location conventions
- canonical Fuseki dataset and endpoint resolution
- local-process coordination paths such as pid files, Fuseki home detection, and managed-runtime status reporting
- live named-graph reconciliation and raw SPARQL access through the owner contract surface

The live RDF dataset is the operative runtime authority. The catalog and local `.nq` artifacts remain the owner-controlled declaration and rebuild surface used to reconcile that live dataset.

Cross-package rule: no package outside `cf_semantics_store` may talk directly to Fuseki, TDB2 files, or SPARQL HTTP endpoints. Cross-package semantics access must go through `ProviderKey.SEMANTICS_STORE` and the contracts in `cf_service_contracts`.

Consumers must not import this package directly. They should resolve `ProviderKey.SEMANTICS_STORE` through `cf_service_contracts`.
