- {"Context inputs"} -
-semantic-layer/
-- {"source YAML, measures, joins, grain"} -
-wiki/
-- {"business rules, definitions, caveats"} -
-raw-sources/
-- {"schema scans, keys, imported metadata"} -
-provenance
-- {"ingest decisions and review history"} -
-- {"Semantic layer engine"} -
-Join graph
-- {"sources as nodes, joins as typed edges"} -
-Grain
-- {"row identity before aggregation"} -
-Measures
-- {"verified formulas and filters"} -
-Relationships
-- {"many_to_one, one_to_many, one_to_one"} -
-- {"Agent workflows"} -
-customers
-grain: customer_id
-orders
-grain: order_id
-order_items
-grain: order_id, line_id
-- {"Semantic maintenance loop"} -
-- {"Every accepted correction becomes input to the next graph build."} -
-- {"reviewed context"} -
-- {"The accepted graph becomes the starting point for the next build."} -
-- {"Step 1"} -
-{"ingest evidence"}
-- {"scan schemas, imports, and accepted files"} -
-- {"Step 2"} -
-{"YAML diff"}
-- {"draft source, join, grain, and measure changes"} -
-- {"Step 3"} -
-{"validation"}
-- {"check relationships, syntax, and unsafe query shapes"} -
-- {"Step 4"} -
-{"analyst review"}
-- {"accept, edit, or reject generated context"} -
-- {"Step 5"} -
-{"agent use"}
-- {"serve context to search, explain, and query"} -
-- {"Step 6"} -
-{"corrections"}
-- {"agent and analyst fixes become new evidence"} -
-- {"Unsafe shape"} -
-
-{`orders
- join order_items
- join customers
-group by customer_segment
-sum(orders.amount)`}
-
- - {"The order measure is exposed to line-item fan-out before aggregation."} -
-- {"KTX shape"} -
-
-{`orders_agg as (
- select customer_id, sum(amount) revenue
+Unsafe shape:
+
+```sql
+select customers.segment, sum(orders.amount)
+from orders
+join order_items on order_items.order_id = orders.id
+join customers on customers.id = orders.customer_id
+group by customers.segment;
+```
+
+KTX shape:
+
+```sql
+with orders_agg as (
+ select customer_id, sum(amount) as revenue
from orders
group by customer_id
)
-select customers.segment, sum(revenue)
+select customers.segment, sum(orders_agg.revenue)
from orders_agg
-join customers`}
-
- - {"KTX pre-aggregates fact measures at their own grain before joining dimensions."} -
-