@farming-labs/docs 0.1.62 → 0.1.63

package/dist/cli/index.mjs

@@ -80,7 +80,7 @@ async function main() {
 		const { init } = await import("../init-CcgI3D7-.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-VD41gGZC.mjs");
+		const { dev } = await import("../dev-B_o7hWSI.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "mcp") {
 		const { runMcp } = await import("../mcp-BANLcwQ0.mjs");
@@ -139,7 +139,7 @@ ${pc.dim("Usage:")}
 
 ${pc.dim("Commands:")}
   ${pc.cyan("init")}     Scaffold docs in your project (default)
-  ${pc.cyan("dev")}      Run frameworkless docs locally from ${pc.dim("docs.cloud.json")}
+  ${pc.cyan("dev")}      Run frameworkless docs locally from ${pc.dim("docs.json")}
   ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")} to generate sibling agent.md files)
   ${pc.cyan("doctor")}   Inspect and score agent or reader-facing docs quality
   ${pc.cyan("mcp")}      Run the built-in docs MCP server over stdio

package/dist/{dev-VD41gGZC.mjs → dev-B_o7hWSI.mjs}

@@ -63,7 +63,8 @@ function printDevBanner({ name = "@farming-labs/docs", version = "v0.0.0", port,
 
 //#endregion
 //#region src/cli/dev.ts
-const MANAGED_CONFIG_FILE = "docs.cloud.json";
+const PRIMARY_MANAGED_CONFIG_FILE = "docs.json";
+const LEGACY_MANAGED_CONFIG_FILE = "docs.cloud.json";
 const DEFAULT_RUNTIME_ROOT = ".docs/site";
 const DEFAULT_DOCS_ROOT = "docs";
 const DEFAULT_API_REFERENCE_ROOT = "api-reference";
@@ -426,19 +427,31 @@ function detectNearestPackageManager(startDir) {
 		current = parent;
 	}
 }
+function resolveManagedConfigPath(projectRoot) {
+	const primaryPath = path.join(projectRoot, PRIMARY_MANAGED_CONFIG_FILE);
+	if (fs.existsSync(primaryPath)) return {
+		configPath: primaryPath,
+		configFileName: PRIMARY_MANAGED_CONFIG_FILE
+	};
+	const legacyPath = path.join(projectRoot, LEGACY_MANAGED_CONFIG_FILE);
+	if (fs.existsSync(legacyPath)) return {
+		configPath: legacyPath,
+		configFileName: LEGACY_MANAGED_CONFIG_FILE
+	};
+	throw new Error(`Could not find ${PRIMARY_MANAGED_CONFIG_FILE} in ${projectRoot}. Frameworkless dev expects ${PRIMARY_MANAGED_CONFIG_FILE}, ${DEFAULT_DOCS_ROOT}/, and optionally ${DEFAULT_API_REFERENCE_ROOT}/. ${LEGACY_MANAGED_CONFIG_FILE} is still supported for older repos.`);
+}
 function readManagedDocsProject(projectRoot) {
-	const configPath = path.join(projectRoot, MANAGED_CONFIG_FILE);
-	if (!fs.existsSync(configPath)) throw new Error(`Could not find ${MANAGED_CONFIG_FILE} in ${projectRoot}. Frameworkless dev expects ${MANAGED_CONFIG_FILE}, ${DEFAULT_DOCS_ROOT}/, and optionally ${DEFAULT_API_REFERENCE_ROOT}/.`);
+	const { configPath, configFileName } = resolveManagedConfigPath(projectRoot);
 	let parsedJson;
 	try {
 		parsedJson = JSON.parse(fs.readFileSync(configPath, "utf-8"));
 	} catch (error) {
-		throw new Error(`Could not parse ${MANAGED_CONFIG_FILE}. The file must be valid JSON.${error instanceof Error ? ` ${error.message}` : ""}`);
+		throw new Error(`Could not parse ${configFileName}. The file must be valid JSON.${error instanceof Error ? ` ${error.message}` : ""}`);
 	}
 	const parsed = managedConfigSchema.safeParse(parsedJson);
-	if (!parsed.success) throw new Error(`Invalid ${MANAGED_CONFIG_FILE}: ${formatZodError(parsed.error)}`);
+	if (!parsed.success) throw new Error(`Invalid ${configFileName}: ${formatZodError(parsed.error)}`);
 	const docsConfig = parsed.data.docs;
-	if (("mode" in docsConfig ? docsConfig.mode : docsConfig.framework === "managed" ? "frameworkless" : "framework") !== "frameworkless") throw new Error(`${MANAGED_CONFIG_FILE} uses docs.mode = "framework". ${pc.cyan("docs dev")} only supports frameworkless projects right now.`);
+	if (("mode" in docsConfig ? docsConfig.mode : docsConfig.framework === "managed" ? "frameworkless" : "framework") !== "frameworkless") throw new Error(`${configFileName} uses docs.mode = "framework". ${pc.cyan("docs dev")} only supports frameworkless projects right now.`);
 	const runtimeFramework = "runtime" in docsConfig && docsConfig.runtime ? docsConfig.runtime : "nextjs";
 	if (runtimeFramework !== "nextjs") throw new Error(`Frameworkless ${pc.cyan("docs dev")} currently supports only docs.runtime = "nextjs".`);
 	const docsRoot = parsed.data.content?.docsRoot ?? DEFAULT_DOCS_ROOT;
@@ -452,6 +465,7 @@ function readManagedDocsProject(projectRoot) {
 	const theme = resolveThemePreset(parsed.data.theme?.preset);
 	return {
 		configPath,
+		configFileName,
 		projectRoot,
 		runtimeDir,
 		runtimeFramework,
@@ -665,7 +679,7 @@ function validateManagedOpenApiSpec(project) {
 	if (!sourcePath) return;
 	if (!fs.existsSync(sourcePath) || !fs.statSync(sourcePath).isFile()) {
 		const relativePath = path.relative(project.projectRoot, sourcePath) || sourcePath;
-		throw new Error(`OpenAPI source not found at ${relativePath}. Update ${MANAGED_CONFIG_FILE} or add the spec file and try again.`);
+		throw new Error(`OpenAPI source not found at ${relativePath}. Update ${project.configFileName} or add the spec file and try again.`);
 	}
 }
 function renderAlternateSectionLayout(configImportPath) {
@@ -895,7 +909,7 @@ function materializeManagedRuntime(projectRoot) {
 	const hasDocsMarkdown = directoryHasMarkdown(docsSourceDir);
 	const hasApiReferenceMarkdown = directoryHasMarkdown(apiReferenceSourceDir);
 	validateManagedOpenApiSpec(project);
-	if (!hasDocsMarkdown && !hasApiReferenceMarkdown && !hasOpenApiSpec) throw new Error(`No docs content found. Add markdown files under ${project.docsRoot}/ or ${project.apiReferenceRoot}/, or point content.openapi at an OpenAPI file in ${MANAGED_CONFIG_FILE}.`);
+	if (!hasDocsMarkdown && !hasApiReferenceMarkdown && !hasOpenApiSpec) throw new Error(`No docs content found. Add markdown files under ${project.docsRoot}/ or ${project.apiReferenceRoot}/, or point content.openapi at an OpenAPI file in ${project.configFileName}.`);
 	const templateConfig = {
 		entry: "docs",
 		theme: project.theme.templateTheme,
@@ -1140,9 +1154,9 @@ async function dev(options = {}) {
 	const runtimeInstallStamp = getRuntimeInstallStamp(project);
 	console.log(pc.dim("Preparing local preview..."));
 	if (options.verbose) {
-		logLine("source", `${pc.cyan(MANAGED_CONFIG_FILE)} drives ${pc.cyan(`${project.docsRoot}/`)} and ${pc.cyan(`${project.apiReferenceRoot}/`)}`);
+		logLine("source", `${pc.cyan(project.configFileName)} drives ${pc.cyan(`${project.docsRoot}/`)} and ${pc.cyan(`${project.apiReferenceRoot}/`)}`);
 		logLine("runtime", `Generated runtime at ${pc.cyan(path.relative(projectRoot, project.runtimeDir) || project.runtimeDir)}`);
-		logLine("watch", `Watching ${project.docsRoot}/, ${project.apiReferenceRoot}/, and ${MANAGED_CONFIG_FILE}`);
+		logLine("watch", `Watching ${project.docsRoot}/, ${project.apiReferenceRoot}/, and ${project.configFileName}`);
 		logLine("sync", `Loaded ${initial.docs.pageCount} docs page${initial.docs.pageCount === 1 ? "" : "s"} and ${initial.apiReference.pageCount} api-reference page${initial.apiReference.pageCount === 1 ? "" : "s"}`);
 	}
 	if (!fs.existsSync(runtimeNodeModules) || !fs.existsSync(runtimeInstallMarker) || fs.readFileSync(runtimeInstallMarker, "utf-8") !== runtimeInstallStamp) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.62",
+  "version": "0.1.63",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",