Metadata-Version: 2.4
Name: knowlytix-kal
Version: 0.0.1
Summary: Placeholder release for KAL (Knowledge Adapter Layer) — full release ships as v0.3.0+
Project-URL: Homepage, https://github.com/knowlytix/KAL
Project-URL: Repository, https://github.com/knowlytix/KAL
Project-URL: Documentation, https://github.com/knowlytix/KAL/tree/main/docs
Author: Wing Yan Lau, Budi Surjanto, Agus Sudjianto
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: federation,kal,knowledge adapter layer,knowledge graph,neo4j,postgres,rdf,sparql
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Provides-Extra: dev
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest>=7; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# knowlytix-kal — placeholder

This is a **name-reserving placeholder** for `knowlytix-kal` on PyPI. The
full public release ships as **v0.3.0** and will provide:

- **`KnowledgeAdapter` Protocol** — a typed, backend-agnostic surface
  every knowledge graph implementation can target (Postgres, RDF/SPARQL,
  in-process, third-party APIs).
- **`KGStore` Protocol + `KalDefaultKGStore`** — pluggable storage
  layer per paper §7 ("the adapter delegates rather than reimplements").
- **`PostgresKnowledgeAdapter`** — full Postgres reference adapter over
  the package's ORM in the `kal` schema.
- **`FederationRouter`** — fan-out router with per-tenant scoping,
  partial-failure isolation, and vertical-axis deduplication across
  multiple adapters.
- **Connection registry** + Fernet-backed credential rotation.
- **Verification metadata** as a first-class field on every triple.

See [the paper](docs/paper/KAL_whitepaper.pdf) (lands in v0.3.0) for the
full design.

## Roadmap

- **v0.0.1** *(this release)* — placeholder; reserves the project name.
  `import knowlytix.kal` resolves but exposes only `__version__`.
- **v0.3.0** *(next public release)* — full KAL surface as described
  above. See `CHANGELOG.md` for the detailed release notes.

## License

[Apache-2.0](LICENSE).
