2026-05-11 01:08:31 -07:00
|
|
|
import { createMDX } from "fumadocs-mdx/next";
|
|
|
|
|
|
|
|
|
|
const withMDX = createMDX();
|
|
|
|
|
|
|
|
|
|
/** @type {import('next').NextConfig} */
|
2026-05-11 16:40:34 -07:00
|
|
|
const config = {
|
2026-05-15 02:30:20 +02:00
|
|
|
basePath: "/ktx",
|
2026-05-11 16:40:34 -07:00
|
|
|
async rewrites() {
|
2026-05-28 13:00:49 +02:00
|
|
|
return {
|
|
|
|
|
beforeFiles: [
|
|
|
|
|
{
|
|
|
|
|
source: "/stars",
|
|
|
|
|
has: [{ type: "host", value: "ktx.sh" }],
|
|
|
|
|
destination: "https://ktx-stars.vercel.app/stars",
|
|
|
|
|
basePath: false,
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
source: "/stars/:path*",
|
|
|
|
|
has: [{ type: "host", value: "ktx.sh" }],
|
|
|
|
|
destination: "https://ktx-stars.vercel.app/stars/:path*",
|
|
|
|
|
basePath: false,
|
|
|
|
|
},
|
|
|
|
|
],
|
|
|
|
|
afterFiles: [
|
|
|
|
|
{
|
|
|
|
|
source: "/docs/:path*.md",
|
|
|
|
|
destination: "/llms.mdx/docs/:path*",
|
|
|
|
|
},
|
|
|
|
|
],
|
|
|
|
|
};
|
2026-05-11 16:40:34 -07:00
|
|
|
},
|
2026-05-15 02:30:20 +02:00
|
|
|
async redirects() {
|
|
|
|
|
return [
|
docs: rewrite Semantic Querying concept with imperative-vs-declarative diagram (#156)
* 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
* Fix CI dead-code failures
* docs-site: polish semantic-layer-internals code blocks and flow diagram
- Make CodeBlock a server component so children traverse synchronously
under React 19 RSC streaming; previously extractText returned "" in
dev SSR, leaving code blocks empty.
- Add custom JSON/YAML/SQL/code-like tokenizers with theme-aware token
classes; drop the colored file-glyph dot and gradient tab-head.
- Tighten tab-head: subtle grey background, smaller monospace filename
in muted grey, smaller rectangular language pill placed to the left
of the filename.
- Polish the React Flow semantic-layer diagram (controls, fit-view
padding, edge types).
* docs-site: annotate imperative SQL, add section anchor, drop ClickHouse
- Wire numbered red badges to each problematic span in the "Without KTX"
SQL with hover sync between SQL gutter, lines, and the notes list.
- Add #imperative-vs-declarative anchor on the flow section header so
the eyebrow link is shareable; reveals a # glyph on hover/focus.
- Align the compiled-SQL note dots to the first-line midpoint
(mt-[6px] instead of mt-1) so 4px dots sit at y=8 in a 16px line.
- Remove all ClickHouse references from docs-site (primary-sources,
quickstart, ktx-setup, contributing, agents-setup, mechanics test,
warehouse drivers in the flow diagram).
* test: drop ClickHouse contributing-docs assertion
Align the workspace-package mirror test with the ClickHouse removal
from docs-site (75907eb). The connector-clickhouse package still
exists in packages/, but contributing.mdx no longer lists it, so the
test that mirrored docs against the workspace was failing.
2026-05-19 23:41:29 +02:00
|
|
|
{
|
|
|
|
|
source: "/",
|
|
|
|
|
destination: "/ktx/docs/getting-started/introduction",
|
|
|
|
|
permanent: false,
|
|
|
|
|
basePath: false,
|
|
|
|
|
},
|
2026-05-16 12:06:34 +02:00
|
|
|
{
|
|
|
|
|
source: "/docs",
|
|
|
|
|
destination: "/docs/getting-started/introduction",
|
|
|
|
|
permanent: false,
|
|
|
|
|
basePath: false,
|
|
|
|
|
},
|
2026-05-15 02:30:20 +02:00
|
|
|
{
|
|
|
|
|
source: "/:path*",
|
|
|
|
|
has: [{ type: "host", value: "docs.ktx.sh" }],
|
|
|
|
|
destination: "https://docs.kaelio.com/ktx/:path*",
|
|
|
|
|
permanent: true,
|
|
|
|
|
basePath: false,
|
|
|
|
|
},
|
2026-05-27 18:20:51 +02:00
|
|
|
{
|
|
|
|
|
source: "/slack",
|
|
|
|
|
has: [{ type: "host", value: "ktx.sh" }],
|
|
|
|
|
destination:
|
|
|
|
|
"https://join.slack.com/t/ktxcommunity/shared_invite/zt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ",
|
|
|
|
|
permanent: false,
|
|
|
|
|
basePath: false,
|
|
|
|
|
},
|
2026-05-15 02:30:20 +02:00
|
|
|
{
|
2026-05-28 13:00:49 +02:00
|
|
|
source: "/:path((?!stars(?:/|$)).*)",
|
2026-05-15 02:30:20 +02:00
|
|
|
has: [{ type: "host", value: "ktx.sh" }],
|
2026-05-28 13:00:49 +02:00
|
|
|
destination: "https://docs.kaelio.com/ktx/:path",
|
2026-05-15 02:30:20 +02:00
|
|
|
permanent: true,
|
|
|
|
|
basePath: false,
|
|
|
|
|
},
|
|
|
|
|
];
|
|
|
|
|
},
|
2026-05-11 16:40:34 -07:00
|
|
|
};
|
2026-05-11 01:08:31 -07:00
|
|
|
|
|
|
|
|
export default withMDX(config);
|