# Provcache Postgres Library Charter

## Mission
- Provide deterministic PostgreSQL persistence for Provcache entries, evidence chunks, and revocations.

## Responsibilities
- Keep EF Core mappings stable and schema-compatible.
- Use injected TimeProvider/IGuidProvider for deterministic timestamps and IDs.
- Validate inputs and propagate CancellationToken through database operations.

## Required Reading
- docs/modules/prov-cache/architecture.md
- docs/modules/platform/architecture-overview.md

## Working Directory & Scope
- Primary: src/__Libraries/StellaOps.Provcache.Postgres

## Testing Expectations
- Add repository tests for upsert/delete/metrics and evidence chunk storage.
- Validate DbContext mappings and indexes with migrations or EF Core tests.

## Working Agreement
- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
- Keep outputs deterministic and ASCII-only in comments/logs.