Skip to content

Phase 1 stack #3: agentic insights / enrich - #95

Open
matthewmoorcroft wants to merge 1 commit into
stack/adf-discoveryfrom
stack/agentic-insights
Open

matthewmoorcroft wants to merge 1 commit into
stack/adf-discoveryfrom
stack/agentic-insights

Conversation

@matthewmoorcroft

@matthewmoorcroft matthewmoorcroft commented Sep 16, 2026

Copy link
Copy Markdown
Member

Part of the Phase 1 stack. Base: stack/adf-discovery. (Content of the former #82.)

What this adds

An optional, source-neutral, agent-authored insights layer over discovery. The deterministic inventory records what the source is; an external agent authors judgment; the library has no LLM — it validates the authored object and atomically merges it under one additive insights block.

Schema (insights block)

schema_version, inventory_sha256 (fingerprint binding), overview, system_recommendation, pipeline_insights[], pipeline_relationships[] — with recommended_patterns[] and per-pattern simplification_pattern.

Contract

enrich validates foreign keys / lineage refs / evidence / schema, stamps the library-owned fields, and atomically merges. Author→validate→merge; nothing else in the inventory changes.

Add a source-neutral insights artifact (models/insights.py) and an
enrich_inventory pass (discovery_insights.py) that layers agentic insights
onto the unified inventory, with a validator that forbids inferred-only keys
by presence and aggregates per-edge errors. Expose it through the discover
CLI and MCP (enrich subcommand) and document it in the flowx-discover skill.

Consolidates PR #82 (agentic insights enrich_inventory + validator + CLI/MCP).

Co-authored-by: Isaac <no-reply@databricks.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant