@farming-labs/next 0.2.114 → 0.2.116

package/dist/api-reference.d.mts

@@ -34,8 +34,13 @@ declare function createNextApiReferencePage(config: DocsConfig): (props?: {
 }) => Promise<react_jsx_runtime0.JSX.Element>;
 declare function createNextApiReferenceLayout(config: DocsConfig): (props: {
   children: React.ReactNode;
+  params?: Promise<{
+    slug?: string[];
+  }> | {
+    slug?: string[];
+  };
 }) => Promise<react_jsx_runtime0.JSX.Element>;
-declare function getNextApiReferenceSourceState(config: DocsConfig): Promise<NextApiReferenceSourceState>;
-declare function getNextApiReferenceMode(config: DocsConfig): "fumadocs" | "scalar";
+declare function getNextApiReferenceSourceState(config: DocsConfig, versionId?: string): Promise<NextApiReferenceSourceState>;
+declare function getNextApiReferenceMode(config: DocsConfig): "farming-labs" | "fumadocs" | "scalar";
 //#endregion
 export { NextApiReferenceSourceState, buildNextOpenApiDocument, createNextApiReference, createNextApiReferenceLayout, createNextApiReferencePage, flattenApiReferencePageTreeForSidebar, getNextApiReferenceMode, getNextApiReferenceSourceState, resolveApiReferenceConfig, withNextApiReferenceBanner };

package/dist/api-reference.mjs

@@ -1,7 +1,8 @@
 import DocsClientCallbacks from "./client-callbacks.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join, relative } from "node:path";
-import { buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, resolveApiReferenceConfig, resolveApiReferenceRenderer } from "@farming-labs/docs/server";
+import { resolveDocsMetadataBaseUrl } from "@farming-labs/docs";
+import { buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, createApiReferenceOperationMarkdownResponse, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveApiReferenceVersion, resolveApiReferenceVersionFromPathname } from "@farming-labs/docs/server";
 import { ApiReference } from "@scalar/nextjs-api-reference";
 import { SidebarTabsDropdown } from "fumadocs-ui/components/sidebar/tabs/dropdown";
 import Link from "next/link";
@@ -235,11 +236,12 @@ function buildOpenApiPaths(routes) {
 	return paths;
 }
 function buildNextOpenApiDocument(config) {
-	if (resolveApiReferenceConfig(config.apiReference).specUrl) return {
+	const apiReference = resolveApiReferenceConfig(config.apiReference);
+	if (apiReference.specUrl || apiReference.versions.length > 0) return {
 		openapi: "3.1.0",
 		info: {
 			title: "API Reference",
-			description: "Remote OpenAPI specs are resolved at request time through the Next.js API reference renderer.",
+			description: "Configured OpenAPI specs are resolved at request time through the Next.js API reference renderer.",
 			version: "0.0.0"
 		},
 		servers: [{ url: "/" }],
@@ -552,14 +554,39 @@ function createNextApiReference(config) {
 	const apiReference = resolveApiReferenceConfig(config.apiReference);
 	return async (request) => {
 		if (!apiReference.enabled) return new Response("Not Found", { status: 404 });
+		const requestUrl = request ? new URL(request.url) : void 0;
+		if (request && requestUrl) {
+			const markdownResponse = await createApiReferenceOperationMarkdownResponse(config, {
+				request,
+				framework: "next",
+				rootDir: process.cwd(),
+				baseUrl: getOriginFromRequest(request),
+				origin: resolveDocsMetadataBaseUrl(config) || getOriginFromRequest(request),
+				sitemap: config.sitemap,
+				okf: config.agent?.okf
+			});
+			if (markdownResponse) return markdownResponse;
+		}
+		const version = (requestUrl ? resolveApiReferenceVersionFromPathname(config.apiReference, requestUrl.pathname) : void 0) ?? resolveApiReferenceVersion(apiReference);
+		if (resolveApiReferenceRenderer(config.apiReference, "next") === "farming-labs") {
+			const html = await buildApiReferenceHtmlDocumentAsync(config, {
+				framework: "next",
+				rootDir: process.cwd(),
+				baseUrl: getOriginFromRequest(request),
+				version: version?.id
+			});
+			return new Response(html, { headers: { "Content-Type": "text/html; charset=utf-8" } });
+		}
 		const document = await buildApiReferenceOpenApiDocumentAsync(config, {
 			framework: "next",
 			rootDir: process.cwd(),
-			baseUrl: getOriginFromRequest(request)
+			baseUrl: getOriginFromRequest(request),
+			version: version?.id
 		});
+		const basePath = `/${apiReference.path}${version ? `/${encodeURIComponent(version.id)}` : ""}`;
 		return ApiReference({
-			pageTitle: buildApiReferencePageTitle(config, "API Reference"),
-			title: "API Reference",
+			pageTitle: buildApiReferencePageTitle(config, version ? `API Reference – ${version.label}` : "API Reference"),
+			title: version ? `API Reference – ${version.label}` : "API Reference",
 			content: document,
 			theme: "deepSpace",
 			layout: "modern",
@@ -567,7 +594,7 @@ function createNextApiReference(config) {
 			forceDarkModeState: getForcedMode(config),
 			hideDarkModeToggle: isThemeToggleHidden(config),
 			customCss: buildApiReferenceScalarCss(config),
-			pathRouting: { basePath: `/${apiReference.path}` },
+			pathRouting: { basePath },
 			showSidebar: true,
 			defaultOpenFirstTag: true,
 			tagsSorter: "alpha",
@@ -591,8 +618,10 @@ function getOpenApiInfo(document) {
 function createNextApiReferencePage(config) {
 	return async function NextApiReferencePage(props) {
 		const [{ createAPIPage }, { DocsDescription, DocsPage, DocsTitle }] = await Promise.all([import("fumadocs-openapi/ui"), import("fumadocs-ui/layouts/notebook/page")]);
-		const { info, pages, server, source } = await getNextApiReferenceSourceState(config);
 		const slug = (props?.params ? await props.params : void 0)?.slug ?? [];
+		const version = resolveApiReferenceVersion(resolveApiReferenceConfig(config.apiReference), slug[0]);
+		const pageSlug = version ? slug.slice(1) : slug;
+		const { info, pages, server, source } = await getNextApiReferenceSourceState(config, version?.id);
 		if (pages.length === 0) return /* @__PURE__ */ jsxs(DocsPage, {
 			full: true,
 			children: [
@@ -607,10 +636,10 @@ function createNextApiReferencePage(config) {
 				})
 			]
 		});
-		const page = slug.length === 0 ? pages[0] : source.getPage(slug);
+		const page = pageSlug.length === 0 ? pages[0] : source.getPage(pageSlug);
 		if (!page || typeof page.data?.getAPIPageProps !== "function") notFound();
 		const APIPage = createAPIPage(server, { content: { renderOperationLayout: renderApiReferenceOperationLayout } });
-		const currentPageIndex = slug.length === 0 ? 0 : pages.findIndex((entry) => entry.url === page.url);
+		const currentPageIndex = pageSlug.length === 0 ? 0 : pages.findIndex((entry) => entry.url === page.url);
 		const previousPage = currentPageIndex > 0 ? pages[currentPageIndex - 1] : void 0;
 		const nextPage = currentPageIndex >= 0 && currentPageIndex < pages.length - 1 ? pages[currentPageIndex + 1] : void 0;
 		return /* @__PURE__ */ jsxs(DocsPage, {
@@ -681,10 +710,12 @@ function createNextApiReferencePage(config) {
 function createNextApiReferenceLayout(config) {
 	return async function NextApiReferenceLayout(props) {
 		const { DocsLayout } = await import("fumadocs-ui/layouts/notebook");
-		const { apiReference, primaryServerUrl, source } = await getNextApiReferenceSourceState(config);
+		const resolvedParams = props.params ? await props.params : void 0;
+		const version = resolveApiReferenceVersion(resolveApiReferenceConfig(config.apiReference), resolvedParams?.slug?.[0]);
+		const { apiReference, primaryServerUrl, source } = await getNextApiReferenceSourceState(config, version?.id);
 		const sidebarTree = flattenApiReferencePageTreeForSidebar(source.getPageTree());
 		const docsUrl = getDocsUrl(config);
-		const apiUrl = `/${apiReference.path}`;
+		const apiUrl = `/${apiReference.path}${version ? `/${encodeURIComponent(version.id)}` : ""}`;
 		const themeSwitch = resolveApiReferenceThemeSwitch(config.themeToggle);
 		const themeStyle = resolveApiReferenceThemeStyle(config);
 		const banner = mergeBanner(getExistingSidebarBanner(config), /* @__PURE__ */ jsx(ApiReferenceSwitcher, {
@@ -714,14 +745,16 @@ function createNextApiReferenceLayout(config) {
 		});
 	};
 }
-async function getNextApiReferenceSourceState(config) {
+async function getNextApiReferenceSourceState(config, versionId) {
 	const apiReference = resolveApiReferenceConfig(config.apiReference);
+	const version = resolveApiReferenceVersion(apiReference, versionId);
 	const [{ createOpenAPI, openapiPlugin, openapiSource }, { loader }] = await Promise.all([import("fumadocs-openapi/server"), import("fumadocs-core/source")]);
 	const baseUrl = await getOriginFromNextHeaders();
 	const document = await buildApiReferenceOpenApiDocumentAsync(config, {
 		framework: "next",
 		rootDir: process.cwd(),
-		baseUrl
+		baseUrl,
+		version: version?.id
 	});
 	const server = createOpenAPI({ input: async () => ({ main: document }) });
 	const info = getOpenApiInfo(document);
@@ -734,7 +767,7 @@ async function getNextApiReferenceSourceState(config) {
 			return slugifyApiReferencePageName(typeof operation?.summary === "string" && operation.summary.trim() ? operation.summary : typeof operation?.operationId === "string" && operation.operationId.trim() ? operation.operationId : `${output.item.method} ${output.item.path}`);
 		}
 	}), {
-		baseUrl: `/${apiReference.path}`,
+		baseUrl: `/${apiReference.path}${version ? `/${encodeURIComponent(version.id)}` : ""}`,
 		plugins: [openapiPlugin()]
 	});
 	return {

package/dist/api.mjs

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { createDocsAPI as createDocsAPI$1, createDocsMCPAPI as createDocsMCPAPI$1 } from "@farming-labs/theme/api";
-import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
+import { bundledAgentSkills, bundledRootDocuments } from "@farming-labs/docs/agent-skills-bundle";
 import { createDocsCloudRouteHandler } from "@farming-labs/docs/cloud/server";
 
 //#region src/api.ts
@@ -117,7 +117,8 @@ function createDocsAPI(options = {}, cloudIntegration) {
 	const handlers = createDocsAPI$1({
 		...options,
 		...rootDir ? { rootDir } : {},
-		_preloadedAgentSkills: options._preloadedAgentSkills ?? bundledAgentSkills
+		_preloadedAgentSkills: options._preloadedAgentSkills ?? bundledAgentSkills,
+		_preloadedRootDocuments: options._preloadedRootDocuments ?? bundledRootDocuments
 	});
 	const integration = resolveDocsCloudIntegration(cloudIntegration);
 	if (!integration) return handlers;
@@ -146,7 +147,8 @@ function createDocsMCPAPI(options = {}) {
 	return createDocsMCPAPI$1({
 		...options,
 		...rootDir ? { rootDir } : {},
-		_preloadedAgentSkills: options._preloadedAgentSkills ?? bundledAgentSkills
+		_preloadedAgentSkills: options._preloadedAgentSkills ?? bundledAgentSkills,
+		_preloadedRootDocuments: options._preloadedRootDocuments ?? bundledRootDocuments
 	});
 }
 

package/dist/config.mjs

@@ -669,11 +669,33 @@ function readAgentSkillPaths(root, configPath) {
 	if (!configured) throw new Error("withDocs could not statically bundle agent.skills. Use a literal path, a literal path array, or { paths: [...] } so configured skills are included in production.");
 	return configured;
 }
+const ROOT_DOCUMENT_FILES = [
+	"skill.md",
+	"AGENTS.md",
+	"AGENT.md"
+];
+/**
+* Snapshot the project-root agent documents into the skills bundle. Tracing
+* them by bare filename is not an option: Turbopack matches such globs at any
+* depth, which drags `node_modules/next/AGENTS.md` into the trace through the
+* pnpm workspace symlink and breaks Vercel output materialization.
+*/
+function readRootDocumentsSnapshot(root) {
+	const documents = {};
+	for (const fileName of ROOT_DOCUMENT_FILES) {
+		const filePath = join(root, fileName);
+		if (!existsSync(filePath)) continue;
+		try {
+			documents[fileName] = readFileSync(filePath, "utf8");
+		} catch {}
+	}
+	return Object.keys(documents).length > 0 ? documents : void 0;
+}
 function writeAgentSkillsBundle(root, configuredSkills) {
 	const bundlePath = join(root, AGENT_SKILLS_BUNDLE_PATH);
-	const source = `${GENERATED_BANNER}${renderDocsAgentSkillsBundle(resolveConfiguredAgentSkillsSync(configuredSkills, { rootDir: root }))}`;
-	mkdirSync(dirname(bundlePath), { recursive: true });
-	if (!existsSync(bundlePath) || readFileSync(bundlePath, "utf8") !== source) writeFileSync(bundlePath, source, "utf8");
+	const source = `${GENERATED_BANNER}${renderDocsAgentSkillsBundle(resolveConfiguredAgentSkillsSync(configuredSkills, { rootDir: root }), readRootDocumentsSnapshot(root))}`;
+	makeGeneratedDir(dirname(bundlePath));
+	if (!existsSync(bundlePath) || readFileSync(bundlePath, "utf8") !== source) writeGeneratedFile(bundlePath, source);
 	return bundlePath;
 }
 /** Read the OG endpoint from docs.config.ts[x] (returns undefined if not set). */
@@ -695,32 +717,32 @@ function readApiReferenceConfig(root) {
 			if (content.match(/apiReference\s*:\s*false/)) return {
 				enabled: false,
 				path: "api-reference",
-				renderer: "fumadocs",
+				renderer: "farming-labs",
 				routeRoot: "api"
 			};
 			if (content.match(/apiReference\s*:\s*true/)) return {
 				enabled: true,
 				path: "api-reference",
-				renderer: "fumadocs",
+				renderer: "farming-labs",
 				routeRoot: "api"
 			};
 			const block = extractObjectLiteral(content, "apiReference");
 			if (!block) continue;
 			const enabledMatch = block.match(/enabled\s*:\s*(true|false)/);
 			const pathMatch = block.match(/path\s*:\s*["']([^"']+)["']/);
-			const rendererMatch = block.match(/renderer\s*:\s*["'](fumadocs|scalar)["']/);
+			const rendererMatch = block.match(/renderer\s*:\s*["'](farming-labs|fumadocs|scalar)["']/);
 			const routeRootMatch = block.match(/routeRoot\s*:\s*["']([^"']+)["']/);
 			return {
 				enabled: enabledMatch ? enabledMatch[1] !== "false" : true,
 				path: pathMatch?.[1]?.replace(/^\/+|\/+$/g, "") || "api-reference",
-				renderer: rendererMatch?.[1] ?? "fumadocs",
+				renderer: rendererMatch?.[1] ?? "farming-labs",
 				routeRoot: routeRootMatch?.[1]?.replace(/^\/+|\/+$/g, "") || "api"
 			};
 		} catch {
 			return {
 				enabled: false,
 				path: "api-reference",
-				renderer: "fumadocs",
+				renderer: "farming-labs",
 				routeRoot: "api"
 			};
 		}
@@ -728,7 +750,7 @@ function readApiReferenceConfig(root) {
 	return {
 		enabled: false,
 		path: "api-reference",
-		renderer: "fumadocs",
+		renderer: "farming-labs",
 		routeRoot: "api"
 	};
 }
@@ -1155,7 +1177,29 @@ function resolveManagedChangelogSourceLayoutPath(root, appDir, entry, changelogC
 	return join(contentRoot, "layout.tsx");
 }
 function removeManagedFile(filePath) {
-	if (isManagedGeneratedFile(filePath)) rmSync(filePath, { force: true });
+	if (isManagedGeneratedFile(filePath)) withReadOnlyFsGuard(filePath, () => rmSync(filePath, { force: true }));
+}
+const READ_ONLY_FS_CODES = new Set([
+	"EROFS",
+	"EACCES",
+	"EPERM"
+]);
+/** Generation must not take down config evaluation on read-only filesystems; the build already shipped these files. */
+function withReadOnlyFsGuard(target, mutate) {
+	try {
+		return mutate();
+	} catch (error) {
+		const code = error?.code;
+		if (!code || !READ_ONLY_FS_CODES.has(code)) throw error;
+		console.warn(`[docs] Skipped generating ${target} (${code}): filesystem is read-only; using existing files.`);
+		return;
+	}
+}
+function makeGeneratedDir(dirPath) {
+	withReadOnlyFsGuard(dirPath, () => mkdirSync(dirPath, { recursive: true }));
+}
+function writeGeneratedFile(filePath, content) {
+	withReadOnlyFsGuard(filePath, () => writeFileSync(filePath, content, "utf8"));
 }
 function resolveMcpConfig(mcp) {
 	if (mcp === false) return {
@@ -1557,6 +1601,72 @@ function buildDocsMarkdownRewrites(entry, docsPath) {
 		}
 	];
 }
+function buildApiReferenceMarkdownRewrites(apiReference) {
+	if (!apiReference.enabled) return [];
+	const basePath = `/${apiReference.path}`;
+	const markdownAcceptHeader = {
+		type: "header",
+		key: "accept",
+		value: MARKDOWN_ACCEPT_HEADER_VALUE
+	};
+	const markdownSignatureAgentHeader = {
+		type: "header",
+		key: "signature-agent",
+		value: ".+"
+	};
+	const markdownAgentUserAgentHeader = {
+		type: "header",
+		key: "user-agent",
+		value: DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN
+	};
+	const markdownBotLikeUserAgentHeader = {
+		type: "header",
+		key: "user-agent",
+		value: DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN
+	};
+	const markdownTraditionalBotUserAgentHeader = {
+		type: "header",
+		key: "user-agent",
+		value: DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN
+	};
+	const markdownSecFetchModeHeader = {
+		type: "header",
+		key: "sec-fetch-mode"
+	};
+	return [{
+		source: `${basePath}/operations/:operation`,
+		path: `${apiReference.path}/operations/:operation`
+	}, {
+		source: `${basePath}/:version/operations/:operation`,
+		path: `${apiReference.path}/:version/operations/:operation`
+	}].flatMap((route) => [
+		{
+			source: `${route.source}.md`,
+			destination: `/api/docs?format=markdown&path=${route.path}`
+		},
+		{
+			source: route.source,
+			has: [markdownAcceptHeader],
+			destination: `/api/docs?format=markdown&path=${route.path}`
+		},
+		{
+			source: route.source,
+			has: [markdownSignatureAgentHeader],
+			destination: `/api/docs?format=markdown&path=${route.path}`
+		},
+		{
+			source: route.source,
+			has: [markdownAgentUserAgentHeader],
+			destination: `/api/docs?format=markdown&path=${route.path}`
+		},
+		{
+			source: route.source,
+			has: [markdownBotLikeUserAgentHeader],
+			missing: [markdownTraditionalBotUserAgentHeader, markdownSecFetchModeHeader],
+			destination: `/api/docs?format=markdown&path=${route.path}`
+		}
+	]);
+}
 function buildAgentSpecRewrites() {
 	return [
 		{
@@ -1863,7 +1973,7 @@ function buildHiddenFolderRedirects(docsDir, docsPath) {
 	scan(docsDir, []);
 	return dedupeRedirects(redirects);
 }
-function mergeDocsMarkdownRewrites(entry, docsPath, mcp, sitemap, agentFeedback, robots, result) {
+function mergeDocsMarkdownRewrites(entry, docsPath, apiReference, mcp, sitemap, agentFeedback, robots, result) {
 	const autoBeforeFilesRewrites = [
 		...buildAgentSpecRewrites(),
 		...buildStandardsDiscoveryRewrites(),
@@ -1873,6 +1983,7 @@ function mergeDocsMarkdownRewrites(entry, docsPath, mcp, sitemap, agentFeedback,
 		...buildSitemapRewrites(sitemap),
 		...buildRobotsRewrites(robots),
 		...buildDocsMarkdownRewrites(entry, docsPath),
+		...buildApiReferenceMarkdownRewrites(apiReference),
 		...buildDocsPathRewrites(entry, docsPath),
 		...buildAgentFeedbackRewrites(agentFeedback)
 	];
@@ -1910,36 +2021,36 @@ function withDocs(nextConfig = {}, docsConfig) {
 	const agentSkillsBundlePath = writeAgentSkillsBundle(root, docsConfig === void 0 || !Object.hasOwn(docsConfig, "agent") ? readAgentSkillPaths(root, docsConfigPath) : docsConfig.agent?.skills);
 	const agentFeedback = readAgentFeedbackConfig(root);
 	const docsConfigRelativeAlias = docsConfigPath.startsWith("./") || docsConfigPath.startsWith("../") ? docsConfigPath : `./${docsConfigPath}`;
-	ensureDocsReviewWorkflow({
+	withReadOnlyFsGuard(".github/workflows/docs-review.yml", () => ensureDocsReviewWorkflow({
 		rootDir: root,
 		configPath: docsConfigPath,
 		configContent: existsSync(docsConfigAbsolutePath) ? readFileSync(docsConfigAbsolutePath, "utf-8") : void 0,
 		log: process.env.NODE_ENV === "test" ? void 0 : (message) => console.log(message)
-	});
-	if (!hasFile(root, "mdx-components")) writeFileSync(join(root, "mdx-components.tsx"), MDX_COMPONENTS_TEMPLATE);
+	}));
+	if (!hasFile(root, "mdx-components")) writeGeneratedFile(join(root, "mdx-components.tsx"), MDX_COMPONENTS_TEMPLATE);
 	const entry = readDocsEntry(root);
 	const docsPath = normalizeDocsPath(readDocsPath(root), entry);
 	const configuredContentDir = readDocsContentDir(root);
 	const appDir = getNextAppDir(root);
 	const docsContentDir = configuredContentDir ?? join(appDir, entry);
 	const layoutDir = join(root, appDir, entry);
-	if (!existsSync(layoutDir)) mkdirSync(layoutDir, { recursive: true });
+	if (!existsSync(layoutDir)) makeGeneratedDir(layoutDir);
 	const docsLayoutPath = join(layoutDir, "layout.tsx");
-	if (!hasFile(layoutDir, "layout") || isManagedGeneratedFile(docsLayoutPath)) writeFileSync(join(layoutDir, "layout.tsx"), DOCS_LAYOUT_TEMPLATE);
+	if (!hasFile(layoutDir, "layout") || isManagedGeneratedFile(docsLayoutPath)) writeGeneratedFile(join(layoutDir, "layout.tsx"), DOCS_LAYOUT_TEMPLATE);
 	const isStaticExport = nextConfig.output === "export";
 	const docsApiRouteDir = join(root, appDir, "api", "docs");
 	const existingDocsApiRoutePath = FILE_EXTS.map((ext) => join(docsApiRouteDir, `route.${ext}`)).find((filePath) => existsSync(filePath));
 	const docsApiRoutePath = existingDocsApiRoutePath ?? join(docsApiRouteDir, "route.ts");
 	if (!isStaticExport && (!existingDocsApiRoutePath || isManagedGeneratedFile(existingDocsApiRoutePath))) {
-		mkdirSync(docsApiRouteDir, { recursive: true });
-		writeFileSync(docsApiRoutePath, DOCS_API_ROUTE_TEMPLATE);
+		makeGeneratedDir(docsApiRouteDir);
+		writeGeneratedFile(docsApiRoutePath, DOCS_API_ROUTE_TEMPLATE);
 	}
 	const sitemap = readSitemapConfig(root);
 	const robots = readRobotsConfig(root);
 	const docsMcpRouteDir = join(root, appDir, "api", "docs", "mcp");
 	if (mcp.enabled && mcp.route === DEFAULT_MCP_ROUTE && !isStaticExport && !hasFile(docsMcpRouteDir, "route")) {
-		mkdirSync(docsMcpRouteDir, { recursive: true });
-		writeFileSync(join(docsMcpRouteDir, "route.ts"), DOCS_MCP_ROUTE_TEMPLATE);
+		makeGeneratedDir(docsMcpRouteDir);
+		writeGeneratedFile(join(docsMcpRouteDir, "route.ts"), DOCS_MCP_ROUTE_TEMPLATE);
 	}
 	const apiReference = readApiReferenceConfig(root);
 	if (apiReference.enabled && !isStaticExport) {
@@ -1954,19 +2065,19 @@ function withDocs(nextConfig = {}, docsConfig) {
 			removeManagedFile(apiReferenceRoutePath);
 			removeManagedFile(legacyApiReferencePagePath);
 			if (!hasFile(apiReferenceBaseDir, "layout") || isManagedGeneratedFile(apiReferenceLayoutPath)) {
-				mkdirSync(apiReferenceBaseDir, { recursive: true });
-				writeFileSync(apiReferenceLayoutPath, API_REFERENCE_LAYOUT_TEMPLATE);
+				makeGeneratedDir(apiReferenceBaseDir);
+				writeGeneratedFile(apiReferenceLayoutPath, API_REFERENCE_LAYOUT_TEMPLATE);
 			}
 			if (!hasFile(apiReferencePageDir, "page") || isManagedGeneratedFile(apiReferencePagePath)) {
-				mkdirSync(apiReferencePageDir, { recursive: true });
-				writeFileSync(apiReferencePagePath, API_REFERENCE_PAGE_TEMPLATE);
+				makeGeneratedDir(apiReferencePageDir);
+				writeGeneratedFile(apiReferencePagePath, API_REFERENCE_PAGE_TEMPLATE);
 			}
 		} else {
 			removeManagedFile(apiReferenceLayoutPath);
 			removeManagedFile(apiReferencePagePath);
 			if (!hasFile(apiReferenceRouteDir, "route") || isManagedGeneratedFile(apiReferenceRoutePath)) {
-				mkdirSync(apiReferenceRouteDir, { recursive: true });
-				writeFileSync(apiReferenceRoutePath, API_REFERENCE_ROUTE_TEMPLATE);
+				makeGeneratedDir(apiReferenceRouteDir);
+				writeGeneratedFile(apiReferenceRoutePath, API_REFERENCE_ROUTE_TEMPLATE);
 			}
 		}
 	}
@@ -1987,22 +2098,22 @@ function withDocs(nextConfig = {}, docsConfig) {
 			removeManagedFile(join(legacyChangelogBaseDir, "page.tsx"));
 			removeManagedFile(join(legacyChangelogBaseDir, "__changelog.generated.tsx"));
 		}
-		mkdirSync(changelogBaseDir, { recursive: true });
+		makeGeneratedDir(changelogBaseDir);
 		removeManagedFile(join(changelogBaseDir, "__changelog.generated.tsx"));
-		if (!hasFile(changelogBaseDir, "page") || isManagedGeneratedFile(changelogIndexPath)) writeFileSync(changelogIndexPath, buildChangelogIndexPageSource(root, changelogIndexPath, entry, changelog.path, changelogEntries));
+		if (!hasFile(changelogBaseDir, "page") || isManagedGeneratedFile(changelogIndexPath)) writeGeneratedFile(changelogIndexPath, buildChangelogIndexPageSource(root, changelogIndexPath, entry, changelog.path, changelogEntries));
 		if (changelogUsesSourcePagesAsDetails) {
 			removeManagedFile(changelogEntryPath);
 			if (changelogSourceLayoutPath) removeManagedFile(changelogSourceLayoutPath);
 		} else {
 			if (!hasFile(changelogEntryDir, "page") || isManagedGeneratedFile(changelogEntryPath)) {
-				mkdirSync(changelogEntryDir, { recursive: true });
-				writeFileSync(changelogEntryPath, buildChangelogEntryPageSource(root, changelogEntryPath, entry, changelog.path, changelogEntries));
+				makeGeneratedDir(changelogEntryDir);
+				writeGeneratedFile(changelogEntryPath, buildChangelogEntryPageSource(root, changelogEntryPath, entry, changelog.path, changelogEntries));
 			}
 			if (changelogSourceLayoutPath) {
 				const changelogSourceLayoutDir = dirname(changelogSourceLayoutPath);
 				if (!hasFile(changelogSourceLayoutDir, "layout") || isManagedGeneratedFile(changelogSourceLayoutPath)) {
-					mkdirSync(changelogSourceLayoutDir, { recursive: true });
-					writeFileSync(changelogSourceLayoutPath, CHANGELOG_SOURCE_LAYOUT_TEMPLATE);
+					makeGeneratedDir(changelogSourceLayoutDir);
+					writeGeneratedFile(changelogSourceLayoutPath, CHANGELOG_SOURCE_LAYOUT_TEMPLATE);
 				}
 			}
 		}
@@ -2098,15 +2209,12 @@ function withDocs(nextConfig = {}, docsConfig) {
 	};
 	const existingTracingIncludes = nextConfig.outputFileTracingIncludes ?? {};
 	const docsTraceGlob = docsContentDir.replace(/\\/g, "/").replace(/^\.?\//, "") + "/**/*";
-	const skillTraceFile = "skill.md";
-	const agentsTraceFile = "AGENTS.md";
-	const agentTraceFile = "AGENT.md";
 	const sitemapManifestTraceFile = DEFAULT_SITEMAP_MANIFEST_PATH;
 	const docsContentRoot = isAbsolute(docsContentDir) ? docsContentDir : join(root, docsContentDir);
 	if (!isStaticExport) {
 		const existingRewrites = nextConfig.rewrites;
 		nextConfig.rewrites = async () => {
-			return mergeDocsMarkdownRewrites(entry, docsPath, mcp, sitemap, agentFeedback, robots, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
+			return mergeDocsMarkdownRewrites(entry, docsPath, apiReference, mcp, sitemap, agentFeedback, robots, typeof existingRewrites === "function" ? await existingRewrites() : existingRewrites);
 		};
 		const autoRedirects = buildHiddenFolderRedirects(docsContentRoot, docsPath);
 		if (autoRedirects.length > 0) {
@@ -2121,16 +2229,9 @@ function withDocs(nextConfig = {}, docsConfig) {
 		"/api/docs": [...new Set([
 			...existingTracingIncludes["/api/docs"] ?? [],
 			docsTraceGlob,
-			skillTraceFile,
-			agentsTraceFile,
-			agentTraceFile,
 			sitemapManifestTraceFile
 		])],
-		[DEFAULT_MCP_ROUTE]: [...new Set([
-			...existingTracingIncludes[DEFAULT_MCP_ROUTE] ?? [],
-			docsTraceGlob,
-			skillTraceFile
-		])]
+		[DEFAULT_MCP_ROUTE]: [...new Set([...existingTracingIncludes[DEFAULT_MCP_ROUTE] ?? [], docsTraceGlob])]
 	};
 	return withMDX(nextConfig);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/next",
-  "version": "0.2.114",
+  "version": "0.2.116",
   "description": "Next.js adapter for @farming-labs/docs — MDX config wrapper",
   "keywords": [
     "docs",
@@ -109,8 +109,8 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@farming-labs/docs": "0.2.114",
-    "@farming-labs/theme": "0.2.114"
+    "@farming-labs/docs": "0.2.116",
+    "@farming-labs/theme": "0.2.116"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.2.73",