mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-07 07:55:13 +02:00
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
50 lines
1.2 KiB
TypeScript
50 lines
1.2 KiB
TypeScript
import "./global.css";
|
|
import { RootProvider } from "fumadocs-ui/provider/next";
|
|
import { Outfit, Inter, Geist_Mono } from "next/font/google";
|
|
import type { ReactNode } from "react";
|
|
import type { Metadata } from "next";
|
|
|
|
const outfit = Outfit({
|
|
variable: "--font-outfit",
|
|
subsets: ["latin"],
|
|
weight: ["400", "500", "600", "700", "800"],
|
|
});
|
|
|
|
const inter = Inter({
|
|
variable: "--font-inter",
|
|
subsets: ["latin"],
|
|
});
|
|
|
|
const geistMono = Geist_Mono({
|
|
variable: "--font-geist-mono",
|
|
subsets: ["latin"],
|
|
});
|
|
|
|
export const metadata: Metadata = {
|
|
title: {
|
|
template: "%s | KTX Docs",
|
|
default: "KTX Docs",
|
|
},
|
|
description:
|
|
"Open-source context infrastructure that makes agentic analytics reliable.",
|
|
icons: {
|
|
icon: "/ktx/brand/ktx-mascot.svg",
|
|
shortcut: "/ktx/brand/ktx-mascot.svg",
|
|
},
|
|
};
|
|
|
|
export default function RootLayout({ children }: { children: ReactNode }) {
|
|
return (
|
|
<html
|
|
lang="en"
|
|
className={`${outfit.variable} ${inter.variable} ${geistMono.variable}`}
|
|
suppressHydrationWarning
|
|
>
|
|
<body>
|
|
<RootProvider search={{ options: { api: "/ktx/api/search" } }}>
|
|
<div className="ktx-site-shell">{children}</div>
|
|
</RootProvider>
|
|
</body>
|
|
</html>
|
|
);
|
|
}
|