@farming-labs/docs 0.1.53 → 0.1.54

package/dist/{agent-C3rj3o1l.mjs → agent-B-6iQbS2.mjs}

@@ -9,6 +9,7 @@ import matter from "gray-matter";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
+import { execFileSync } from "node:child_process";
 
 //#region src/cli/agent.ts
 const DEFAULT_TTC_BASE_URL = "https://api.thetokencompany.com";
@@ -50,6 +51,10 @@ function parseAgentCompactArgs(argv) {
 			parsed.dryRun = true;
 			continue;
 		}
+		if (arg === "--changed") {
+			parsed.changed = true;
+			continue;
+		}
 		if (arg === "--stale") {
 			parsed.stale = true;
 			continue;
@@ -175,6 +180,62 @@ function resolveCompressionEndpoint(rawBaseUrl) {
 	if (/\/v1\/compress\/?$/i.test(baseUrl)) return baseUrl.replace(/\/+$/, "");
 	return `${baseUrl.replace(/\/+$/, "")}/v1/compress`;
 }
+function runGitCommand(rootDir, args) {
+	return execFileSync("git", args, {
+		cwd: rootDir,
+		encoding: "utf-8"
+	}).trim();
+}
+function normalizeGitRelativePath(value) {
+	return value.replace(/\\/g, "/").replace(/^\.\/+/, "").replace(/^\/+/, "");
+}
+function listGitChangedFiles(rootDir, contentDir) {
+	let gitRoot;
+	try {
+		gitRoot = runGitCommand(rootDir, ["rev-parse", "--show-toplevel"]);
+	} catch {
+		throw new Error("Use --changed inside a git repository.");
+	}
+	const contentDirAbs = path.resolve(rootDir, contentDir);
+	const relativeContentDir = normalizeGitRelativePath(path.relative(gitRoot, contentDirAbs));
+	if (relativeContentDir.startsWith("../")) throw new Error("Configured contentDir must live inside the current git repository for --changed.");
+	const pathspec = relativeContentDir || ".";
+	const changedFiles = /* @__PURE__ */ new Set();
+	const commands = [
+		[
+			"diff",
+			"--name-only",
+			"--",
+			pathspec
+		],
+		[
+			"diff",
+			"--name-only",
+			"--cached",
+			"--",
+			pathspec
+		],
+		[
+			"ls-files",
+			"--others",
+			"--exclude-standard",
+			"--",
+			pathspec
+		]
+	];
+	for (const args of commands) {
+		const output = runGitCommand(gitRoot, args);
+		if (!output) continue;
+		for (const line of output.split("\n")) {
+			const normalized = normalizeGitRelativePath(line.trim());
+			if (!normalized) continue;
+			const absolutePath = path.resolve(gitRoot, normalized);
+			const relativeToRoot = normalizeGitRelativePath(path.relative(rootDir, absolutePath));
+			if (relativeToRoot && !relativeToRoot.startsWith("../")) changedFiles.add(relativeToRoot);
+		}
+	}
+	return changedFiles;
+}
 function resolveCompressionApiKey(explicitApiKey, explicitApiKeyEnv) {
 	const candidateKeys = [
 		explicitApiKeyEnv,
@@ -261,6 +322,13 @@ function readCurrentAgentDocument(target) {
 	if (!target.hasAgentFile || !existsSync(target.agentPath)) return void 0;
 	return parseGeneratedAgentDocument(readFileSync(target.agentPath, "utf-8"));
 }
+function shouldCompactChangedAgentFile(target) {
+	const currentDocument = readCurrentAgentDocument(target);
+	if (!currentDocument) return false;
+	if (!currentDocument.provenance) return true;
+	if (currentDocument.provenance.sourceKind !== "agent-md") return false;
+	return hashGeneratedAgentContent(currentDocument.content) !== currentDocument.provenance.outputHash;
+}
 function resolveSourceKindForCompaction(target, currentDocument) {
 	if (!target.hasAgentFile) return "resolved-page";
 	if (currentDocument?.provenance?.sourceKind === "resolved-page") return "resolved-page";
@@ -397,6 +465,15 @@ function resolveSelectedPages(pages, targets, entry, requested, includeAll) {
 	}
 	return resolved;
 }
+function filterChangedPages(rootDir, contentDir, selectedPages) {
+	const changedFiles = listGitChangedFiles(rootDir, contentDir);
+	return selectedPages.filter(({ target }) => {
+		const relativePagePath = normalizeGitRelativePath(path.relative(rootDir, target.pagePath));
+		if (changedFiles.has(relativePagePath)) return true;
+		const relativeAgentPath = normalizeGitRelativePath(path.relative(rootDir, target.agentPath));
+		return changedFiles.has(relativeAgentPath) && shouldCompactChangedAgentFile(target);
+	});
+}
 async function compactAgentDocs(options = {}) {
 	const rootDir = process.cwd();
 	const loadedEnv = loadProjectEnv(rootDir);
@@ -410,7 +487,7 @@ async function compactAgentDocs(options = {}) {
 	if (resolvedOptions.all && resolvedOptions.pages && resolvedOptions.pages.length > 0) throw new Error("Use either --all or specific page arguments, not both.");
 	if (resolvedOptions.includeMissing && !resolvedOptions.stale) throw new Error("Use --include-missing together with --stale.");
 	const requestedPages = resolvedOptions.pages?.filter((value) => value.trim().length > 0) ?? [];
-	if (!resolvedOptions.all && requestedPages.length === 0 && !resolvedOptions.stale) throw new Error("Pass --all, --stale, or at least one docs page slug/path to compact.");
+	if (!resolvedOptions.all && requestedPages.length === 0 && !resolvedOptions.stale && !resolvedOptions.changed) throw new Error("Pass --all, --changed, --stale, or at least one docs page slug/path to compact.");
 	const pages = await createFilesystemDocsMcpSource({
 		rootDir,
 		entry,
@@ -418,8 +495,15 @@ async function compactAgentDocs(options = {}) {
 		siteTitle
 	}).getPages();
 	if (pages.length === 0) throw new Error(`No docs content was found under ${contentDir}.`);
-	const selectedPages = resolveSelectedPages(pages, scanDocsPageTargets(rootDir, contentDir, entry), entry, requestedPages, resolvedOptions.all === true || resolvedOptions.stale === true && requestedPages.length === 0);
-	if (selectedPages.length === 0) throw new Error("No compactable docs pages matched the request.");
+	const selectedPages = resolveSelectedPages(pages, scanDocsPageTargets(rootDir, contentDir, entry), entry, requestedPages, resolvedOptions.all === true || resolvedOptions.stale === true && requestedPages.length === 0 || resolvedOptions.changed === true && requestedPages.length === 0);
+	const filteredPages = resolvedOptions.changed ? filterChangedPages(rootDir, contentDir, selectedPages) : selectedPages;
+	if (filteredPages.length === 0) {
+		if (resolvedOptions.changed) {
+			console.log(pc.green("No changed docs pages needed compaction."));
+			return;
+		}
+		throw new Error("No compactable docs pages matched the request.");
+	}
 	let created = 0;
 	let overwritten = 0;
 	let processed = 0;
@@ -428,7 +512,7 @@ async function compactAgentDocs(options = {}) {
 	let skippedUnknown = 0;
 	let skippedMissing = 0;
 	const requestedExplicitPages = requestedPages.length > 0;
-	for (const { page, target } of selectedPages) {
+	for (const { page, target } of filteredPages) {
 		const state = inspectAgentCompactionState(page, target, resolvedOptions);
 		if (resolvedOptions.stale) {
 			if (state.status === "fresh") {
@@ -461,7 +545,7 @@ async function compactAgentDocs(options = {}) {
 		else created += 1;
 		processed += 1;
 	}
-	if (resolvedOptions.dryRun) processed = selectedPages.length - skippedFresh - skippedModified - skippedUnknown - skippedMissing;
+	if (resolvedOptions.dryRun) processed = filteredPages.length - skippedFresh - skippedModified - skippedUnknown - skippedMissing;
 	if (resolvedOptions.stale && processed === 0) {
 		console.log(pc.green("No stale generated agent.md files needed updates."));
 		if (skippedFresh + skippedModified + skippedUnknown + skippedMissing > 0) console.log(pc.dim(`Skipped ${skippedFresh} fresh, ${skippedModified} modified, ${skippedUnknown} unknown, and ${skippedMissing} missing page${skippedFresh + skippedModified + skippedUnknown + skippedMissing === 1 ? "" : "s"}.`));
@@ -483,6 +567,7 @@ ${pc.dim("Examples:")}
   ${pc.cyan("npx @farming-labs/docs@latest agent compact /docs/installation")}
   ${pc.cyan("npx @farming-labs/docs@latest agent compact --page installation --page configuration")}
   ${pc.cyan("npx @farming-labs/docs@latest agent compact --all")}
+  ${pc.cyan("npx @farming-labs/docs@latest agent compact --changed")}
   ${pc.cyan("npx @farming-labs/docs@latest agent compact --stale")}
   ${pc.cyan("npx @farming-labs/docs@latest agent compact --stale --include-missing")}
 
@@ -492,6 +577,7 @@ ${pc.dim("Per-page override:")}
 ${pc.dim("Options:")}
   ${pc.cyan("--all")}                    Compact every folder-based docs page under the configured contentDir
   ${pc.cyan("--page <slug|path>")}       Add a page explicitly (repeatable); positional page args work too
+  ${pc.cyan("--changed")}                Compact only docs pages changed in the current git working tree
   ${pc.cyan("--stale")}                  Re-compact only stale generated agent.md files
   ${pc.cyan("--include-missing")}        With ${pc.cyan("--stale")}, also create missing agent.md files for explicit pages or pages that define ${pc.cyan("agent.tokenBudget")}
   ${pc.cyan("--config <path>")}          Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}

package/dist/cli/index.mjs

@@ -75,7 +75,7 @@ async function main() {
 		const { runMcp } = await import("../mcp-C-TmMrdw.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-C3rj3o1l.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-B-6iQbS2.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -85,11 +85,11 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-C3rj3o1l.mjs");
+		const { printAgentCompactHelp } = await import("../agent-B-6iQbS2.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-B0xEGzBU.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-BiY_aSS1.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -152,6 +152,7 @@ ${pc.dim("Options for mcp:")}
 ${pc.dim("Options for agent compact:")}
   ${pc.cyan("agent compact <page...>")}             Compact pages and write sibling ${pc.dim("agent.md")} files
   ${pc.cyan("agent compact --all")}                 Compact every folder-based docs page
+  ${pc.cyan("agent compact --changed")}             Compact only docs pages changed in the current git working tree
   ${pc.cyan("agent compact --stale")}               Refresh only stale generated ${pc.dim("agent.md")} files
   ${pc.cyan("--page <slug|path>")}                  Repeatable explicit page flag; positional page args work too
   ${pc.cyan("--include-missing")}                   With ${pc.cyan("--stale")}, also create explicit or token-budget pages missing ${pc.dim("agent.md")}

package/dist/{doctor-B0xEGzBU.mjs → doctor-BiY_aSS1.mjs}

@@ -3,7 +3,7 @@ import "./api-reference-GDAEzQn1.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
 import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-Si-yUfM_.mjs";
-import { inspectAgentCompactionState, scanDocsPageTargets } from "./agent-C3rj3o1l.mjs";
+import { inspectAgentCompactionState, scanDocsPageTargets } from "./agent-B-6iQbS2.mjs";
 import { t as detectFramework } from "./utils-CpTFbAiS.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/package.json

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