Metadata-Version: 2.4
Name: kestrel-feature-healthcare
Version: 0.0.1
Summary: Patient-owned sovereign health records (FHIR/CCDA) as a Kestrel Sovereign feature package
Project-URL: Homepage, https://kestrelsovereign.com
Project-URL: Source, https://github.com/KestrelSovereignAI/kestrel-feature-healthcare
Project-URL: Issues, https://github.com/KestrelSovereignAI/kestrel-feature-healthcare/issues
Author: UncleSaurus
Maintainer: UncleSaurus
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,ccda,fhir,healthcare,kestrel,sovereign-records
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Python: <3.14,>=3.11
Requires-Dist: kestrel-sovereign-sdk<1,>=0.13
Provides-Extra: test
Requires-Dist: pytest-asyncio>=1.1.0; extra == 'test'
Requires-Dist: pytest-timeout>=2.3.1; extra == 'test'
Requires-Dist: pytest>=8.0.0; extra == 'test'
Description-Content-Type: text/markdown

# kestrel-feature-healthcare

Patient-owned sovereign health records (FHIR/CCDA) for Kestrel Sovereign.

An agent holds the owner's clinical records as part of its sovereign
memory. This is a reusable framework capability — a sibling package
alongside `kestrel-feature-visual` / `-reflection` / `-observability` —
not a host-product feature. Any healthcare host on Kestrel consumes it.

## Status

Scaffold. The capability is a multi-phase epic tracked in
`KestrelSovereignAI/kestrel-sovereign`:

- **Phase A** — typed FHIR R4 resource store, owner-DID-scoped
- **Phase B** — CCDA document storage + structured extraction
- **Phase C** — CCDA → FHIR normalization (one queryable clinical model)
- **Phase D** — owner-controlled access/consent surface + export hooks

Phases C/D depend on the sovereign-import receiver and the
`data_access_grant` consent-verification primitives shipping in
kestrel-sovereign first.

## Installation

```bash
uv pip install kestrel-feature-healthcare
```

The package registers `HealthcareFeature` through the
`kestrel_sovereign.features` entry point group.

## Development

```bash
uv sync --extra test
uv run --extra test pytest
```
