@farming-labs/next 0.2.114 → 0.2.115

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). */
@@ -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 {
@@ -1910,36 +1954,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 +1998,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 +2031,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,9 +2142,6 @@ 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) {
@@ -2121,16 +2162,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.115",
   "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.115",
+    "@farming-labs/theme": "0.2.115"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.2.73",