ChronoHIPAA

HIPAA-compliant reference architecture for Coleman Dimensional Encoding.

Maps patient records to a 154-bit vector encoding six dimensions with AES-GCM encryption and HKDF key derivation. Information-theoretic de-identification preserving all sufficient statistics for population health analytics.

Background

Provides production-ready reference architecture for HIPAA-compliant healthcare data processing using Coleman Dimensional Encoding (CDE) as a minimally sufficient statistic (MSS).

Enables population-level analytics on electronic health records while maintaining information-theoretic de-identification, ensuring HIPAA compliance through mathematical guarantees.

Key Metrics:

• Privacy: Information-theoretic de-identification via 154-bit MSS
• Analytics: Preserves all sufficient statistics for population health
• Compliance: HIPAA-ready multi-cloud reference architecture

CDE Implementation

Dimensions

• Entity model: (patient_id, encounter_id, provider_id) keys.
• Data domains: coded fields for diagnoses, procedures, medications, labs, and observations.
• Access policy: role → permission tuples (resource, action, constraint) (e.g. time or location).
• Audit log: normalized events (who, what, when, where, why).

Query Workload

ChronoHIPAA is optimized for:

• "Given a role and request, decide allow/deny and explain why."
• "Given a patient, reconstruct their longitudinal record under access policy."
• "Given an audit slice, answer who accessed what and why, over a time range."

Minimal Sufficient Statistic

HIPAA reasoning reduces to:

• Entity identifiers,
• Coded clinical data,
• Access policies, and
• Audit events.

All compliance, access control, and reporting logic are derivable from these dimensions. This CDE is an MSS for HIPAA-focused access and auditing workloads.

Install

git clone https://github.com/chronomancy-io/chronohipaa.git
cd chronohipaa

pip install -r requirements-dev.txt
pip install -e .

# Install pre-commit hooks
pre-commit install

Usage

See ARCHITECTURE.md for system design, component diagrams, and integration patterns.

Documentation

• ARCHITECTURE.md - System design and components
• PERFORMANCE.md - Benchmarks and characteristics

Contributing

See CONTRIBUTING.md for development standards.

License

Apache-2.0 © 2026 Jacob Coleman — See LICENSE for details.