git.stella-ops.org/src/AirGap/__Libraries/StellaOps.AirGap.Persistence/AGENTS.md

AirGap Persistence Guild Charter

Working Directory

• src/AirGap/__Libraries/StellaOps.AirGap.Persistence

Scope

• PostgreSQL persistence for AirGap state and bundle version history.
• Data source configuration, schema management, and repository wiring.
• EF Core context scaffolding for AirGap data models.

Required Reading

• docs/README.md
• docs/07_HIGH_LEVEL_ARCHITECTURE.md
• docs/modules/platform/architecture-overview.md
• docs/airgap/bundle-repositories.md
• docs/airgap/airgap-mode.md

Working Agreements

• Update task status in the sprint tracker and local TASKS.md.
• Keep schema changes deterministic and migration-driven.
• Use configured schema names consistently (no hard-coded schema drift).
• Avoid cross-module edits unless the sprint explicitly permits them.

Testing Rules

• Use Postgres test fixtures or Testcontainers; no network.
• Mark integration tests as Integration, not Unit.
• Keep data ordering deterministic with explicit ORDER BY clauses.