ktx/docs-site
Andrey Avtomonov 911cfdc741 docs: rewrite Semantic Querying concept with imperative-vs-declarative diagram
Reframe semantic-layer-internals.mdx around the contract the semantic
layer offers an agent: declare what you want (a Semantic Query), KTX
figures out how to compute it. Replaces the old "Context-Aware SQL"
framing with a clear imperative-vs-declarative narrative.

Adds a React Flow component (semantic-layer-flow.tsx) that contrasts a
buggy 4-table agent-authored SQL (chasm trap, LEFT-JOIN-in-WHERE,
hardcoded DATE_TRUNC) against the chasm-safe per-fact CTE SQL the
planner actually emits, including the outer GROUP BY over the requested
dimensions. Both lanes converge into a shared warehouse node and each
SQL card now has parallel bullet notes (failures on the left, KTX
behavior on the right).

Side fixes bundled in:
- include the /ktx basePath in the favicon metadata so the icon resolves
  under the production prefix
- migrate docs-site/middleware.ts to docs-site/proxy.ts (Next 16 rename)
- redirect / to /ktx/docs/getting-started/introduction so the apex docs
  URL works
- add tests covering the apex redirect, the favicon basePath, and the
  middleware-to-proxy rename
- propagate the Semantic Query terminology across the ktx-sl CLI
  reference, the context-layer concept page, and the agent-clients /
  primary-sources integration pages
2026-05-19 19:34:04 +02:00
..
app docs: rewrite Semantic Querying concept with imperative-vs-declarative diagram 2026-05-19 19:34:04 +02:00
components docs: rewrite Semantic Querying concept with imperative-vs-declarative diagram 2026-05-19 19:34:04 +02:00
content docs: rewrite Semantic Querying concept with imperative-vs-declarative diagram 2026-05-19 19:34:04 +02:00
lib docs: add agent setup prompt endpoint (#142) 2026-05-19 15:22:17 +02:00
public docs: add ingestion flow diagram to readme (#144) 2026-05-19 16:02:20 +02:00
tests docs: rewrite Semantic Querying concept with imperative-vs-declarative diagram 2026-05-19 19:34:04 +02:00
.gitignore chore: configure docs site deployment 2026-05-11 17:57:55 +02:00
next-env.d.ts fix: allow agent setup without context (#139) 2026-05-19 12:18:52 +02:00
next.config.mjs docs: rewrite Semantic Querying concept with imperative-vs-declarative diagram 2026-05-19 19:34:04 +02:00
package.json feat(docs): visualize KTX ingestion with ReactFlow diagram (#133) 2026-05-18 17:41:37 +02:00
postcss.config.mjs chore: move docs site workspace 2026-05-11 16:53:42 +02:00
proxy.ts docs: rewrite Semantic Querying concept with imperative-vs-declarative diagram 2026-05-19 19:34:04 +02:00
source.config.ts docs: revamp quickstart and tighten code-block styling (#135) 2026-05-18 19:22:19 +02:00
tsconfig.json feat: merge ingest and scan 2026-05-14 01:43:06 +02:00