ktx/packages/cli/test/context/sl
Luca Martial a651b82e2f
feat: query_policy semantic-layer-only restricts agents to predefined semantic-layer measures (#334)
* feat(sl): add predefined_measures_only guard to semantic query planning

SemanticQuery gains a predefined_measures_only flag; the planner rejects
any measure resolved with Provenance.COMPOSED (runtime aggregate
expressions and query-time derivations) while predefined measures,
predefined derived chains, dimensions, filters, and segments pass.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* feat(config): add per-connection query_policy to warehouse connections

query_policy: semantic-layer-only | read-only-sql (default) on the
warehouse connection schema, plus a policy module with the raw-SQL
guard, federated member restriction lookup, and the project-level
predicate used to gate sql_execution registration.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* feat(cli): enforce query_policy on raw SQL through one shared executor

ktx sql and the MCP sql_execution tool now share executeProjectRawSql
(resolve, policy check, read-only validation, execute), collapsing
their duplicated validate-then-execute paths. Restricted connections
are rejected before validation; federated raw SQL is rejected when any
member is restricted. sql_execution is not registered when every SQL
connection is restricted, and connection_list marks restricted
connections so agents route to sl_query. executeProjectReadOnlySql
stays generic for ktx-internal SQL (scan, ingest, SL-generated).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* feat(sl): compile queries with predefined_measures_only from query_policy

compileLocalSlQuery injects the flag from the connection's query_policy,
never from caller input, covering both ktx sl query and the MCP
sl_query tool through the daemon compile path.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* docs: document query_policy semantic-layer-only

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix(sl): close semantic-layer-only bypasses via filters and federated hint

The predefined_measures_only guard only inspected query.measures, so a
composed aggregate written into `filters` slipped through _classify_filters
into a HAVING clause untouched — letting a restricted agent evaluate
arbitrary aggregates (e.g. threshold-probing `sum(x) BETWEEN a AND b`).
Reject filter clauses that compose an aggregate function; a HAVING that
compares a predefined measure by name (`orders.revenue > 100`) still works.

Also make the federated sl_query error policy-aware: when a member is
restricted, raw federated SQL is disabled too, so stop directing the agent
to `ktx sql -c _ktx_federated` / sql_execution (a guaranteed failure) and
point to per-connection semantic-layer queries instead.

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Co-authored-by: Andrey Avtomonov <andreybavt@gmail.com>
2026-07-03 08:54:17 +00:00
..
tools fix: read semantic sources safely (#284) 2026-06-10 14:06:13 +02:00
description-normalization.test.ts fix(sl): stop baking drift-prone counts into overlay summaries (#270) 2026-06-08 15:58:12 +02:00
dictionary-search.test.ts test: split cli tests from source tree (#216) 2026-05-26 08:49:05 +02:00
local-query-federated.integration.test.ts feat(duckdb): cross-database federation via derived DuckDB connection (#295) 2026-06-15 15:01:39 +00:00
local-query-federated.test.ts feat(duckdb): cross-database federation via derived DuckDB connection (#295) 2026-06-15 15:01:39 +00:00
local-query.test.ts feat: query_policy semantic-layer-only restricts agents to predefined semantic-layer measures (#334) 2026-07-03 08:54:17 +00:00
local-sl-federated.test.ts feat(duckdb): cross-database federation via derived DuckDB connection (#295) 2026-06-15 15:01:39 +00:00
local-sl.test.ts fix: read semantic sources safely (#284) 2026-06-10 14:06:13 +02:00
pglite-sl-search-prototype.test.ts fix: read semantic sources safely (#284) 2026-06-10 14:06:13 +02:00
schemas.contract.test.ts test: split cli tests from source tree (#216) 2026-05-26 08:49:05 +02:00
semantic-layer.service.test.ts feat(athena): first-class AWS Athena warehouse identity (SL + BI mapping) (#332) 2026-07-02 15:10:29 +02:00
sl-dictionary-profile.test.ts test: split cli tests from source tree (#216) 2026-05-26 08:49:05 +02:00
sl-search.service.test.ts test: split cli tests from source tree (#216) 2026-05-26 08:49:05 +02:00
sl-source-seeding.test-utils.ts fix: read semantic sources safely (#284) 2026-06-10 14:06:13 +02:00
source-files-reserved.test.ts feat(duckdb): cross-database federation via derived DuckDB connection (#295) 2026-06-15 15:01:39 +00:00
source-files.test.ts fix: read semantic sources safely (#284) 2026-06-10 14:06:13 +02:00
sqlite-sl-sources-index.test.ts test: split cli tests from source tree (#216) 2026-05-26 08:49:05 +02:00