govoplan-dataflow/AGENTS.md

GovOPlaN Dataflow Codex Guide

Scope

This repository owns canonical pipeline definitions, immutable revisions, validation, constrained SQL compilation, preview and run diagnostics, and lineage references.

Keep external connection profiles and credentials in govoplan-connectors, analytical presentation in govoplan-reporting, process orchestration in govoplan-workflow, and sanctions review semantics in govoplan-risk-compliance.

Working Rules

• Never pass user-entered SQL directly to a database.
• Keep previews bounded by rows, bytes, nodes, and execution time.
• Do not persist preview row contents unless a future explicit retention policy requires it.
• Optional module integrations use manifest interfaces and capabilities, not direct imports.
• Gitea issues are the canonical backlog and implementation state.