govoplan-datasources/AGENTS.md

GovOPlaN Datasources Codex Guide

Scope

This repository owns the abstract datasource catalog, live/static/cached lifecycle, immutable snapshots, frozen states, staging references, and schema metadata.

Documentation Contract

• Treat documentation as part of every behavior change. Update this module's manifest-driven DocumentationTopic contributions for affected user and administrator behavior.
• Keep feature content here; govoplan-docs projects it without importing Datasources internals.
• Maintain a static user/admin baseline and run /mnt/DATA/git/govoplan/tools/checks/check-manifest-shapes.py after behavior or manifest changes.

Boundaries

• Connectors own external transport and credentials; Dataflow consumes governed datasource references.
• Preserve snapshot immutability, provenance, and scope-aware access.