Class EnrichSchemaConstraints

Lightweight post-discovery enrichment — the runtime "LightweightConstraintDiscovery" from the integration design. Fills PROVABLE gaps with NO hard AI dependency:

• Deterministic, naming-based FK inference: for a field the source did NOT declare as a foreign key, infer ForeignKeyTarget only when the column name unambiguously points at exactly one sibling object (e.g. CompanyId → companies, or a field whose name equals a sibling's PK field name). Ambiguous or self-referential matches are left alone — provable-only, never guess.
• Optional one-shot descriptions when a describeFn is supplied (AI-optional; a no-op on instances without an AI provider, which is the common BI case).

Operates on the discovered SourceObjectInfo[] in place, BEFORE persistence, so the inferred FKs flow through IntegrationSchemaSync's normal Declared/Discovered merge (they land as MetadataSource='Discovered', soft FKs). Never throws.