@clarify-labs/cli 0.10.3 → 0.11.1

package/output/{engine-BDdPszs2.cjs → engine-Cbn_coqg.cjs}

@@ -48,6 +48,8 @@ let node_fs = require("node:fs");
 let vite = require("vite");
 let zod = require("zod");
 let yaml = require("yaml");
+let _msgpack_msgpack = require("@msgpack/msgpack");
+let _orama_orama = require("@orama/orama");
 let node_url = require("node:url");
 let _apidevtools_swagger_parser = require("@apidevtools/swagger-parser");
 _apidevtools_swagger_parser = __toESM(_apidevtools_swagger_parser, 1);
@@ -410,10 +412,10 @@ function frontmatterKeywords(frontmatter) {
 	const keywords = Array.isArray(value) ? value.filter((item) => typeof item === "string") : typeof value === "string" ? value.split(",").map((keyword) => keyword.trim()).filter(Boolean) : [];
 	return keywords.length > 0 ? keywords : void 0;
 }
-function withAlternates(route, routes, i18n) {
+function withAlternates(route, routes, locales) {
 	const basePath = route.basePath ?? route.path;
 	const routeByLocaleAndBase = new Map(routes.filter((r) => !r.locale || r.path === `/${r.locale}` || r.path.startsWith(`/${r.locale}/`)).map((r) => [`${r.locale ?? ""}:${r.basePath ?? r.path}`, r]));
-	const alternates = Object.fromEntries(i18n.locales.flatMap((locale) => {
+	const alternates = Object.fromEntries(locales.locales.flatMap((locale) => {
 		const alternate = routeByLocaleAndBase.get(`${locale.code}:${basePath}`);
 		return alternate ? [[locale.code, alternate.path]] : [];
 	}));
@@ -426,11 +428,11 @@ function withAlternates(route, routes, i18n) {
 * 为默认语言的 locale-prefixed 路由生成无前缀的"裸路径别名"，方便不带语言
 * 前缀的 URL 也能访问。标记 `isBareAlias` 以便搜索索引生成时过滤重复索引。
 */
-function generateBareAliases(routes, i18n) {
+function generateBareAliases(routes, locales) {
 	const bareRoutes = [];
 	const seenBare = new Set(routes.map((r) => r.path));
 	for (const route of routes) {
-		if (route.locale !== i18n.defaultLocale) continue;
+		if (route.locale !== locales.default) continue;
 		const bp = route.basePath ?? route.path;
 		if (bp === route.path || seenBare.has(bp)) continue;
 		seenBare.add(bp);
@@ -442,42 +444,42 @@ function generateBareAliases(routes, i18n) {
 	}
 	return bareRoutes;
 }
-async function findLocalizedContentRoutes(contentRoot, i18n, options = {}) {
-	if (!i18n) return findContentRoutes(contentRoot, contentRoot, options);
+async function findLocalizedContentRoutes(contentRoot, locales, options = {}) {
+	if (!locales) return findContentRoutes(contentRoot, contentRoot, options);
 	const localizedRoutes = [];
-	for (const locale of i18n.locales) {
+	for (const locale of locales.locales) {
 		const localeRoot = (0, node_path.join)(contentRoot, locale.code);
 		const discovered = await findContentRoutes(localeRoot, localeRoot, options);
 		for (const route of discovered) {
 			const basePath = route.basePath ?? route.path;
 			localizedRoutes.push({
 				...route,
-				path: localizedRoutePath(basePath, locale.code, i18n),
+				path: localizedRoutePath(basePath, locale.code, locales),
 				basePath,
 				locale: locale.code,
 				module: { virtualModuleId: virtualModuleIdForLocalizedRoute(contentRoot, route.source.filePath) }
 			});
 		}
 	}
-	if (i18n.missing === "fallback") {
+	if (locales.missing === "fallback") {
 		const routeByLocaleAndBase = new Map(localizedRoutes.map((route) => [`${route.locale ?? ""}:${route.basePath ?? route.path}`, route]));
-		const defaultRoutes = localizedRoutes.filter((route) => route.locale === i18n.defaultLocale);
+		const defaultRoutes = localizedRoutes.filter((route) => route.locale === locales.default);
 		for (const sourceRoute of defaultRoutes) {
 			const basePath = sourceRoute.basePath ?? sourceRoute.path;
-			for (const locale of i18n.locales) {
+			for (const locale of locales.locales) {
 				const key = `${locale.code}:${basePath}`;
 				if (routeByLocaleAndBase.has(key)) continue;
 				localizedRoutes.push({
 					...sourceRoute,
-					path: localizedRoutePath(basePath, locale.code, i18n),
+					path: localizedRoutePath(basePath, locale.code, locales),
 					locale: locale.code,
 					isFallback: true
 				});
 			}
 		}
 	}
-	const routesWithAlternates = localizedRoutes.map((route) => withAlternates(route, localizedRoutes, i18n));
-	return [...routesWithAlternates, ...generateBareAliases(routesWithAlternates, i18n)];
+	const routesWithAlternates = localizedRoutes.map((route) => withAlternates(route, localizedRoutes, locales));
+	return [...routesWithAlternates, ...generateBareAliases(routesWithAlternates, locales)];
 }
 function buildNavigation(routes) {
 	const root = [];
@@ -554,7 +556,7 @@ function collectExplicitPagePathIntents(tabs) {
 	}
 	return intents;
 }
-function applyConfiguredPageRoutePaths(routes, tabs, i18n) {
+function applyConfiguredPageRoutePaths(routes, tabs, locales) {
 	const pageIntents = collectExplicitPagePathIntents(tabs);
 	if (!pageIntents.length) return routes;
 	const additions = [];
@@ -570,15 +572,15 @@ function applyConfiguredPageRoutePaths(routes, tabs, i18n) {
 			existingKeys.add(key);
 			additions.push({
 				...route,
-				path: route.locale && i18n ? localizedRoutePath(targetBasePath, route.locale, i18n) : targetBasePath,
+				path: route.locale && locales ? localizedRoutePath(targetBasePath, route.locale, locales) : targetBasePath,
 				basePath: targetBasePath
 			});
 		}
 	}
 	const nextRoutes = [...routes, ...additions];
-	const routesWithAlternates = i18n ? nextRoutes.map((route) => withAlternates(route, nextRoutes, i18n)) : nextRoutes;
-	if (!i18n) return routesWithAlternates;
-	return [...routesWithAlternates, ...generateBareAliases(routesWithAlternates, i18n)];
+	const routesWithAlternates = locales ? nextRoutes.map((route) => withAlternates(route, nextRoutes, locales)) : nextRoutes;
+	if (!locales) return routesWithAlternates;
+	return [...routesWithAlternates, ...generateBareAliases(routesWithAlternates, locales)];
 }
 function buildNavigationFromPagesConfig(routes, config) {
 	if (!config || config === "FileTree") return buildNavigation(routes);
@@ -641,25 +643,25 @@ function buildNavigationFromConfig(routes, config) {
 		};
 	});
 }
-function localizeNavigationPaths(nodes, locale, i18n) {
+function localizeNavigationPaths(nodes, locale, locales) {
 	return nodes.map((node) => ({
 		...node,
-		path: localizedRoutePath(node.path, locale, i18n),
-		children: node.children ? localizeNavigationPaths(node.children, locale, i18n) : void 0
+		path: localizedRoutePath(node.path, locale, locales),
+		children: node.children ? localizeNavigationPaths(node.children, locale, locales) : void 0
 	}));
 }
-function buildLocalizedNavigationForLocale(routes, config, locale, i18n) {
+function buildLocalizedNavigationForLocale(routes, config, locale, locales) {
 	if (!config || config === "FileTree") return localizeNavigationPaths(buildNavigation(routes.map((route) => ({
 		...route,
 		path: route.basePath ?? route.path
-	}))), locale, i18n);
+	}))), locale, locales);
 	const routeMap = new Map(routes.map((route) => [route.basePath ?? route.path, route]));
 	const buildItem = (item) => {
 		if (typeof item !== "string" && "group" in item) {
 			const children = item.pages.map(buildItem);
 			return {
 				path: firstNavigationPath(children),
-				title: resolveLocalizedText(item.group, locale, i18n.defaultLocale) ?? "",
+				title: resolveLocalizedText(item.group, locale, locales.default) ?? "",
 				icon: item.icon,
 				children
 			};
@@ -667,10 +669,10 @@ function buildLocalizedNavigationForLocale(routes, config, locale, i18n) {
 		const intent = routeIntentFromPagesItem(item);
 		const basePath = intent.kind === "openapi" ? openAPIPagePathFromRef(intent.ref, intent.tagFilter, intent.path) : routePathFromRef(intent.ref, intent.path);
 		const route = routeMap.get(basePath);
-		const path = route?.path ?? localizedRoutePath(basePath, locale, i18n);
+		const path = route?.path ?? localizedRoutePath(basePath, locale, locales);
 		return {
-			path: (intent.kind === "page" && intent.redirect ? localizedRoutePath(routePathFromRef(intent.redirect), locale, i18n) : void 0) ?? path,
-			title: resolveLocalizedText(intent.title, locale, i18n.defaultLocale) ?? route?.meta.title ?? kebabToTitle(basePath.split("/").pop() ?? intent.ref),
+			path: (intent.kind === "page" && intent.redirect ? localizedRoutePath(routePathFromRef(intent.redirect), locale, locales) : void 0) ?? path,
+			title: resolveLocalizedText(intent.title, locale, locales.default) ?? route?.meta.title ?? kebabToTitle(basePath.split("/").pop() ?? intent.ref),
 			icon: intent.icon,
 			sections: route?.meta.sections ? navigationSections(route.meta.sections) : void 0
 		};
@@ -678,24 +680,24 @@ function buildLocalizedNavigationForLocale(routes, config, locale, i18n) {
 	return config.map((group) => {
 		const children = group.pages.map(buildItem);
 		return {
-			path: children[0]?.path ?? localizedRoutePath("/", locale, i18n),
-			title: resolveLocalizedText(group.group, locale, i18n.defaultLocale) ?? "",
+			path: children[0]?.path ?? localizedRoutePath("/", locale, locales),
+			title: resolveLocalizedText(group.group, locale, locales.default) ?? "",
 			icon: group.icon,
 			children
 		};
 	});
 }
-function buildLocalizedNavigationFromTabsConfig(routes, tabs, i18n) {
-	if (!i18n) return void 0;
+function buildLocalizedNavigationFromTabsConfig(routes, tabs, localesConfig) {
+	if (!localesConfig) return void 0;
 	const locales = {};
-	for (const locale of i18n.locales) {
+	for (const locale of localesConfig.locales) {
 		const localeRoutes = routes.filter((route) => route.locale === locale.code);
 		locales[locale.code] = { tabs: tabs.map((tab) => {
-			const children = buildLocalizedNavigationForLocale(localeRoutes, tab.pages, locale.code, i18n);
+			const children = buildLocalizedNavigationForLocale(localeRoutes, tab.pages, locale.code, localesConfig);
 			return {
 				type: "tab",
 				path: firstNavigationPath(children),
-				title: resolveLocalizedText(tab.tab, locale.code, i18n.defaultLocale) ?? "",
+				title: resolveLocalizedText(tab.tab, locale.code, localesConfig.default) ?? "",
 				icon: tab.icon,
 				children
 			};
@@ -762,7 +764,7 @@ function inferRouteForFile(filePath, contentRoot, defaultLocale) {
 	const localeSegmentIndex = fileLocale ? segments.indexOf(fileLocale) : -1;
 	const basePath = basePathFromRef(localeSegmentIndex >= 0 ? segments.slice(localeSegmentIndex + 1).join("/") : ref);
 	const path = fileLocale && defaultLocale ? localizedRoutePath(basePath, fileLocale, {
-		defaultLocale,
+		default: defaultLocale,
 		missing: "fallback",
 		locales: []
 	}) : basePath;
@@ -815,12 +817,12 @@ async function handleDevRouteRequest(req, res, routes, context) {
 	}
 	const file = typeof body === "object" && body !== null ? body.file : void 0;
 	if (typeof file === "string" && file.length > 0) {
-		const route = resolveRouteForFile(file, routes, context.projectConfig.i18n?.defaultLocale);
+		const route = resolveRouteForFile(file, routes, context.projectConfig.locales?.default);
 		if (route) {
 			res.end(JSON.stringify(toDevRouteEntry(route)));
 			return;
 		}
-		const inferred = inferRouteForFile(file, context.contentRoot, context.projectConfig.i18n?.defaultLocale);
+		const inferred = inferRouteForFile(file, context.contentRoot, context.projectConfig.locales?.default);
 		res.end(JSON.stringify(inferred));
 		return;
 	}
@@ -846,8 +848,7 @@ function resolveThemeConfig(theme = {}) {
 		layout: {
 			...presetTheme.layout,
 			...theme.layout
-		},
-		editor: theme.editor ?? presetTheme.editor
+		}
 	};
 }
 //#endregion
@@ -855,26 +856,26 @@ function resolveThemeConfig(theme = {}) {
 var clarifyLogoConfigSchema = zod.z.union([zod.z.string(), zod.z.object({
 	light: zod.z.string().optional(),
 	dark: zod.z.string().optional()
-})]);
+}).strict()]);
 var clarifyFaviconConfigSchema = zod.z.union([zod.z.string(), zod.z.object({
 	light: zod.z.string().optional(),
 	dark: zod.z.string().optional()
-})]);
+}).strict()]);
 var clarifyLocalizedTextSchema = zod.z.union([zod.z.string(), zod.z.record(zod.z.string(), zod.z.string())]);
 var clarifyLocaleConfigSchema = zod.z.object({
 	code: zod.z.string(),
 	label: zod.z.string(),
 	dir: zod.z.union([zod.z.literal("ltr"), zod.z.literal("rtl")]).optional()
-});
-var clarifyI18nConfigSchema = zod.z.object({
-	defaultLocale: zod.z.string().optional(),
+}).strict();
+var clarifyLocalesConfigSchema = zod.z.object({
+	default: zod.z.string().optional(),
 	missing: zod.z.union([
 		zod.z.literal("fallback"),
 		zod.z.literal("404"),
 		zod.z.literal("hide")
 	]).optional(),
 	locales: zod.z.array(clarifyLocaleConfigSchema).min(1)
-}).superRefine((config, ctx) => {
+}).strict().superRefine((config, ctx) => {
 	const localeCodes = /* @__PURE__ */ new Set();
 	for (const [index, locale] of config.locales.entries()) {
 		if (localeCodes.has(locale.code)) ctx.addIssue({
@@ -888,17 +889,17 @@ var clarifyI18nConfigSchema = zod.z.object({
 		});
 		localeCodes.add(locale.code);
 	}
-	if (config.defaultLocale && !localeCodes.has(config.defaultLocale)) ctx.addIssue({
+	if (config.default && !localeCodes.has(config.default)) ctx.addIssue({
 		code: zod.z.ZodIssueCode.custom,
-		message: "defaultLocale must be one of i18n.locales",
-		path: ["defaultLocale"]
+		message: "default must be one of locales.locales",
+		path: ["default"]
 	});
 });
 var clarifyNavbarLinkSchema = zod.z.object({
 	label: clarifyLocalizedTextSchema,
 	href: zod.z.string(),
 	external: zod.z.boolean().optional()
-});
+}).strict();
 var clarifyBannerConfigOptionsSchema = zod.z.object({
 	content: clarifyLocalizedTextSchema,
 	dismissible: zod.z.boolean().optional(),
@@ -916,11 +917,11 @@ var clarifyVariableValueSchema = zod.z.lazy(() => zod.z.union([
 	zod.z.record(zod.z.string(), clarifyVariableValueSchema)
 ]));
 var clarifyVariablesConfigSchema = zod.z.record(zod.z.string(), clarifyVariableValueSchema);
-var clarifySourceConfigSchema = zod.z.object({
-	repository: zod.z.string(),
+var clarifyRepositoryConfigSchema = zod.z.object({
+	url: zod.z.string().optional(),
 	branch: zod.z.string().optional(),
 	directory: zod.z.string().optional()
-});
+}).strict();
 var clarifyPagesItemSchema = zod.z.lazy(() => zod.z.union([
 	zod.z.string(),
 	clarifyPagesGroupSchema,
@@ -930,32 +931,32 @@ var clarifyPagesItemSchema = zod.z.lazy(() => zod.z.union([
 		title: clarifyLocalizedTextSchema.optional(),
 		icon: zod.z.string().optional(),
 		redirect: zod.z.string().optional()
-	}),
+	}).strict(),
 	zod.z.object({
 		openapi: zod.z.string(),
 		path: zod.z.string().optional(),
 		icon: zod.z.string().optional(),
 		title: clarifyLocalizedTextSchema.optional(),
-		filter: zod.z.object({ tags: zod.z.array(zod.z.string()).optional() }).optional()
-	})
+		filter: zod.z.object({ tags: zod.z.array(zod.z.string()).optional() }).strict().optional()
+	}).strict()
 ]));
 var clarifyPagesGroupSchema = zod.z.lazy(() => zod.z.object({
 	group: clarifyLocalizedTextSchema,
 	icon: zod.z.string().optional(),
 	pages: zod.z.array(clarifyPagesItemSchema)
-}));
+}).strict());
 var clarifyPagesConfigSchema = zod.z.union([zod.z.array(clarifyPagesGroupSchema), zod.z.literal("FileTree")]);
 var clarifyTabItemSchema = zod.z.object({
 	tab: clarifyLocalizedTextSchema,
 	icon: zod.z.string().optional(),
 	pages: clarifyPagesConfigSchema.optional()
-});
+}).strict();
 var clarifyTabsConfigSchema = zod.z.array(clarifyTabItemSchema);
 var clarifyThemePresetSchema = zod.z.enum(["default", "base"]);
 var clarifyThemeModeColorValueSchema = zod.z.object({
 	light: zod.z.string().optional(),
 	dark: zod.z.string().optional()
-});
+}).strict();
 var clarifyThemeColorValueSchema = zod.z.union([zod.z.string(), clarifyThemeModeColorValueSchema]);
 var clarifyThemeColorTokensConfigSchema = zod.z.object({
 	primary: clarifyThemeColorValueSchema.optional(),
@@ -966,42 +967,65 @@ var clarifyThemeColorTokensConfigSchema = zod.z.object({
 	muted: clarifyThemeColorValueSchema.optional(),
 	border: clarifyThemeColorValueSchema.optional(),
 	codeBackground: clarifyThemeColorValueSchema.optional()
-});
+}).strict();
 var clarifyThemeRadiusTokensConfigSchema = zod.z.object({
 	sm: zod.z.string().optional(),
 	md: zod.z.string().optional(),
 	lg: zod.z.string().optional(),
 	xl: zod.z.string().optional()
-});
+}).strict();
 var clarifyThemeTokensConfigSchema = zod.z.object({
 	colors: clarifyThemeColorTokensConfigSchema.optional(),
 	radius: clarifyThemeRadiusTokensConfigSchema.optional()
-});
-var clarifyThemeLayoutConfigSchema = zod.z.object({ maxWidth: zod.z.string().optional() });
+}).strict();
+var clarifyThemeLayoutConfigSchema = zod.z.object({ maxWidth: zod.z.string().optional() }).strict();
 var clarifyThemeConfigSchema = zod.z.object({
 	preset: clarifyThemePresetSchema.optional(),
 	tokens: clarifyThemeTokensConfigSchema.optional(),
-	layout: clarifyThemeLayoutConfigSchema.optional(),
-	editor: zod.z.boolean().optional()
-});
+	layout: clarifyThemeLayoutConfigSchema.optional()
+}).strict();
+function featureSchema(shape, defaults) {
+	const objectSchema = zod.z.object({
+		enabled: zod.z.boolean().default(true),
+		...shape
+	}).strict().default({
+		enabled: true,
+		...defaults
+	});
+	return zod.z.union([zod.z.boolean(), objectSchema]).default({
+		enabled: true,
+		...defaults
+	}).transform((value) => typeof value === "boolean" ? {
+		enabled: value,
+		...defaults
+	} : value);
+}
+var clarifyFeaturesConfigSchema = zod.z.object({
+	search: featureSchema({ mcp: zod.z.boolean().default(true) }, { mcp: true }),
+	repository: featureSchema(clarifyRepositoryConfigSchema.shape, {}),
+	themeEditor: featureSchema({}, {}),
+	openapi: featureSchema({ playground: zod.z.boolean().default(true) }, { playground: true })
+}).strict();
 var clarifyProjectConfigSchema = zod.z.object({
 	title: zod.z.string().optional(),
 	description: zod.z.string().optional(),
 	siteUrl: zod.z.string().optional(),
-	source: clarifySourceConfigSchema.optional(),
+	routePrefix: zod.z.string().default("/"),
+	assetPrefix: zod.z.string().optional(),
 	logo: clarifyLogoConfigSchema.optional(),
 	homeUrl: zod.z.string().optional(),
 	favicon: clarifyFaviconConfigSchema.optional(),
 	theme: clarifyThemeConfigSchema.optional(),
-	routePrefix: zod.z.string().optional(),
-	assetPrefix: zod.z.string().optional(),
-	navbar: zod.z.object({ links: zod.z.array(clarifyNavbarLinkSchema).optional() }).optional(),
+	navigation: zod.z.object({
+		links: zod.z.array(clarifyNavbarLinkSchema).optional(),
+		tabs: clarifyTabsConfigSchema.optional()
+	}).strict().optional(),
 	banner: clarifyBannerConfigOptionsSchema.optional(),
 	footer: clarifyFooterConfigSchema.optional(),
+	locales: clarifyLocalesConfigSchema.optional(),
 	variables: clarifyVariablesConfigSchema.optional(),
-	i18n: clarifyI18nConfigSchema.optional(),
-	tabs: clarifyTabsConfigSchema.optional()
-});
+	features: clarifyFeaturesConfigSchema.optional()
+}).strict();
 //#endregion
 //#region source/core/config/config.ts
 function formatIssuePath(path) {
@@ -1023,17 +1047,20 @@ function validateProjectConfig(value) {
 	if (!result.success) throw new Error(formatProjectConfigError(result.error));
 	return result.data;
 }
-function resolveI18nConfig(i18n) {
-	if (!i18n) return void 0;
-	const firstLocale = i18n.locales[0]?.code;
-	const defaultLocale = i18n.defaultLocale ?? firstLocale;
+function resolveLocalesConfig(locales) {
+	if (!locales) return void 0;
+	const firstLocale = locales.locales[0]?.code;
+	const defaultLocale = locales.default ?? firstLocale;
 	if (!defaultLocale) return void 0;
 	return {
-		defaultLocale,
-		missing: i18n.missing ?? "fallback",
-		locales: i18n.locales
+		default: defaultLocale,
+		missing: locales.missing ?? "fallback",
+		locales: locales.locales
 	};
 }
+function resolveFeaturesConfig(features = {}) {
+	return clarifyFeaturesConfigSchema.parse(features);
+}
 function resolveRoutePrefix(routePrefix) {
 	const trimmed = routePrefix?.trim();
 	if (!trimmed || trimmed === "/") return "/";
@@ -1054,26 +1081,24 @@ function resolveProjectConfig(config = {}) {
 		title: config.title ?? "Clarify Docs",
 		description: config.description ?? "",
 		siteUrl: config.siteUrl,
-		source: config.source,
+		routePrefix,
+		assetPrefix: resolveAssetPrefix(config.assetPrefix, routePrefix),
 		logo: config.logo,
 		homeUrl: config.homeUrl,
 		favicon: config.favicon,
-		routePrefix,
-		assetPrefix: resolveAssetPrefix(config.assetPrefix, routePrefix),
 		theme: resolveThemeConfig(config.theme),
-		navbar: config.navbar,
+		navigation: config.navigation,
 		banner: config.banner,
 		footer: config.footer,
+		locales: resolveLocalesConfig(config.locales),
 		variables: config.variables ?? {},
-		i18n: resolveI18nConfig(config.i18n),
-		tabs: config.tabs
+		features: resolveFeaturesConfig(config.features)
 	};
 }
 //#endregion
 //#region source/core/config/user-config.ts
 function defineConfig(config) {
-	validateProjectConfig(config);
-	return config;
+	return validateClarifyConfig(config);
 }
 /**
 * Config filenames Clarify CLI looks for at the project root, in resolution
@@ -1097,18 +1122,23 @@ function assertConfigObject(config, configFile) {
 }
 function loadJsonConfig(configFile) {
 	const config = assertConfigObject(JSON.parse((0, node_fs.readFileSync)(configFile, "utf-8")), configFile);
-	const projectConfig = validateProjectConfig(config);
-	const ssg = config.ssg && typeof config.ssg === "object" && !Array.isArray(config.ssg) ? config.ssg : void 0;
-	return {
+	if ("plugins" in config) throw new Error("[clarify] clarify.json does not support plugins; use clarify.ts or clarify.js");
+	return validateClarifyConfig(config);
+}
+function validateClarifyConfig(config) {
+	const { plugins, ...projectConfigInput } = config;
+	if (plugins !== void 0 && !Array.isArray(plugins)) throw new Error("[clarify] config field \"plugins\" is invalid: Expected an array");
+	const projectConfig = validateProjectConfig(projectConfigInput);
+	return plugins ? {
 		...projectConfig,
-		...ssg ? { ssg } : {}
-	};
+		plugins
+	} : projectConfig;
 }
 async function loadClarifyConfig(root, env) {
 	const configFile = findClarifyConfigFile(root);
 	if (!configFile) return {};
 	if (configFile.endsWith(".json")) return loadJsonConfig(configFile);
-	return assertConfigObject((await (0, vite.loadConfigFromFile)(env, configFile, root, "silent"))?.config, configFile);
+	return validateClarifyConfig(assertConfigObject((await (0, vite.loadConfigFromFile)(env, configFile, root, "silent"))?.config, configFile));
 }
 /**
 * File extensions Clarify treats as content files. Kept in sync with the
@@ -1134,9 +1164,9 @@ function buildProjectInfo(context) {
 		contentRoot: (contentRoot.startsWith(projectRoot) ? contentRoot.slice(projectRoot.length).replace(/^[/\\]+/, "") : contentRoot) || "source",
 		projectRoot
 	};
-	if (projectConfig.i18n) response.i18n = {
-		defaultLocale: projectConfig.i18n.defaultLocale,
-		locales: projectConfig.i18n.locales.map((l) => l.code)
+	if (projectConfig.locales) response.locales = {
+		default: projectConfig.locales.default,
+		locales: projectConfig.locales.locales.map((l) => l.code)
 	};
 	return response;
 }
@@ -1196,10 +1226,23 @@ function resolveVirtualModuleId(id, modules, routes) {
 	if (route) return resolveVirtualId(route.module.virtualModuleId);
 	return null;
 }
-function generateConfigModule(projectConfig, buildOptions, version) {
+function generateConfigModule(projectConfig, version) {
 	const runtimeConfig = {
-		...projectConfig,
-		...buildOptions
+		title: projectConfig.title,
+		description: projectConfig.description,
+		siteUrl: projectConfig.siteUrl,
+		routePrefix: projectConfig.routePrefix,
+		assetPrefix: projectConfig.assetPrefix,
+		logo: projectConfig.logo,
+		homeUrl: projectConfig.homeUrl,
+		favicon: projectConfig.favicon,
+		theme: projectConfig.theme,
+		navigation: projectConfig.navigation,
+		banner: projectConfig.banner,
+		footer: projectConfig.footer,
+		locales: projectConfig.locales,
+		variables: projectConfig.variables,
+		features: projectConfig.features
 	};
 	if (version) runtimeConfig.version = version;
 	return `export const config = ${JSON.stringify(runtimeConfig)};`;
@@ -1303,7 +1346,7 @@ function buildVirtualModules(args) {
 	const modules = /* @__PURE__ */ new Map();
 	const clientEntryModule = createClientEntryModule({ themeEditor: args.themeEditor });
 	const allPlugins = [...args.plugins ?? []];
-	modules.set(VIRTUAL_CONFIG, generateConfigModule(args.projectConfig, args.generateOptions, args.version));
+	modules.set(VIRTUAL_CONFIG, generateConfigModule(args.projectConfig, args.version));
 	modules.set(VIRTUAL_ROUTES, generateRoutesModule(args.routes, args.navigation, "client"));
 	modules.set(VIRTUAL_SERVER_ROUTES, generateRoutesModule(args.routes, args.navigation, "server"));
 	modules.set(VIRTUAL_SLOTS, createRuntimeSlotsModule(allPlugins, args.generateOptions.projectRoot));
@@ -1528,7 +1571,7 @@ function createViteAdapter(engine) {
 	const compilePolicyPlugin = {
 		name: "clarify:content-compile-policy",
 		configResolved(config) {
-			contentCompileErrorPolicy = config.command === "build" && engine.generateOptions.ssg.failOnError ? "throw" : "diagnostic";
+			contentCompileErrorPolicy = config.command === "build" ? "throw" : "diagnostic";
 		}
 	};
 	const tailwind = (0, _tailwindcss_vite.default)();
@@ -1544,7 +1587,7 @@ function createViteAdapter(engine) {
 }
 var cliPackageVersion = {
 	name: "@clarify-labs/cli",
-	version: "0.10.3",
+	version: "0.11.1",
 	license: "AGPL-3.0-only",
 	type: "module",
 	repository: {
@@ -1585,6 +1628,9 @@ var cliPackageVersion = {
 		"@clarify-labs/templates": "workspace:*",
 		"@mdx-js/mdx": "^3.1.1",
 		"@mdx-js/rollup": "^3.1.1",
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"@msgpack/msgpack": "^3.1.3",
+		"@orama/orama": "^3.1.18",
 		"@shikijs/rehype": "^4.3.0",
 		"@tailwindcss/vite": "^4.3.2",
 		"@vitejs/plugin-react": "^6.0.3",
@@ -1603,7 +1649,6 @@ var cliPackageVersion = {
 		"rehype-raw": "^7.0.0",
 		"rehype-slug": "^6.0.0",
 		"remark": "^15.0.1",
-		"remark-gfm": "^4.0.1",
 		"shiki": "4.3.0",
 		"unist-util-visit": "^5.1.0",
 		"vite": "^8.1.4",
@@ -1624,8 +1669,7 @@ function resolveBuildOptions(options = {}) {
 	return {
 		projectRoot: options.projectRoot ?? process.cwd(),
 		rootDirectory: options.rootDirectory ?? "source",
-		outputDirectory: options.outputDirectory,
-		ssg: { failOnError: options.ssg?.failOnError ?? true }
+		outputDirectory: options.outputDirectory
 	};
 }
 //#endregion
@@ -1683,7 +1727,7 @@ function llmsTxtListItem(route, basePath) {
 	return description ? `- [${route.meta.title}](${basePath}${contentArtifactUrl}): ${description}` : `- [${route.meta.title}](${basePath}${contentArtifactUrl})`;
 }
 function llmsTxtLocaleLabel(locale, projectConfig) {
-	return projectConfig.i18n?.locales.find((item) => item.code === locale)?.label ?? locale;
+	return projectConfig.locales?.locales.find((item) => item.code === locale)?.label ?? locale;
 }
 function groupRoutesByLocale(routes) {
 	const groups = /* @__PURE__ */ new Map();
@@ -1695,7 +1739,7 @@ function groupRoutesByLocale(routes) {
 }
 function groupLlmsTxtRoutesByLocale(routes, projectConfig) {
 	const routesBySource = /* @__PURE__ */ new Map();
-	const defaultLocale = projectConfig.i18n?.defaultLocale;
+	const defaultLocale = projectConfig.locales?.default;
 	for (const route of routes) {
 		const sourceKey = `${route.locale ?? defaultLocale ?? "default"}:${route.basePath ?? route.artifacts?.contentArtifactUrl ?? route.path}`;
 		const previousRoute = routesBySource.get(sourceKey);
@@ -1885,6 +1929,347 @@ function createHtmlShellPlugin() {
 	};
 }
 //#endregion
+//#region source/plugins/mcp-search/mcp-config.ts
+/**
+* Normalize a route prefix into a root-relative path segment.
+*
+* `'/'` -> `''`, `'/docs'` -> `'/docs'`, `'docs/'` -> `'/docs'`.
+*/
+function normalizePrefix(routePrefix) {
+	if (!routePrefix || routePrefix === "/") return "";
+	return `/${routePrefix.replace(/^\/+|\/+$/g, "")}`;
+}
+/**
+* Assemble the MCP site config from build-time metadata.
+*
+* Unlike the previous pagefind-based descriptor, this no longer reads an
+* entry JSON file - the Orama index is a single binary blob, so the caller
+* supplies the document count and locale list directly from the build step
+* that produced the index.
+*/
+function createMcpSiteConfig(projectConfig, options) {
+	const prefix = normalizePrefix(projectConfig.routePrefix);
+	return {
+		version: 3,
+		site: {
+			title: projectConfig.title,
+			description: projectConfig.description,
+			url: projectConfig.siteUrl,
+			routePrefix: projectConfig.routePrefix ?? "/"
+		},
+		capabilities: { search: {
+			type: "search",
+			indexPath: `${prefix}/mcp-search.msp`,
+			defaultLocale: projectConfig.locales?.default,
+			documentCount: options.documentCount,
+			locales: options.locales
+		} }
+	};
+}
+//#endregion
+//#region source/plugins/mcp-search/orama-index.ts
+/**
+* Orama schema for the MCP search index.
+*
+* - `path`, `title`, `description`, `content` are full-text searchable strings.
+* - `locale` is an `enum` so we can use `where: { locale: { eq } }` filters at
+*   query time. (`string` fields cannot be filtered in Orama.)
+* - `keywords` is a `string[]` also indexed for full-text matching.
+*/
+var mcpSearchSchema = {
+	path: "string",
+	title: "string",
+	description: "string",
+	locale: "enum",
+	content: "string",
+	keywords: "string[]"
+};
+/**
+* Intl.Segmenter cache keyed by BCP 47 tag. Segmenter construction is not
+* cheap, and the MCP server issues many queries against the same locale, so
+* we reuse instances. The cache is module-scoped: build and runtime share it
+* in the same process, and separate processes get their own - which is fine.
+*/
+var segmenterCache = /* @__PURE__ */ new Map();
+function getSegmenter(locale) {
+	let seg = segmenterCache.get(locale);
+	if (!seg) {
+		seg = new Intl.Segmenter(locale, { granularity: "word" });
+		segmenterCache.set(locale, seg);
+	}
+	return seg;
+}
+/**
+* Map a Clarify locale code (e.g. `zh-CN`, `en-US`, `ja-JP`) to a BCP 47 tag
+* suitable for `Intl.Segmenter`. Returns `null` for locales we intentionally
+* want to tokenize with the Latin/whitespace fallback (faster, and avoids
+* forcing CJK-style word segmentation on Latin scripts).
+*/
+function segmenterLocale(locale) {
+	if (!locale) return null;
+	const lower = locale.toLowerCase();
+	if (lower.startsWith("zh")) return "zh-CN";
+	if (lower.startsWith("ja")) return "ja-JP";
+	if (lower.startsWith("ko")) return "ko-KR";
+	return null;
+}
+/**
+* Tokenize text for Orama indexing and querying.
+*
+* CJK locales use `Intl.Segmenter` (word granularity), which splits
+* spaceless scripts into words and individual characters. Latin/whitespace
+* locales fall back to a Unicode-aware split on spaces and punctuation.
+*
+* All tokens are lowercased so queries match regardless of case.
+*/
+function tokenizeForSearch(text, locale) {
+	if (!text) return [];
+	const segLocale = segmenterLocale(locale);
+	if (segLocale) {
+		const seg = getSegmenter(segLocale);
+		return Array.from(seg.segment(text)).filter((s) => s.isWordLike).map((s) => s.segment.toLowerCase());
+	}
+	return text.toLowerCase().split(/[\s\p{P}]+/u).filter(Boolean);
+}
+/**
+* Build an Orama tokenizer component bound to a specific default locale.
+*
+* The tokenizer receives the raw field value and the per-field language hint
+* from Orama (which we don't set per-field, so it falls back to the default
+* language). We resolve the segmenter locale from the default locale at
+* construction time so the same tokenizer handles all documents in a
+* predominantly single-locale index.
+*
+* For multi-locale indexes, the tokenizer is also used at query time. Since
+* the query locale is not known to Orama's tokenizer callback, we use the
+* index's default locale - this is acceptable because:
+*   - CJK queries get CJK segmentation (correct)
+*   - Latin queries against a CJK-default index still work because Latin
+*     text has no word boundaries for CJK segmenters to mis-split; the
+*     segmenter passes through Latin words as-is.
+*/
+function createMcpTokenizer(defaultLocale) {
+	return {
+		language: defaultLocale ?? "en",
+		normalizationCache: /* @__PURE__ */ new Map(),
+		tokenize(raw, language) {
+			return tokenizeForSearch(typeof raw === "string" ? raw : String(raw ?? ""), language ?? defaultLocale);
+		}
+	};
+}
+/**
+* Compose the searchable text for a route. Shared between the Pagefind
+* (browser) and Orama (MCP) indexing paths so both backends see the same
+* field order and content.
+*/
+function routeSearchContent(route) {
+	return [
+		route.meta.title,
+		route.meta.description,
+		route.meta.keywords?.join(" "),
+		route.meta.sections?.map((section) => section.title).join(" "),
+		route.source.content
+	].filter(Boolean).join("\n\n");
+}
+/**
+* Convert a `ContentRoute` into the document shape stored in the Orama index.
+*/
+function routeToSearchDocument(route, defaultLocale) {
+	if (route.isBareAlias) return null;
+	const content = routeSearchContent(route);
+	if (!content.trim()) return null;
+	return {
+		path: route.path,
+		title: route.meta.title ?? "",
+		description: route.meta.description ?? "",
+		locale: route.locale ?? defaultLocale ?? "en",
+		content,
+		keywords: route.meta.keywords ?? []
+	};
+}
+/**
+* Create an Orama index pre-configured with the MCP schema and CJK-aware
+* tokenizer. Both the build step and the runtime loader use this so the
+* tokenizer is guaranteed to match between indexing and querying.
+*
+* Annotated as `AnyOrama` (Orama's exported base type) rather than inferred
+* via `ReturnType<typeof create>` because the inference would pull in
+* Orama's internal component types (`DocumentsStore`, `Index`, `Sorter`)
+* which are not exported and break `.d.ts` generation (TS2883).
+*/
+function createMcpSearchIndex(defaultLocale) {
+	return (0, _orama_orama.create)({
+		schema: mcpSearchSchema,
+		components: { tokenizer: createMcpTokenizer(defaultLocale) }
+	});
+}
+/**
+* Insert search documents into an Orama index.
+*/
+function indexSearchDocuments(db, documents) {
+	if (documents.length === 0) return;
+	(0, _orama_orama.insertMultiple)(db, documents);
+}
+/**
+* Build a ready-to-search Orama index from content routes.
+*
+* Filters out bare aliases and empty routes. Returns the populated db.
+*/
+function buildSearchIndex(routes, defaultLocale) {
+	const db = createMcpSearchIndex(defaultLocale);
+	const documents = [];
+	for (const route of routes) {
+		const doc = routeToSearchDocument(route, defaultLocale);
+		if (doc) documents.push(doc);
+	}
+	indexSearchDocuments(db, documents);
+	return {
+		db,
+		documentCount: documents.length
+	};
+}
+/**
+* Collect the distinct locale codes that will be present in the Orama index,
+* in stable insertion order. Bare aliases are skipped (they duplicate the
+* default-locale route). Locales with no code fall back to the project
+* default so single-locale sites still surface one locale.
+*/
+function collectIndexedLocales(routes, defaultLocale) {
+	const seen = /* @__PURE__ */ new Set();
+	const locales = [];
+	for (const route of routes) {
+		if (route.isBareAlias) continue;
+		const code = route.locale ?? defaultLocale ?? "en";
+		if (!seen.has(code)) {
+			seen.add(code);
+			locales.push(code);
+		}
+	}
+	return locales;
+}
+/**
+* Search an Orama MCP index.
+*
+* Applies an optional locale filter (via the `enum` field) and returns a
+* compact, LLM-friendly hit shape. Excerpts are derived from the matched
+* content: Orama does not return highlighted excerpts, so we synthesize a
+* short window around the first query term occurrence.
+*/
+function searchMcpIndex(db, params) {
+	const limit = Math.max(1, Math.min(50, params.limit ?? 10));
+	const result = (0, _orama_orama.search)(db, {
+		term: params.query,
+		limit,
+		where: params.locale ? { locale: { eq: params.locale } } : void 0
+	});
+	return {
+		hits: result.hits.map((hit) => {
+			const doc = hit.document;
+			return {
+				path: doc.path,
+				title: doc.title || guessTitleFromPath(doc.path),
+				description: doc.description,
+				locale: doc.locale,
+				score: hit.score,
+				excerpt: makeExcerpt(doc.content, params.query),
+				keywords: doc.keywords
+			};
+		}),
+		count: result.count
+	};
+}
+/**
+* Build a short excerpt around the first occurrence of any query term in the
+* content. Falls back to the beginning of the content if no term is found.
+*/
+function makeExcerpt(content, query, maxLen = 240) {
+	if (!content) return "";
+	const terms = query.toLowerCase().split(/[\s\p{P}]+/u).filter(Boolean);
+	const lower = content.toLowerCase();
+	let pos = -1;
+	for (const term of terms) {
+		const i = lower.indexOf(term);
+		if (i >= 0 && (pos < 0 || i < pos)) pos = i;
+	}
+	if (pos < 0) pos = 0;
+	const half = Math.floor(maxLen / 2);
+	const start = Math.max(0, pos - half);
+	const end = Math.min(content.length, start + maxLen);
+	const prefix = start > 0 ? "…" : "";
+	const suffix = end < content.length ? "…" : "";
+	return `${prefix}${content.slice(start, end).trim()}${suffix}`;
+}
+function guessTitleFromPath(path) {
+	if (!path) return "(untitled)";
+	const segments = path.split("/").filter(Boolean);
+	if (segments.length === 0) return "Home";
+	return segments[segments.length - 1].replace(/\.(md|mdx|html)$/, "").replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/**
+* Serialize an Orama index to a msgpack binary buffer.
+*
+* Uses `save()` to extract the raw index data, then msgpack-encodes it for a
+* compact binary representation. The same schema + tokenizer must be supplied
+* when loading so query-time tokenization matches indexing-time tokenization.
+*/
+function serializeSearchIndex(db) {
+	return (0, _msgpack_msgpack.encode)((0, _orama_orama.save)(db));
+}
+/**
+* Deserialize a msgpack binary buffer into a ready-to-search Orama index.
+*
+* The caller must supply the same `defaultLocale` used when the index was
+* built, so the tokenizer matches. A mismatch would not corrupt data but
+* would cause CJK query terms to be tokenized incorrectly (e.g. "文档" left
+* as a single token instead of split into "文" + "档").
+*/
+function deserializeSearchIndex(buffer, defaultLocale) {
+	const raw = (0, _msgpack_msgpack.decode)(buffer);
+	const db = createMcpSearchIndex(defaultLocale);
+	(0, _orama_orama.load)(db, raw);
+	return db;
+}
+//#endregion
+//#region source/plugins/mcp-search/index.ts
+/**
+* MCP search index plugin.
+*
+* Generates the Orama binary index (`mcp-search.msp`) and the MCP site
+* descriptor (`mcp.json`) as build assets consumed by the `clarify mcp`
+* command to serve documentation search to MCP-aware clients (e.g. AI coding
+* assistants).
+*
+* This plugin is independent of `clarify:page-search` (Pagefind), which
+* powers in-browser search. The MCP server runs in Node and needs a
+* self-contained, compact index with CJK-aware tokenization that doesn't
+* depend on the browser-only Pagefind runtime.
+*/
+function createMcpSearchPlugin() {
+	return {
+		name: "clarify:mcp-search",
+		hooks: { "build:assets"(ctx) {
+			const searchConfig = ctx.projectConfig.features.search;
+			if (!searchConfig.enabled || !searchConfig.mcp) return [];
+			const defaultLocale = ctx.projectConfig.locales?.default;
+			const { db, documentCount } = buildSearchIndex(ctx.routes, defaultLocale);
+			const locales = collectIndexedLocales(ctx.routes, defaultLocale);
+			const mcpConfig = createMcpSiteConfig(ctx.projectConfig, {
+				documentCount,
+				locales
+			});
+			const assets = [{
+				fileName: `${mcpConfig.capabilities.search?.indexPath.replace(/\/mcp-search\.msp$/, "") ?? ""}/mcp-search.msp`.replace(/^\//, ""),
+				source: serializeSearchIndex(db)
+			}, {
+				fileName: "mcp.json",
+				source: `${JSON.stringify(mcpConfig, null, 2)}\n`
+			}];
+			console.log(`[clarify] MCP search index (${documentCount} docs, ${locales.length} locales) written to mcp-search.msp.`);
+			return assets;
+		} }
+	};
+}
+//#endregion
 //#region source/plugins/openapi/parser.ts
 var OPENAPI_HTTP_METHODS = [
 	"get",
@@ -2090,7 +2475,7 @@ function collectOpenAPIPageIntents(config) {
 		if (!pages || pages === "FileTree") return;
 		for (const group of pages) visitItems(group.pages);
 	}
-	for (const tab of config.tabs ?? []) visitPages(tab.pages);
+	for (const tab of config.navigation?.tabs ?? []) visitPages(tab.pages);
 	return intents;
 }
 function virtualModuleIdFromPath(path) {
@@ -2113,14 +2498,14 @@ function cloneOpenAPIRoute(route, overrides = {}) {
 		...overrides
 	};
 }
-function findOpenAPIRoutesForContentRoot(contentRoot, i18n) {
-	if (!i18n) return findOpenAPIRoutes(contentRoot);
+function findOpenAPIRoutesForContentRoot(contentRoot, locales) {
+	if (!locales) return findOpenAPIRoutes(contentRoot);
 	const localizedRoutes = [];
-	for (const locale of i18n.locales) {
+	for (const locale of locales.locales) {
 		const localeRoot = (0, node_path.join)(contentRoot, locale.code);
 		for (const route of findOpenAPIRoutes(localeRoot, localeRoot)) {
 			const basePath = route.basePath ?? route.path;
-			const path = localizedRoutePath(basePath, locale.code, i18n);
+			const path = localizedRoutePath(basePath, locale.code, locales);
 			localizedRoutes.push({
 				...route,
 				path,
@@ -2130,15 +2515,15 @@ function findOpenAPIRoutesForContentRoot(contentRoot, i18n) {
 			});
 		}
 	}
-	if (i18n.missing === "fallback") {
+	if (locales.missing === "fallback") {
 		const routeByLocaleAndBase = new Map(localizedRoutes.map((route) => [`${route.locale ?? ""}:${route.basePath ?? route.path}`, route]));
-		const defaultRoutes = localizedRoutes.filter((route) => route.locale === i18n.defaultLocale);
+		const defaultRoutes = localizedRoutes.filter((route) => route.locale === locales.default);
 		for (const sourceRoute of defaultRoutes) {
 			const basePath = sourceRoute.basePath ?? sourceRoute.path;
-			for (const locale of i18n.locales) {
+			for (const locale of locales.locales) {
 				const key = `${locale.code}:${basePath}`;
 				if (routeByLocaleAndBase.has(key)) continue;
-				const path = localizedRoutePath(basePath, locale.code, i18n);
+				const path = localizedRoutePath(basePath, locale.code, locales);
 				localizedRoutes.push(cloneOpenAPIRoute(sourceRoute, {
 					path,
 					locale: locale.code,
@@ -2165,7 +2550,7 @@ function createConfiguredOpenAPIRoutes(routes, config) {
 			const key = `${route.locale ?? ""}:${targetBasePath}`;
 			if (existingKeys.has(key)) continue;
 			existingKeys.add(key);
-			const path = route.locale && config.i18n ? localizedRoutePath(targetBasePath, route.locale, config.i18n) : targetBasePath;
+			const path = route.locale && config.locales ? localizedRoutePath(targetBasePath, route.locale, config.locales) : targetBasePath;
 			additions.push(cloneOpenAPIRoute(route, {
 				path,
 				basePath: targetBasePath,
@@ -2178,12 +2563,12 @@ function createConfiguredOpenAPIRoutes(routes, config) {
 		}
 	}
 	const nextRoutes = [...routes, ...additions];
-	if (!config.i18n) return nextRoutes;
-	const routesWithAlternates = nextRoutes.map((route) => withAlternates(route, nextRoutes, config.i18n));
+	if (!config.locales) return nextRoutes;
+	const routesWithAlternates = nextRoutes.map((route) => withAlternates(route, nextRoutes, config.locales));
 	const bareAliases = [];
 	const seenBare = new Set(routesWithAlternates.map((route) => route.path));
 	for (const route of routesWithAlternates) {
-		if (route.locale !== config.i18n.defaultLocale) continue;
+		if (route.locale !== config.locales.default) continue;
 		const basePath = route.basePath ?? route.path;
 		if (basePath === route.path || seenBare.has(basePath)) continue;
 		seenBare.add(basePath);
@@ -2222,7 +2607,7 @@ function createOpenAPIPlugin() {
 		hooks: {
 			"routes:discover": (input, ctx) => ({
 				...input,
-				routes: [...input.routes, ...findOpenAPIRoutesForContentRoot(input.contentRoot, ctx.projectConfig.i18n)]
+				routes: [...input.routes, ...findOpenAPIRoutesForContentRoot(input.contentRoot, ctx.projectConfig.locales)]
 			}),
 			"routes:discovered": async (routes, ctx) => {
 				specs.clear();
@@ -2307,12 +2692,12 @@ function removeClarifyTempDir(path) {
 	});
 }
 //#endregion
-//#region source/plugins/search-index/search-language.ts
+//#region source/plugins/page-search/search-language.ts
 function toPagefindLanguage(locale) {
 	return locale?.trim().replace(/_/g, "-").split("-").filter(Boolean).join("-").toLowerCase() || "en";
 }
 //#endregion
-//#region source/plugins/search-index/index.ts
+//#region source/plugins/page-search/index.ts
 var pagefindContentTypes = {
 	".css": "text/css; charset=utf-8",
 	".js": "text/javascript; charset=utf-8",
@@ -2352,15 +2737,6 @@ async function generatePagefindIndex(options, pagefind) {
 		if (!pagefind) await runtime.close();
 	}
 }
-function routeSearchContent(route) {
-	return [
-		route.meta.title,
-		route.meta.description,
-		route.meta.keywords?.join(" "),
-		route.meta.sections?.map((section) => section.title).join(" "),
-		route.source.content
-	].filter(Boolean).join("\n\n");
-}
 async function generateDevSearchIndex(ctx, root, pagefind) {
 	const { errors, index } = await pagefind.createIndex({
 		includeCharacters: "._-/#:@",
@@ -2379,7 +2755,7 @@ async function generateDevSearchIndex(ctx, root, pagefind) {
 			const result = await index.addCustomRecord({
 				url: route.path,
 				content,
-				language: toPagefindLanguage(route.locale ?? ctx.projectConfig.i18n?.defaultLocale),
+				language: toPagefindLanguage(route.locale ?? ctx.projectConfig.locales?.default),
 				meta: { title: route.meta.title }
 			});
 			assertNoPagefindErrors(`addCustomRecord ${route.path}`, result.errors);
@@ -2417,11 +2793,12 @@ function serveDevPagefind(server, getRoot, ctx) {
 		(0, node_fs.createReadStream)(filePath).pipe(res);
 	});
 }
-function createSearchIndexPlugin() {
+function createPageSearchPlugin() {
 	return {
-		name: "clarify:search-index",
+		name: "clarify:page-search",
 		hooks: {
 			async "dev:configureServer"(server, ctx) {
+				if (!ctx.projectConfig.features.search.enabled) return;
 				const pagefind = await import("pagefind");
 				let currentRoot;
 				const staleRoots = /* @__PURE__ */ new Set();
@@ -2461,10 +2838,11 @@ function createSearchIndexPlugin() {
 				});
 			},
 			async "build:done"(ctx) {
+				if (!ctx.projectConfig.features.search.enabled) return;
 				const outputDirectory = ctx.generateOptions.outputDirectory;
 				if (!outputDirectory) return;
 				const pageCount = await generatePagefindIndex({ outputRoot: (0, node_path.resolve)(ctx.generateOptions.projectRoot, outputDirectory) });
-				console.log(`[clarify] Search index generated for ${pageCount} pages.`);
+				console.log(`[clarify] Page search index generated for ${pageCount} pages.`);
 			}
 		}
 	};
@@ -2513,16 +2891,18 @@ function createSeoPlugin() {
 	return {
 		name: "clarify:seo",
 		hooks: { "build:assets"(ctx) {
+			const assets = [];
 			const sitemap = createSitemapXml(ctx.routes, ctx.projectConfig);
 			const robots = createRobotsTxt(ctx.projectConfig);
-			if (!sitemap || !robots) return [];
-			return [{
+			if (sitemap) assets.push({
 				fileName: "sitemap.xml",
 				source: sitemap
-			}, {
+			});
+			if (robots) assets.push({
 				fileName: "robots.txt",
 				source: robots
-			}];
+			});
+			return assets;
 		} }
 	};
 }
@@ -2538,7 +2918,8 @@ function encodePath(path) {
 	return path.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
 }
 function createSourceEditUrl(filePath, contentRoot, source) {
-	const repository = normalizeRepositoryUrl(source.repository);
+	if (!source.url) return "";
+	const repository = normalizeRepositoryUrl(source.url);
 	const branch = source.branch ?? "main";
 	const sourcePath = [source.directory ? trimSlashes(source.directory) : "", (0, node_path.relative)(contentRoot, filePath).replaceAll("\\", "/")].filter(Boolean).join("/");
 	return `${repository}/edit/${encodeURIComponent(branch)}/${encodePath(sourcePath)}`;
@@ -2556,7 +2937,8 @@ function createSourceLinksPlugin() {
 	return {
 		name: "clarify:source-links",
 		hooks: { "routes:discovered": (routes, ctx) => {
-			attachSourceEditUrls(routes, (0, node_path.join)(ctx.generateOptions.projectRoot, ctx.generateOptions.rootDirectory), ctx.projectConfig.source);
+			if (!ctx.projectConfig.features.repository.enabled) return routes;
+			attachSourceEditUrls(routes, (0, node_path.join)(ctx.generateOptions.projectRoot, ctx.generateOptions.rootDirectory), ctx.projectConfig.features.repository);
 			return routes;
 		} }
 	};
@@ -2609,7 +2991,8 @@ function createBuiltinPlugins(options = {}) {
 		createSourceLinksPlugin(),
 		createContentArtifactsPlugin(),
 		createSeoPlugin(),
-		createSearchIndexPlugin()
+		createPageSearchPlugin(),
+		createMcpSearchPlugin()
 	];
 	if (options.htmlShell ?? true) plugins.push(createHtmlShellPlugin());
 	return plugins;
@@ -2671,18 +3054,18 @@ async function resolveProjectContext(options = {}, env = {
 }) {
 	const projectRoot = (0, node_path.resolve)(options.projectRoot ?? process.cwd());
 	const initialBuildOptions = resolveBuildOptions(options);
-	const contentRoot = (0, node_path.join)(projectRoot, initialBuildOptions.rootDirectory);
 	const configFilePath = findClarifyConfigFile(projectRoot);
 	const config = configFilePath && (0, node_fs.existsSync)(configFilePath) ? await loadClarifyConfig(projectRoot, env) : {};
 	const mergedOptions = {
 		...config,
 		...options,
 		projectRoot,
-		rootDirectory: initialBuildOptions.rootDirectory,
-		outputDirectory: initialBuildOptions.outputDirectory
+		rootDirectory: options.rootDirectory ?? initialBuildOptions.rootDirectory,
+		outputDirectory: options.outputDirectory ?? initialBuildOptions.outputDirectory
 	};
 	const resolvedProjectConfig = resolveProjectConfig(mergedOptions);
 	const resolvedBuildOptions = resolveBuildOptions(mergedOptions);
+	const contentRoot = (0, node_path.join)(projectRoot, resolvedBuildOptions.rootDirectory);
 	return {
 		projectRoot,
 		contentRoot,
@@ -2772,9 +3155,9 @@ function canonicalUrl(contextOrConfig, route) {
 /** Inject `lang` (and optional `dir`) onto the `<html>` tag for the route locale. */
 function injectHtmlLocaleAttributes(html, contextOrConfig, route) {
 	const projectConfig = resolveProjectConfigFromContext(contextOrConfig);
-	const localeCode = route?.locale ?? projectConfig.i18n?.defaultLocale;
+	const localeCode = route?.locale ?? projectConfig.locales?.default;
 	if (!localeCode) return html;
-	const dir = (projectConfig.i18n?.locales.find((locale) => locale.code === localeCode))?.dir;
+	const dir = (projectConfig.locales?.locales.find((locale) => locale.code === localeCode))?.dir;
 	return html.replace(/<html\b([^>]*)>/i, (_match, attributes) => {
 		let nextAttributes = attributes.replace(/\s+lang=("[^"]*"|'[^']*'|[^\s>]*)/i, "").replace(/\s+dir=("[^"]*"|'[^']*'|[^\s>]*)/i, "");
 		nextAttributes = `${nextAttributes} lang="${escapeHtml(localeCode)}"`;
@@ -2952,20 +3335,23 @@ async function buildSSRBundle(root, ssrEntry, ssrOutDir, plugins) {
 		}
 	});
 }
-async function renderSSGRoutes(routes, contextOrConfig, outputDirectory, ssrBundlePath, failOnError = true) {
+async function renderSSGRoutes(routes, contextOrConfig, outputDirectory, ssrBundlePath) {
 	const { render } = await import((0, node_url.pathToFileURL)(ssrBundlePath).href);
 	const template = readIndexHtml(outputDirectory);
 	if (!template) throw new Error(`[clarify] index.html not found in outputDirectory "${outputDirectory}". Make sure Vite build produces it.`);
-	for (const route of routes) try {
-		const finalHtml = injectSSRIntoTemplate(template, await render(route.path), contextOrConfig, route);
-		for (const outFile of routeOutputFiles(outputDirectory, route)) {
-			(0, node_fs.mkdirSync)((0, node_path.dirname)(outFile), { recursive: true });
-			(0, node_fs.writeFileSync)(outFile, finalHtml, "utf-8");
+	await Promise.all(routes.map(async (route) => {
+		try {
+			const appHtml = await render(route.path);
+			const finalHtml = injectSSRIntoTemplate(template, appHtml, contextOrConfig, route);
+			for (const outFile of routeOutputFiles(outputDirectory, route)) {
+				(0, node_fs.mkdirSync)((0, node_path.dirname)(outFile), { recursive: true });
+				(0, node_fs.writeFileSync)(outFile, finalHtml, "utf-8");
+			}
+		} catch (err) {
+			console.error(`[clarify] Failed to render route "${route.path}":`, err);
+			throw err;
 		}
-	} catch (err) {
-		console.error(`[clarify] Failed to render route "${route.path}":`, err);
-		if (failOnError) throw err;
-	}
+	}));
 }
 //#endregion
 //#region source/core/runtime/startup.ts
@@ -3041,10 +3427,10 @@ var ClarifyContext = class {
 		this.currentPlugins = plugins;
 	}
 	get isI18n() {
-		return Boolean(this.projectConfig.i18n);
+		return Boolean(this.projectConfig.locales);
 	}
 	get defaultLocale() {
-		return this.projectConfig.i18n?.defaultLocale;
+		return this.projectConfig.locales?.default;
 	}
 	get(key) {
 		return this.values.get(key);
@@ -3238,10 +3624,10 @@ var ClarifyEngine = class {
 	async discoverSite() {
 		const plugins = this.ctx.plugins;
 		const contentRoot = this.ctx.contentRoot;
-		const { i18n, tabs } = this.ctx.projectConfig;
+		const { locales, navigation: navigationConfig } = this.ctx.projectConfig;
 		let routes = await runPhase(plugins, "site:discover", this.ctx, async () => {
 			const options = { contentProcessor: createProjectContentProcessor(plugins, this.ctx) };
-			const discovered = i18n ? await findLocalizedContentRoutes(contentRoot, i18n, options) : await findContentRoutes(contentRoot, contentRoot, options);
+			const discovered = locales ? await findLocalizedContentRoutes(contentRoot, locales, options) : await findContentRoutes(contentRoot, contentRoot, options);
 			const result = await runHooks(plugins, "routes:discover", {
 				contentRoot,
 				routes: discovered
@@ -3270,8 +3656,9 @@ var ClarifyEngine = class {
 				};
 			});
 		});
-		routes = applyConfiguredPageRoutePaths(routes, tabs, i18n);
-		const navigation = tabs ? i18n ? buildLocalizedNavigationFromTabsConfig(routes, tabs, i18n) ?? {
+		const tabs = navigationConfig?.tabs;
+		routes = applyConfiguredPageRoutePaths(routes, tabs, locales);
+		const navigation = tabs ? locales ? buildLocalizedNavigationFromTabsConfig(routes, tabs, locales) ?? {
 			kind: "localized-tabbed",
 			locales: {}
 		} : buildNavigationFromTabsConfig(routes, tabs) : {
@@ -3301,7 +3688,7 @@ var ClarifyEngine = class {
 				routes: this.routes,
 				navigation: this.navigation,
 				plugins: this.plugins,
-				themeEditor: this.runtime.command === "serve" || this.runtime.themeEditor === true || this.projectConfig.theme.editor,
+				themeEditor: this.runtime.command === "serve" || this.runtime.themeEditor === true || this.projectConfig.features.themeEditor.enabled,
 				version: this.ctx.version
 			});
 			this.virtualModules = await runHooks(this.plugins, "modules:before", this.virtualModules, this.ctx);
@@ -3344,7 +3731,7 @@ var ClarifyEngine = class {
 		await runPhase(this.plugins, "ssg", this.ctx, async () => {
 			if (process.env.SKIP_CLARIFY_SSG) return;
 			if (!await runInterceptHooks(this.plugins, "ssg:shouldRun", this.ctx)) return;
-			if (this.generateOptions.ssg.failOnError) assertNoContentDiagnostics(this.routes);
+			assertNoContentDiagnostics(this.routes);
 			const outputDir = this.runtime.outputDirectory ?? this.generateOptions.outputDirectory;
 			if (!outputDir) throw new Error("[clarify] outputDirectory is required before SSG runs");
 			const ssrOutputDir = (0, node_path.join)(outputDir, ".ssr");
@@ -3358,10 +3745,10 @@ var ClarifyEngine = class {
 					plugins: this.runtime.ssrPlugins ?? []
 				});
 				const ssrBundlePath = (0, node_path.join)(ssrOutputDir, "entry-server.js");
-				await renderSSGRoutes(this.routes, this.runtimeContext(), outputDir, ssrBundlePath, this.generateOptions.ssg.failOnError);
+				await renderSSGRoutes(this.routes, this.runtimeContext(), outputDir, ssrBundlePath);
 			} catch (err) {
 				console.error("[clarify] SSG failed:", err);
-				if (this.generateOptions.ssg.failOnError) throw err;
+				throw err;
 			} finally {
 				if (tempEntryPath) try {
 					(0, node_fs.rmSync)(tempEntryPath, { force: true });
@@ -3451,5 +3838,17 @@ Object.defineProperty(exports, "defineConfig", {
 		return defineConfig;
 	}
 });
+Object.defineProperty(exports, "deserializeSearchIndex", {
+	enumerable: true,
+	get: function() {
+		return deserializeSearchIndex;
+	}
+});
+Object.defineProperty(exports, "searchMcpIndex", {
+	enumerable: true,
+	get: function() {
+		return searchMcpIndex;
+	}
+});
 
-//# sourceMappingURL=engine-BDdPszs2.cjs.map
+//# sourceMappingURL=engine-Cbn_coqg.cjs.map