git.stella-ops.org/src/__Libraries/StellaOps.Provcache.Postgres/AGENTS.md

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.