@farming-labs/docs 0.2.104 → 0.2.105

package/dist/{prompt-references-Ca2Rcrpw.mjs → prompt-references-1Wce71c7.mjs}

@@ -1,7 +1,7 @@
-import { At as DEFAULT_SITEMAP_XML_ROUTE, Hn as DEFAULT_MCP_WELL_KNOWN_ROUTE, Ot as DEFAULT_SITEMAP_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-PSrgiJD8.mjs";
-import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-Ckx0tN7B.mjs";
+import { Un as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-DCTGj6J7.mjs";
+import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-Bpz90VYq.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DNod0XKB.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-BOjWB1ky.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts

package/dist/propose-DJOiHu9Y.mjs

@@ -0,0 +1,73 @@
+import { n as analyzeDocsAgentMaintenanceSignals, r as parseDocsAgentMaintenanceSignals } from "./agent-maintenance-CuZ7iAKq.mjs";
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+
+//#region src/cli/propose.ts
+function parseAgentMaintenanceProposeArgs(argv) {
+	const options = { inputs: [] };
+	for (let index = 0; index < argv.length; index += 1) {
+		const argument = argv[index];
+		if (argument === "--write") options.write = true;
+		else if (argument === "--json") options.json = true;
+		else if (argument === "--help" || argument === "-h") options.help = true;
+		else if (argument === "--input" || argument === "--output" || argument === "--min-occurrences") {
+			const value = argv[index + 1];
+			if (!value || value.startsWith("--")) throw new Error(`${argument} requires a value.`);
+			index += 1;
+			if (argument === "--input") options.inputs.push(value);
+			else if (argument === "--output") options.output = value;
+			else {
+				const parsed = Number(value);
+				if (!Number.isInteger(parsed) || parsed < 1 || parsed > 100) throw new Error("--min-occurrences must be an integer from 1 through 100.");
+				options.minOccurrences = parsed;
+			}
+		} else throw new Error(`Unknown agent propose flag: ${argument}`);
+	}
+	return options;
+}
+function resolveProjectPath(rootDir, value) {
+	if (path.isAbsolute(value)) throw new Error("Maintenance paths must be project-relative.");
+	const candidate = path.resolve(rootDir, value);
+	const relative = path.relative(rootDir, candidate);
+	if (relative.startsWith("..") || path.isAbsolute(relative)) throw new Error("Maintenance paths must stay inside the project root.");
+	return candidate;
+}
+function writeReport(outputPath, report) {
+	mkdirSync(path.dirname(outputPath), { recursive: true });
+	const temporaryPath = `${outputPath}.${process.pid}.tmp`;
+	writeFileSync(temporaryPath, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+	renameSync(temporaryPath, outputPath);
+}
+async function runAgentMaintenancePropose(options = {}) {
+	const rootDir = path.resolve(options.rootDir ?? process.cwd());
+	const report = analyzeDocsAgentMaintenanceSignals((options.inputs && options.inputs.length > 0 ? options.inputs : [".farming-labs/agent-feedback-improvements.json"]).flatMap((input) => parseDocsAgentMaintenanceSignals(readFileSync(resolveProjectPath(rootDir, input), "utf8"))), { minOccurrences: options.minOccurrences });
+	if (options.write) {
+		const outputPath = resolveProjectPath(rootDir, options.output ?? ".farming-labs/agent-maintenance-proposals.json");
+		writeReport(outputPath, report);
+		if (!options.json) console.log(pc.green(`Wrote ${path.relative(rootDir, outputPath)} with ${report.proposalCount} reviewable proposal${report.proposalCount === 1 ? "" : "s"}.`));
+	}
+	if (options.json || !options.write) console.log(JSON.stringify(report, null, 2));
+	return report;
+}
+function printAgentMaintenanceProposeHelp() {
+	console.log(`${pc.bold("docs agent propose")} — turn recurring signals into reviewable maintenance drafts
+
+${pc.dim("Usage:")}
+  docs agent propose --input .farming-labs/agent-feedback-improvements.json
+  docs agent propose --input search-signals.jsonl --input support-signals.json --write
+
+${pc.dim("Options:")}
+  ${pc.cyan("--input <path>")}             Repeatable JSON/JSONL signal or feedback report
+  ${pc.cyan("--min-occurrences <1-100>")} Proposal threshold (default: 2)
+  ${pc.cyan("--write")}                    Write the draft-only proposal report
+  ${pc.cyan("--output <path>")}            Output path (default: .farming-labs/agent-maintenance-proposals.json)
+  ${pc.cyan("--json")}                     Print JSON when writing
+
+Signal sources: agent-feedback, ask-ai, git, issue, mcp, search, support.
+The command never edits documentation, creates issues, publishes branches, or merges changes.
+`);
+}
+
+//#endregion
+export { parseAgentMaintenanceProposeArgs, printAgentMaintenanceProposeHelp, runAgentMaintenancePropose };

package/dist/retrieval-digest-B-SgtXKK.mjs

@@ -0,0 +1,177 @@
+//#region src/retrieval-digest.ts
+const SHA256_INITIAL_STATE = [
+	1779033703,
+	3144134277,
+	1013904242,
+	2773480762,
+	1359893119,
+	2600822924,
+	528734635,
+	1541459225
+];
+const SHA256_ROUND_CONSTANTS = [
+	1116352408,
+	1899447441,
+	3049323471,
+	3921009573,
+	961987163,
+	1508970993,
+	2453635748,
+	2870763221,
+	3624381080,
+	310598401,
+	607225278,
+	1426881987,
+	1925078388,
+	2162078206,
+	2614888103,
+	3248222580,
+	3835390401,
+	4022224774,
+	264347078,
+	604807628,
+	770255983,
+	1249150122,
+	1555081692,
+	1996064986,
+	2554220882,
+	2821834349,
+	2952996808,
+	3210313671,
+	3336571891,
+	3584528711,
+	113926993,
+	338241895,
+	666307205,
+	773529912,
+	1294757372,
+	1396182291,
+	1695183700,
+	1986661051,
+	2177026350,
+	2456956037,
+	2730485921,
+	2820302411,
+	3259730800,
+	3345764771,
+	3516065817,
+	3600352804,
+	4094571909,
+	275423344,
+	430227734,
+	506948616,
+	659060556,
+	883997877,
+	958139571,
+	1322822218,
+	1537002063,
+	1747873779,
+	1955562222,
+	2024104815,
+	2227730452,
+	2361852424,
+	2428436474,
+	2756734187,
+	3204031479,
+	3329325298
+];
+function rotateRight(value, bits) {
+	return value >>> bits | value << 32 - bits;
+}
+function normalizeDigestContent(value) {
+	return value.replace(/\r\n?/gu, "\n").replace(/^\uFEFF/u, "").trimEnd();
+}
+function toSha256Bytes(value) {
+	return typeof value === "string" ? new TextEncoder().encode(value) : value;
+}
+/** Validate the bounded HTTP(S) URL or root-relative URI reference used by provenance. */
+function isDocsRetrievalCanonicalUrl(value) {
+	const hasUnsafeCharacter = value.includes("\\") || Array.from(value).some((character) => {
+		const codePoint = character.codePointAt(0) ?? 0;
+		return codePoint <= 31 || codePoint === 127;
+	});
+	if (!value || value !== value.trim() || value.length > 4096 || hasUnsafeCharacter) return false;
+	if (/^\/(?!\/)/u.test(value)) try {
+		new URL(value, "https://docs.local");
+		return true;
+	} catch {
+		return false;
+	}
+	try {
+		const url = new URL(value);
+		return (url.protocol === "http:" || url.protocol === "https:") && !url.username && !url.password;
+	} catch {
+		return false;
+	}
+}
+/** Hash exact bytes with portable SHA-256 in Node, edge, and browser runtimes. */
+function sha256DocsContent(value) {
+	const input = toSha256Bytes(value);
+	const paddedLength = Math.ceil((input.length + 9) / 64) * 64;
+	const padded = new Uint8Array(paddedLength);
+	padded.set(input);
+	padded[input.length] = 128;
+	const bitLength = input.length * 8;
+	const dataView = new DataView(padded.buffer);
+	dataView.setUint32(paddedLength - 8, Math.floor(bitLength / 4294967296), false);
+	dataView.setUint32(paddedLength - 4, bitLength >>> 0, false);
+	const state = Uint32Array.from(SHA256_INITIAL_STATE);
+	const words = new Uint32Array(64);
+	for (let offset = 0; offset < padded.length; offset += 64) {
+		for (let index = 0; index < 16; index += 1) words[index] = dataView.getUint32(offset + index * 4, false);
+		for (let index = 16; index < 64; index += 1) {
+			const previous15 = words[index - 15];
+			const previous2 = words[index - 2];
+			const sigma0 = rotateRight(previous15, 7) ^ rotateRight(previous15, 18) ^ previous15 >>> 3;
+			const sigma1 = rotateRight(previous2, 17) ^ rotateRight(previous2, 19) ^ previous2 >>> 10;
+			words[index] = words[index - 16] + sigma0 + words[index - 7] + sigma1 >>> 0;
+		}
+		let a = state[0];
+		let b = state[1];
+		let c = state[2];
+		let d = state[3];
+		let e = state[4];
+		let f = state[5];
+		let g = state[6];
+		let h = state[7];
+		for (let index = 0; index < 64; index += 1) {
+			const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
+			const choice = e & f ^ ~e & g;
+			const temporary1 = h + sum1 + choice + SHA256_ROUND_CONSTANTS[index] + words[index] >>> 0;
+			const temporary2 = (rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22)) + (a & b ^ a & c ^ b & c) >>> 0;
+			h = g;
+			g = f;
+			f = e;
+			e = d + temporary1 >>> 0;
+			d = c;
+			c = b;
+			b = a;
+			a = temporary1 + temporary2 >>> 0;
+		}
+		state[0] = state[0] + a >>> 0;
+		state[1] = state[1] + b >>> 0;
+		state[2] = state[2] + c >>> 0;
+		state[3] = state[3] + d >>> 0;
+		state[4] = state[4] + e >>> 0;
+		state[5] = state[5] + f >>> 0;
+		state[6] = state[6] + g >>> 0;
+		state[7] = state[7] + h >>> 0;
+	}
+	return Array.from(state, (word) => word.toString(16).padStart(8, "0")).join("");
+}
+/** Hash exact message-content bytes with portable SHA-256. */
+function digestDocsContent(value) {
+	return `sha256:${sha256DocsContent(value)}`;
+}
+/**
+* Hash the normalized retrieval projection used by search provenance.
+*
+* The projection removes one leading BOM, normalizes line endings to LF, and trims
+* trailing whitespace. This deliberately differs from HTTP digests over exact bytes.
+*/
+function digestDocsRetrievalContent(value) {
+	return digestDocsContent(normalizeDigestContent(value));
+}
+
+//#endregion
+export { sha256DocsContent as i, digestDocsRetrievalContent as n, isDocsRetrievalCanonicalUrl as r, digestDocsContent as t };