@farming-labs/docs 0.2.120 → 0.2.121

package/dist/{agent-evals-BLNLvXbG.mjs → agent-evals.mjs}

@@ -1,570 +1,12 @@
-import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-9Oxr33b-.mjs";
-import { $t as buildDocsAskAIContext, An as agentVersionConstraintMatches, Fn as normalizeAgentVersion, Mn as normalizeAgentFramework, Nn as normalizeAgentLocale, Pn as normalizeAgentScopeValues, Sn as resolveSearchRequestConfig, fn as normalizeDocsSearchFilters, jn as agentVersionConstraintsOverlap, kn as agentVersionConstraintGroupsOverlap, pn as performDocsSearch, tn as buildDocsRetrievalDigestProjection } from "./agent-DkAidqtV.mjs";
-import { n as digestDocsRetrievalContent } from "./retrieval-digest-CT-eIEcp.mjs";
-import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-BC7md56k.mjs";
+import { upsertPageAgentContractMarkdown } from "./agent-contract.mjs";
+import { findDocsMarkdownSection, stripDocsGeneratedAgentContractMarkers } from "./markdown-sections.mjs";
+import { digestDocsRetrievalContent } from "./retrieval-digest.mjs";
+import { agentVersionConstraintGroupsOverlap, agentVersionConstraintMatches, agentVersionConstraintsOverlap, normalizeAgentFramework, normalizeAgentLocale, normalizeAgentScopeValues, normalizeAgentVersion } from "./agent-scope.mjs";
+import { buildDocsAskAIContext, buildDocsRetrievalDigestProjection, normalizeDocsSearchFilters, performDocsSearch, resolveSearchRequestConfig } from "./search.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
-import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-GYdvS3BH.mjs";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join, relative } from "node:path";
+import { extractCodeBlocksFromMarkdown, planCodeBlockTargets, resolveDocsCodeBlocksValidateConfig, validateCodeBlockPlans } from "./code-blocks.mjs";
 import { createJiti } from "jiti";
 
-//#region src/review.ts
-const DEFAULT_DOCS_REVIEW_WORKFLOW_PATH = ".github/workflows/docs-review.yml";
-const DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW_PATH = ".github/workflows/docs-review-reusable.yml";
-const DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW = "farming-labs/docs/.github/workflows/docs-review-reusable.yml@main";
-const LOCAL_DOCS_REVIEW_REUSABLE_WORKFLOW = "./.github/workflows/docs-review-reusable.yml";
-const DEFAULT_DOCS_REVIEW_PNPM_VERSION = "10";
-const DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD = 80;
-const DEFAULT_DOCS_REVIEW_CI_NAME = "docs-review";
-const DEFAULT_REVIEW_RULES = {
-	brokenLinks: "error",
-	frontmatter: "error",
-	duplicateSlugs: "error",
-	invalidMdx: "error",
-	configExamples: "warn",
-	codeFenceMetadata: "warn",
-	runnableMetadata: "warn",
-	agentContext: "warn",
-	commandHealth: "warn",
-	relatedCoverage: "suggestion",
-	configConfidence: "warn",
-	agentSurfaceDrift: "error",
-	goldenTasks: "warn",
-	agentSkills: "warn"
-};
-const DEFAULT_REVIEW_WEIGHTS = {
-	error: 20,
-	warn: 8,
-	suggestion: 2
-};
-const REVIEW_SEVERITIES = new Set([
-	"off",
-	"suggestion",
-	"warn",
-	"error"
-]);
-const REVIEW_CI_MODES = new Set([
-	"off",
-	"warn",
-	"block"
-]);
-const FILE_EXTS = [
-	"tsx",
-	"ts",
-	"jsx",
-	"js"
-];
-function resolveDocsReviewConfig(review) {
-	if (review === false) return {
-		enabled: false,
-		ci: {
-			enabled: false,
-			name: DEFAULT_DOCS_REVIEW_CI_NAME,
-			mode: "off",
-			annotations: false,
-			comment: false
-		},
-		score: {
-			threshold: DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD,
-			weights: DEFAULT_REVIEW_WEIGHTS
-		},
-		rules: DEFAULT_REVIEW_RULES
-	};
-	const objectConfig = review && typeof review === "object" ? review : {};
-	const ciConfig = objectConfig.ci;
-	const ciObject = ciConfig && typeof ciConfig === "object" ? ciConfig : {};
-	const configuredMode = ciObject.mode;
-	const mode = configuredMode && REVIEW_CI_MODES.has(configuredMode) ? configuredMode : "warn";
-	const enabled = objectConfig.enabled !== false;
-	const ciEnabled = enabled && ciConfig !== false && ciObject.enabled !== false && mode !== "off";
-	return {
-		enabled,
-		ci: {
-			enabled: ciEnabled,
-			name: normalizeCiName(ciObject.name),
-			mode: ciEnabled ? mode : "off",
-			annotations: ciObject.annotations !== false,
-			comment: ciObject.comment !== false
-		},
-		score: {
-			threshold: clampScoreThreshold(objectConfig.score?.threshold),
-			weights: {
-				error: normalizeWeight(objectConfig.score?.weights?.error, DEFAULT_REVIEW_WEIGHTS.error),
-				warn: normalizeWeight(objectConfig.score?.weights?.warn, DEFAULT_REVIEW_WEIGHTS.warn),
-				suggestion: normalizeWeight(objectConfig.score?.weights?.suggestion, DEFAULT_REVIEW_WEIGHTS.suggestion)
-			}
-		},
-		rules: {
-			...DEFAULT_REVIEW_RULES,
-			...normalizeRules(objectConfig.rules)
-		}
-	};
-}
-function buildDocsReviewWorkflow(options = {}) {
-	const packageManager = options.packageManager ?? "npm";
-	const ciName = normalizeCiName(options.ciName);
-	const projectDir = normalizeProjectDir(options.projectDir);
-	const configPath = options.configPath ?? "docs.config.ts";
-	const reusableWorkflow = options.reusableWorkflow ?? DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW;
-	const filters = normalizePathFilters(options.pathFilters);
-	const workflowInputs = [
-		["check-name", ciName],
-		["config", configPath],
-		["working-directory", projectDir],
-		["package-manager", packageManager],
-		options.pnpmVersion ? ["pnpm-version", options.pnpmVersion] : void 0,
-		options.buildCommand ? ["build-command", options.buildCommand] : void 0,
-		options.reviewCommand ? ["review-command", options.reviewCommand] : void 0
-	].filter((input) => Boolean(input)).map(([key, value]) => `      ${key}: ${JSON.stringify(value)}`).join("\n");
-	return `# Generated by @farming-labs/docs. You can edit this file.
-name: Docs Review
-
-on:
-  pull_request:
-    paths:
-${filters.map((filter) => `      - ${JSON.stringify(filter)}`).join("\n")}
-
-permissions:
-  contents: read
-  checks: write
-  pull-requests: write
-
-jobs:
-  docs-review:
-    name: ${JSON.stringify(ciName)}
-    uses: ${reusableWorkflow}
-    with:
-${workflowInputs}
-    permissions:
-      contents: read
-      checks: write
-      pull-requests: write
-`;
-}
-function ensureDocsReviewWorkflow(options) {
-	const rootDir = options.rootDir;
-	const repoRoot = findGitRoot(rootDir) ?? rootDir;
-	const workflowRelativePath = options.workflowPath ?? DEFAULT_DOCS_REVIEW_WORKFLOW_PATH;
-	const workflowPath = isAbsolute(workflowRelativePath) ? workflowRelativePath : join(repoRoot, workflowRelativePath);
-	const resultRelativePath = toPosixPath(relative(repoRoot, workflowPath));
-	const review = resolveDocsReviewConfig(options.config?.review ?? readDocsReviewConfigFromSource(options.configContent ?? readConfig(rootDir)));
-	if (!review.enabled || !review.ci.enabled) return {
-		status: "disabled",
-		path: workflowPath,
-		relativePath: resultRelativePath
-	};
-	if (existsSync(workflowPath)) return {
-		status: "exists",
-		path: workflowPath,
-		relativePath: resultRelativePath
-	};
-	const configPath = options.configPath ?? findDocsConfigPath(rootDir);
-	const configContent = options.configContent ?? readConfig(rootDir, configPath);
-	const projectDir = toPosixPath(relative(repoRoot, rootDir)) || ".";
-	const packageManager = detectPackageManager(repoRoot);
-	const workflow = buildDocsReviewWorkflow({
-		packageManager,
-		ciName: review.ci.name,
-		reusableWorkflow: hasLocalDocsWorkspacePackage(repoRoot) ? LOCAL_DOCS_REVIEW_REUSABLE_WORKFLOW : DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW,
-		pnpmVersion: detectPnpmVersionFallback(repoRoot, packageManager),
-		projectDir,
-		configPath,
-		buildCommand: detectLocalDocsCliBuildCommand(repoRoot, packageManager),
-		reviewCommand: detectLocalDocsCliReviewCommand(repoRoot, rootDir),
-		pathFilters: buildDocsReviewWorkflowPathFilters({
-			rootDir,
-			repoRoot,
-			config: options.config,
-			configPath,
-			configContent
-		})
-	});
-	mkdirSync(dirname(workflowPath), { recursive: true });
-	writeFileSync(workflowPath, workflow, "utf-8");
-	options.log?.(`[docs] Created ${resultRelativePath} for Docs Review CI.`);
-	return {
-		status: "created",
-		path: workflowPath,
-		relativePath: resultRelativePath
-	};
-}
-function readDocsReviewConfigFromSource(content) {
-	if (!content) return void 0;
-	const rootObject = extractRootObjectLiteral(content) ?? content;
-	const reviewCursor = findTopLevelPropertyValueIndex(rootObject, "review");
-	if (reviewCursor === void 0) return void 0;
-	if (rootObject.startsWith("true", reviewCursor)) return true;
-	if (rootObject.startsWith("false", reviewCursor)) return false;
-	if (rootObject[reviewCursor] !== "{") return void 0;
-	const reviewEnd = findMatchingObjectEnd(rootObject, reviewCursor);
-	if (reviewEnd === void 0) return void 0;
-	const reviewBlock = rootObject.slice(reviewCursor + 1, reviewEnd);
-	const scoreBlock = extractTopLevelObjectLiteral(reviewBlock, "score");
-	const ciCursor = findTopLevelPropertyValueIndex(reviewBlock, "ci");
-	const rulesBlock = extractTopLevelObjectLiteral(reviewBlock, "rules");
-	const ci = ciCursor === void 0 ? void 0 : reviewBlock.startsWith("true", ciCursor) ? true : reviewBlock.startsWith("false", ciCursor) ? false : reviewBlock[ciCursor] === "{" ? readReviewCiObject(reviewBlock, ciCursor) : void 0;
-	return {
-		enabled: readTopLevelBoolean(reviewBlock, "enabled"),
-		score: scoreBlock ? {
-			threshold: readTopLevelNumber(scoreBlock, "threshold"),
-			weights: readReviewWeights(scoreBlock)
-		} : void 0,
-		ci,
-		rules: rulesBlock ? readReviewRules(rulesBlock) : void 0
-	};
-}
-function buildDocsReviewWorkflowPathFilters(options) {
-	const repoRoot = options.repoRoot ?? findGitRoot(options.rootDir) ?? options.rootDir;
-	const configPath = options.configPath ?? findDocsConfigPath(options.rootDir);
-	const configContent = options.configContent ?? readConfig(options.rootDir, configPath);
-	const entry = options.config?.entry ?? readTopLevelString(configContent, "entry") ?? "docs";
-	const contentDir = options.config?.contentDir ?? readTopLevelString(configContent, "contentDir");
-	const projectDir = toPosixPath(relative(repoRoot, options.rootDir));
-	const projectPrefix = projectDir && projectDir !== "." ? `${projectDir}/` : "";
-	const candidates = [
-		prefixPath(projectPrefix, configPath),
-		prefixPath(projectPrefix, `${entry}/**`),
-		prefixPath(projectPrefix, `app/${entry}/**`),
-		prefixPath(projectPrefix, `src/app/${entry}/**`),
-		contentDir ? prefixPath(projectPrefix, `${trimSlashes(contentDir)}/**`) : void 0,
-		prefixPath(projectPrefix, "content/docs/**"),
-		prefixPath(projectPrefix, "src/content/docs/**"),
-		prefixPath(projectPrefix, "src/lib/docs.config.*"),
-		DEFAULT_DOCS_REVIEW_WORKFLOW_PATH,
-		DEFAULT_DOCS_REVIEW_REUSABLE_WORKFLOW_PATH,
-		...buildAgentSkillPathFilters({
-			rootDir: options.rootDir,
-			repoRoot,
-			skills: options.config?.agent?.skills
-		})
-	];
-	return Array.from(new Set(candidates.filter((candidate) => Boolean(candidate))));
-}
-function buildAgentSkillPathFilters(options) {
-	return getDocsAgentSkillsConfiguredPaths(options.skills).map((configuredPath) => {
-		const absolutePath = isAbsolute(configuredPath) ? configuredPath : join(options.rootDir, configuredPath);
-		const repoRelative = toPosixPath(relative(options.repoRoot, absolutePath));
-		if (!repoRelative || repoRelative.startsWith("../")) return void 0;
-		return repoRelative.endsWith("/SKILL.md") || repoRelative === "SKILL.md" ? repoRelative : `${repoRelative.replace(/\/+$/u, "")}/**`;
-	}).filter((candidate) => Boolean(candidate));
-}
-function normalizeRules(rules) {
-	if (!rules) return {};
-	const knownRules = new Set(Object.keys(DEFAULT_REVIEW_RULES));
-	return Object.fromEntries(Object.entries(rules).filter((entry) => knownRules.has(entry[0]) && REVIEW_SEVERITIES.has(entry[1])));
-}
-function normalizeWeight(value, fallback) {
-	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : fallback;
-}
-function normalizeCiName(value) {
-	return value?.trim() || DEFAULT_DOCS_REVIEW_CI_NAME;
-}
-function clampScoreThreshold(value) {
-	if (typeof value !== "number" || !Number.isFinite(value)) return DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD;
-	return Math.min(100, Math.max(0, Math.round(value)));
-}
-function readReviewCiObject(source, cursor) {
-	const end = findMatchingObjectEnd(source, cursor);
-	if (end === void 0) return void 0;
-	const block = source.slice(cursor + 1, end);
-	const mode = readTopLevelString(block, "mode");
-	return {
-		enabled: readTopLevelBoolean(block, "enabled"),
-		name: readTopLevelString(block, "name"),
-		mode: mode && REVIEW_CI_MODES.has(mode) ? mode : void 0,
-		annotations: readTopLevelBoolean(block, "annotations"),
-		comment: readTopLevelBoolean(block, "comment")
-	};
-}
-function readReviewRules(block) {
-	const rules = {};
-	for (const key of Object.keys(DEFAULT_REVIEW_RULES)) {
-		const value = readTopLevelString(block, key);
-		if (value && REVIEW_SEVERITIES.has(value)) rules[key] = value;
-	}
-	return rules;
-}
-function readReviewWeights(block) {
-	const weightsBlock = extractTopLevelObjectLiteral(block, "weights");
-	if (!weightsBlock) return void 0;
-	return {
-		error: readTopLevelNumber(weightsBlock, "error"),
-		warn: readTopLevelNumber(weightsBlock, "warn"),
-		suggestion: readTopLevelNumber(weightsBlock, "suggestion")
-	};
-}
-function detectPackageManager(rootDir) {
-	if (existsSync(join(rootDir, "pnpm-lock.yaml"))) return "pnpm";
-	if (existsSync(join(rootDir, "yarn.lock"))) return "yarn";
-	if (existsSync(join(rootDir, "bun.lock")) || existsSync(join(rootDir, "bun.lockb"))) return "bun";
-	return "npm";
-}
-function detectLocalDocsCliBuildCommand(repoRoot, packageManager) {
-	if (!hasLocalDocsWorkspacePackage(repoRoot)) return void 0;
-	if (packageManager === "pnpm") return "pnpm --filter @farming-labs/docs run build";
-	if (packageManager === "yarn") return "yarn workspace @farming-labs/docs build";
-	if (packageManager === "bun") return "bun run --filter @farming-labs/docs build";
-	return "npm run build --workspace=@farming-labs/docs";
-}
-function detectPnpmVersionFallback(repoRoot, packageManager) {
-	if (packageManager !== "pnpm") return void 0;
-	try {
-		if (JSON.parse(readFileSync(join(repoRoot, "package.json"), "utf-8")).packageManager?.startsWith("pnpm@")) return void 0;
-	} catch {}
-	return DEFAULT_DOCS_REVIEW_PNPM_VERSION;
-}
-function detectLocalDocsCliReviewCommand(repoRoot, rootDir) {
-	if (!hasLocalDocsWorkspacePackage(repoRoot)) return void 0;
-	return `node ${shellQuote(toPosixPath(relative(rootDir, join(repoRoot, "packages", "docs", "dist", "cli", "index.mjs"))) || "./packages/docs/dist/cli/index.mjs")}`;
-}
-function hasLocalDocsWorkspacePackage(repoRoot) {
-	const packageJsonPath = join(repoRoot, "packages", "docs", "package.json");
-	if (!existsSync(packageJsonPath)) return false;
-	try {
-		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-		return packageJson.name === "@farming-labs/docs" && Boolean(packageJson.scripts?.build);
-	} catch {
-		return false;
-	}
-}
-function shellQuote(value) {
-	if (/^[A-Za-z0-9_./:-]+$/.test(value)) return value;
-	return `'${value.replaceAll("'", "'\\''")}'`;
-}
-function normalizeProjectDir(value) {
-	if (!value || value === "") return ".";
-	return toPosixPath(value).replace(/\/+$/, "") || ".";
-}
-function normalizePathFilters(filters) {
-	const normalized = (filters && filters.length > 0 ? filters : ["docs.config.*", "app/docs/**"]).map((filter) => toPosixPath(filter).replace(/^\.\/+/, "")).filter(Boolean);
-	return Array.from(new Set(normalized));
-}
-function findGitRoot(start) {
-	let current = start;
-	while (true) {
-		if (existsSync(join(current, ".git"))) return current;
-		const parent = dirname(current);
-		if (parent === current) return void 0;
-		current = parent;
-	}
-}
-function findDocsConfigPath(rootDir) {
-	for (const ext of FILE_EXTS) {
-		const path = `docs.config.${ext}`;
-		if (existsSync(join(rootDir, path))) return path;
-	}
-	return "docs.config.ts";
-}
-function readConfig(rootDir, configPath = findDocsConfigPath(rootDir)) {
-	const fullPath = join(rootDir, configPath);
-	if (!existsSync(fullPath)) return void 0;
-	try {
-		return readFileSync(fullPath, "utf-8");
-	} catch {
-		return;
-	}
-}
-function prefixPath(prefix, value) {
-	return `${prefix}${toPosixPath(value).replace(/^\.\/+/, "")}`;
-}
-function trimSlashes(value) {
-	return toPosixPath(value).replace(/^\/+|\/+$/g, "");
-}
-function toPosixPath(value) {
-	return value.replaceAll("\\", "/");
-}
-function extractRootObjectLiteral(content) {
-	const candidateIndexes = [content.search(/\bdefineDocs\s*\(/), content.search(/\bexport\s+default\b/)].filter((value) => value !== -1);
-	for (const startIndex of candidateIndexes) {
-		const braceStart = content.indexOf("{", startIndex);
-		if (braceStart === -1) continue;
-		const braceEnd = findMatchingObjectEnd(content, braceStart);
-		if (braceEnd !== void 0) return content.slice(braceStart + 1, braceEnd);
-	}
-}
-function extractTopLevelObjectLiteral(content, key) {
-	const cursor = findTopLevelPropertyValueIndex(content, key);
-	if (cursor === void 0 || content[cursor] !== "{") return void 0;
-	const end = findMatchingObjectEnd(content, cursor);
-	return end === void 0 ? void 0 : content.slice(cursor + 1, end);
-}
-function readTopLevelBoolean(content, key) {
-	const cursor = findTopLevelPropertyValueIndex(content, key);
-	if (cursor === void 0) return void 0;
-	if (content.startsWith("true", cursor)) return true;
-	if (content.startsWith("false", cursor)) return false;
-}
-function readTopLevelNumber(content, key) {
-	const cursor = findTopLevelPropertyValueIndex(content, key);
-	if (cursor === void 0) return void 0;
-	const match = content.slice(cursor).match(/^-?\d+(?:\.\d+)?/);
-	if (!match) return void 0;
-	const value = Number(match[0]);
-	return Number.isFinite(value) ? value : void 0;
-}
-function readTopLevelString(content, key) {
-	if (!content) return void 0;
-	const cursor = findTopLevelPropertyValueIndex(content, key);
-	if (cursor === void 0) return void 0;
-	const quote = content[cursor];
-	if (quote !== "\"" && quote !== "'") return void 0;
-	let value = "";
-	for (let index = cursor + 1; index < content.length; index += 1) {
-		const char = content[index];
-		if (char === "\\") {
-			const escaped = content[index + 1];
-			if (escaped) {
-				value += escaped;
-				index += 1;
-			}
-			continue;
-		}
-		if (char === quote) return value;
-		value += char;
-	}
-}
-function findTopLevelPropertyValueIndex(block, key) {
-	let objectDepth = 0;
-	let arrayDepth = 0;
-	let parenDepth = 0;
-	let inString = null;
-	let inLineComment = false;
-	let inBlockComment = false;
-	let escaped = false;
-	for (let index = 0; index < block.length; index += 1) {
-		const char = block[index];
-		const next = block[index + 1];
-		if (inLineComment) {
-			if (char === "\n") inLineComment = false;
-			continue;
-		}
-		if (inBlockComment) {
-			if (char === "*" && next === "/") {
-				inBlockComment = false;
-				index += 1;
-			}
-			continue;
-		}
-		if (inString) {
-			if (escaped) {
-				escaped = false;
-				continue;
-			}
-			if (char === "\\") {
-				escaped = true;
-				continue;
-			}
-			if (char === inString) inString = null;
-			continue;
-		}
-		if (char === "/" && next === "/") {
-			inLineComment = true;
-			index += 1;
-			continue;
-		}
-		if (char === "/" && next === "*") {
-			inBlockComment = true;
-			index += 1;
-			continue;
-		}
-		if (char === "\"" || char === "'" || char === "`") {
-			inString = char;
-			continue;
-		}
-		if (char === "{") {
-			objectDepth += 1;
-			continue;
-		}
-		if (char === "}") {
-			objectDepth = Math.max(0, objectDepth - 1);
-			continue;
-		}
-		if (char === "[") {
-			arrayDepth += 1;
-			continue;
-		}
-		if (char === "]") {
-			arrayDepth = Math.max(0, arrayDepth - 1);
-			continue;
-		}
-		if (char === "(") {
-			parenDepth += 1;
-			continue;
-		}
-		if (char === ")") {
-			parenDepth = Math.max(0, parenDepth - 1);
-			continue;
-		}
-		if (objectDepth !== 0 || arrayDepth !== 0 || parenDepth !== 0) continue;
-		if (!block.startsWith(key, index)) continue;
-		const before = block[index - 1] ?? "";
-		const after = block[index + key.length] ?? "";
-		if (/[A-Za-z0-9_$]/.test(before) || /[A-Za-z0-9_$]/.test(after)) continue;
-		let cursor = index + key.length;
-		while (/\s/.test(block[cursor] ?? "")) cursor += 1;
-		if (block[cursor] !== ":") continue;
-		cursor += 1;
-		while (/\s/.test(block[cursor] ?? "")) cursor += 1;
-		return cursor;
-	}
-}
-function findMatchingObjectEnd(block, start) {
-	let depth = 0;
-	let inString = null;
-	let inLineComment = false;
-	let inBlockComment = false;
-	let escaped = false;
-	for (let index = start; index < block.length; index += 1) {
-		const char = block[index];
-		const next = block[index + 1];
-		if (inLineComment) {
-			if (char === "\n") inLineComment = false;
-			continue;
-		}
-		if (inBlockComment) {
-			if (char === "*" && next === "/") {
-				inBlockComment = false;
-				index += 1;
-			}
-			continue;
-		}
-		if (inString) {
-			if (escaped) {
-				escaped = false;
-				continue;
-			}
-			if (char === "\\") {
-				escaped = true;
-				continue;
-			}
-			if (char === inString) inString = null;
-			continue;
-		}
-		if (char === "/" && next === "/") {
-			inLineComment = true;
-			index += 1;
-			continue;
-		}
-		if (char === "/" && next === "*") {
-			inBlockComment = true;
-			index += 1;
-			continue;
-		}
-		if (char === "\"" || char === "'" || char === "`") {
-			inString = char;
-			continue;
-		}
-		if (char === "{") {
-			depth += 1;
-			continue;
-		}
-		if (char !== "}") continue;
-		depth -= 1;
-		if (depth === 0) return index;
-	}
-}
-
-//#endregion
 //#region src/agent-evals.ts
 const DEFAULT_TOP_K = 5;
 const DEFAULT_TOKEN_BUDGET = 4e3;
@@ -2655,4 +2097,4 @@ async function runDocsGoldenTasks(pages, tasks, options = {}) {
 }
 
 //#endregion
-export { buildDocsReviewWorkflowPathFilters as a, resolveDocsReviewConfig as c, buildDocsReviewWorkflow as i, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD as n, ensureDocsReviewWorkflow as o, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH as r, readDocsReviewConfigFromSource as s, runDocsGoldenTasks as t };
+export { runDocsGoldenTasks };

package/dist/agent-feedback-evaluations-node.mjs

@@ -0,0 +1,38 @@
+import { DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT } from "./agent-feedback-evaluations.mjs";
+import { readFileSync } from "node:fs";
+
+//#region src/agent-feedback-evaluations-node.ts
+function isRecord(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readJsonFile(filePath) {
+	return JSON.parse(readFileSync(filePath, "utf8"));
+}
+function readDocsAgentFeedbackImprovementReport(filePath) {
+	const value = readJsonFile(filePath);
+	if (!isRecord(value) || value.format !== "farming-labs-agent-feedback-improvements.v1" || !Array.isArray(value.clusters) || typeof value.feedbackCount !== "number" || typeof value.recurringClusterCount !== "number") throw new Error("Input is not a supported agent feedback improvement report.");
+	return value;
+}
+function readDocsAgentEvaluationTasksFile(filePath) {
+	const value = readJsonFile(filePath);
+	if (Array.isArray(value)) return value;
+	if (!isRecord(value)) throw new Error("Existing evaluation tasks must be a JSON object or array.");
+	if (Array.isArray(value.candidates)) return value.candidates.flatMap((candidate) => isRecord(candidate) && isRecord(candidate.task) ? [candidate.task] : []);
+	if (Array.isArray(value.tasks)) return value.tasks;
+	if (isRecord(value.agent) && isRecord(value.agent.evaluations) && Array.isArray(value.agent.evaluations.tasks)) return value.agent.evaluations.tasks;
+	throw new Error("Could not find evaluation tasks in the existing JSON file.");
+}
+function readDocsGoldenTasksReportFile(filePath) {
+	const value = readJsonFile(filePath);
+	const report = isRecord(value) && isRecord(value.evaluations) ? value.evaluations : value;
+	if (!isRecord(report) || !Array.isArray(report.tasks) || typeof report.taskCount !== "number" || !(typeof report.score === "number" || report.score === null)) throw new Error("Input does not contain a golden-task evaluation report.");
+	return report;
+}
+function readDocsAgentFeedbackEvaluationBaseline(filePath) {
+	const value = readJsonFile(filePath);
+	if (!isRecord(value) || value.format !== DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT || typeof value.score !== "number" || !Array.isArray(value.tasks)) throw new Error("Evaluation baseline format is not supported.");
+	return value;
+}
+
+//#endregion
+export { readDocsAgentEvaluationTasksFile, readDocsAgentFeedbackEvaluationBaseline, readDocsAgentFeedbackImprovementReport, readDocsGoldenTasksReportFile };