skilld 1.6.2 → 1.7.0

package/dist/_chunks/sources.mjs

@@ -1,8 +1,9 @@
-import { o as getCacheDir } from "./config.mjs";
+import { t as getCacheDir } from "./version.mjs";
 import { i as readPackageJsonSafe } from "./package-json.mjs";
 import { t as yamlEscape } from "./yaml.mjs";
 import { i as parseFrontmatter, n as extractLinks, r as extractTitle, t as extractDescription } from "./markdown.mjs";
-import { c as getBlogPreset, l as getCrawlUrl, r as mapInsert, u as getDocOverride } from "./shared.mjs";
+import { n as getCrawlUrl, r as getDocOverride, t as getBlogPreset } from "./package-registry.mjs";
+import { r as mapInsert } from "./shared.mjs";
 import { tmpdir } from "node:os";
 import { basename, dirname, join, resolve } from "pathe";
 import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync } from "node:fs";
@@ -10,10 +11,10 @@ import { htmlToMarkdown } from "mdream";
 import pLimit from "p-limit";
 import { spawnSync } from "node:child_process";
 import { ofetch } from "ofetch";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { crawlAndGenerate } from "@mdream/crawl";
 import { glob } from "tinyglobby";
 import { downloadTemplate } from "giget";
-import { fileURLToPath, pathToFileURL } from "node:url";
 import { Writable } from "node:stream";
 import { resolvePathSync } from "mlly";
 const BOT_USERS = new Set([
@@ -110,12 +111,36 @@ async function ghApiPaginated(endpoint) {
 	}
 	return results;
 }
+const SKILLD_USER_AGENT = "skilld/1.0 (+https://github.com/harlan-zw/skilld)";
 const $fetch = ofetch.create({
 	retry: 3,
-	retryDelay: 500,
+	retryDelay: 1e3,
+	retryStatusCodes: [
+		408,
+		429,
+		500,
+		502,
+		503,
+		504
+	],
 	timeout: 15e3,
-	headers: { "User-Agent": "skilld/1.0" }
+	headers: { "User-Agent": SKILLD_USER_AGENT }
 });
+function createRateLimitedRunner(intervalMs) {
+	let queue = Promise.resolve();
+	let lastRunAt = 0;
+	return async function runRateLimited(task) {
+		const run = async () => {
+			const waitMs = intervalMs - (Date.now() - lastRunAt);
+			if (waitMs > 0) await new Promise((resolve) => setTimeout(resolve, waitMs));
+			lastRunAt = Date.now();
+			return task();
+		};
+		const request = queue.then(run, run);
+		queue = request.then(() => void 0, () => void 0);
+		return request;
+	};
+}
 async function fetchText(url) {
 	return $fetch(url, { responseType: "text" }).catch(() => null);
 }
@@ -175,6 +200,20 @@ function isGitHubRepoUrl(url) {
 		return false;
 	}
 }
+function isLikelyCodeHostUrl(url) {
+	if (!url) return false;
+	try {
+		const parsed = new URL(url);
+		return [
+			"github.com",
+			"www.github.com",
+			"gitlab.com",
+			"www.gitlab.com"
+		].includes(parsed.hostname);
+	} catch {
+		return false;
+	}
+}
 function parseGitHubUrl(url) {
 	const match = url.match(/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:[/#]|$)/);
 	if (!match) return null;
@@ -456,99 +495,6 @@ async function fetchBlogReleases(packageName, installedVersion) {
 		content: formatBlogRelease(r)
 	}));
 }
-async function fetchCrawledDocs(url, onProgress, maxPages = 200) {
-	const outputDir = join(tmpdir(), "skilld-crawl", Date.now().toString());
-	onProgress?.(`Crawling ${url}`);
-	const userLang = getUserLang();
-	const foreignUrls = /* @__PURE__ */ new Set();
-	const doCrawl = () => crawlAndGenerate({
-		urls: [url],
-		outputDir,
-		driver: "http",
-		generateLlmsTxt: false,
-		generateIndividualMd: true,
-		maxRequestsPerCrawl: maxPages,
-		onPage: (page) => {
-			const lang = extractHtmlLang(page.html);
-			if (lang && !lang.startsWith("en") && !lang.startsWith(userLang)) foreignUrls.add(page.url);
-		}
-	}, (progress) => {
-		if (progress.crawling.status === "processing" && progress.crawling.total > 0) onProgress?.(`Crawling ${progress.crawling.processed}/${progress.crawling.total} pages`);
-	});
-	let results = await doCrawl().catch((err) => {
-		onProgress?.(`Crawl failed: ${err?.message || err}`);
-		return [];
-	});
-	if (results.length === 0) {
-		onProgress?.("Retrying crawl");
-		results = await doCrawl().catch(() => []);
-	}
-	rmSync(outputDir, {
-		recursive: true,
-		force: true
-	});
-	const docs = [];
-	let localeFiltered = 0;
-	for (const result of results) {
-		if (!result.success || !result.content) continue;
-		if (foreignUrls.has(result.url)) {
-			localeFiltered++;
-			continue;
-		}
-		const segments = (new URL(result.url).pathname.replace(/\/$/, "") || "/index").split("/").filter(Boolean);
-		if (isForeignPathPrefix(segments[0], userLang)) {
-			localeFiltered++;
-			continue;
-		}
-		const path = `docs/${segments.join("/")}.md`;
-		docs.push({
-			path,
-			content: result.content
-		});
-	}
-	if (localeFiltered > 0) onProgress?.(`Filtered ${localeFiltered} foreign locale pages`);
-	onProgress?.(`Crawled ${docs.length} pages`);
-	return docs;
-}
-const HTML_LANG_RE = /<html[^>]*\slang=["']([^"']+)["']/i;
-function extractHtmlLang(html) {
-	return HTML_LANG_RE.exec(html)?.[1]?.toLowerCase();
-}
-const LOCALE_CODES = new Set([
-	"ar",
-	"de",
-	"es",
-	"fr",
-	"id",
-	"it",
-	"ja",
-	"ko",
-	"nl",
-	"pl",
-	"pt",
-	"pt-br",
-	"ru",
-	"th",
-	"tr",
-	"uk",
-	"vi",
-	"zh",
-	"zh-cn",
-	"zh-tw"
-]);
-function isForeignPathPrefix(segment, userLang) {
-	if (!segment) return false;
-	const lower = segment.toLowerCase();
-	if (lower === "en" || lower.startsWith(userLang)) return false;
-	return LOCALE_CODES.has(lower);
-}
-function getUserLang() {
-	const code = (process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || "").split(/[_.:-]/)[0]?.toLowerCase() || "";
-	return code.length >= 2 ? code.slice(0, 2) : "en";
-}
-function toCrawlPattern(docsUrl) {
-	return `${docsUrl.replace(/\/+$/, "")}/**`;
-}
 let _ghAvailable;
 function isGhAvailable() {
 	if (_ghAvailable !== void 0) return _ghAvailable;
@@ -870,992 +816,1235 @@ function generateIssueIndex(issues) {
 	}
 	return sections.join("\n");
 }
-const HIGH_VALUE_CATEGORIES = new Set([
-	"q&a",
-	"help",
-	"troubleshooting",
-	"support"
-]);
-const LOW_VALUE_CATEGORIES = new Set([
-	"show and tell",
-	"ideas",
-	"polls"
-]);
-const TITLE_NOISE_RE = /looking .*(?:developer|engineer|freelanc)|hiring|job post|guide me to (?:complete|finish|build)|help me (?:complete|finish|build)|seeking .* tutorial|recommend.* course/i;
-const MIN_DISCUSSION_SCORE = 3;
-function scoreComment(c) {
-	return (c.isMaintainer ? 3 : 1) * (hasCodeBlock(c.body) ? 2 : 1) * (1 + c.reactions);
+async function fetchLlmsUrl(docsUrl) {
+	const llmsUrl = `${new URL(docsUrl).origin}/llms.txt`;
+	if (await verifyUrl(llmsUrl)) return llmsUrl;
+	return null;
 }
-function scoreDiscussion(d) {
-	if (TITLE_NOISE_RE.test(d.title)) return -1;
-	let score = 0;
-	if (d.isMaintainer) score += 3;
-	if (hasCodeBlock([
-		d.body,
-		d.answer || "",
-		...d.topComments.map((c) => c.body)
-	].join("\n"))) score += 3;
-	score += Math.min(d.upvoteCount, 5);
-	if (d.answer) {
-		score += 2;
-		if (d.answer.length > 100) score += 1;
-	}
-	if (d.topComments.some((c) => c.isMaintainer)) score += 2;
-	if (d.topComments.some((c) => c.reactions > 0)) score += 1;
-	return score;
+async function fetchLlmsTxt(url) {
+	const content = await fetchText(url);
+	if (!content || content.length < 50) return null;
+	return {
+		raw: content,
+		links: parseMarkdownLinks(content)
+	};
 }
-async function fetchGitHubDiscussions(owner, repo, limit = 20, releasedAt, fromDate) {
-	if (!isGhAvailable()) return [];
-	if (!fromDate && releasedAt) {
-		const cutoff = new Date(releasedAt);
-		cutoff.setMonth(cutoff.getMonth() + 6);
-		if (cutoff < /* @__PURE__ */ new Date()) return [];
-	}
+function parseMarkdownLinks(content) {
+	return extractLinks(content).filter((l) => l.url.endsWith(".md"));
+}
+function isSafeUrl(url) {
 	try {
-		const { stdout: result } = spawnSync("gh", [
-			"api",
-			"graphql",
-			"-f",
-			`query=${`query($owner: String!, $repo: String!) { repository(owner: $owner, name: $repo) { discussions(first: ${Math.min(limit * 3, 80)}, orderBy: {field: CREATED_AT, direction: DESC}) { nodes { number title body category { name } createdAt url upvoteCount comments(first: 10) { totalCount nodes { body author { login } authorAssociation reactions { totalCount } } } answer { body author { login } authorAssociation } author { login } authorAssociation } } } }`}`,
-			"-f",
-			`owner=${owner}`,
-			"-f",
-			`repo=${repo}`
-		], {
-			encoding: "utf-8",
-			maxBuffer: 10 * 1024 * 1024
-		});
-		if (!result) return [];
-		const nodes = JSON.parse(result)?.data?.repository?.discussions?.nodes;
-		if (!Array.isArray(nodes)) return [];
-		const fromTs = fromDate ? new Date(fromDate).getTime() : null;
-		return nodes.filter((d) => d.author && !BOT_USERS.has(d.author.login)).filter((d) => {
-			const cat = (d.category?.name || "").toLowerCase();
-			return !LOW_VALUE_CATEGORIES.has(cat);
-		}).filter((d) => !fromTs || new Date(d.createdAt).getTime() >= fromTs).map((d) => {
-			let answer;
-			if (d.answer?.body) {
-				const isMaintainer = [
-					"OWNER",
-					"MEMBER",
-					"COLLABORATOR"
-				].includes(d.answer.authorAssociation);
-				const author = d.answer.author?.login;
-				answer = `${isMaintainer && author ? `**@${author}** [maintainer]:\n\n` : ""}${d.answer.body}`;
-			}
-			const comments = (d.comments?.nodes || []).filter((c) => c.author && !BOT_USERS.has(c.author.login)).filter((c) => !COMMENT_NOISE_RE.test((c.body || "").trim())).map((c) => {
-				const isMaintainer = [
-					"OWNER",
-					"MEMBER",
-					"COLLABORATOR"
-				].includes(c.authorAssociation);
-				return {
-					body: c.body || "",
-					author: c.author.login,
-					reactions: c.reactions?.totalCount || 0,
-					isMaintainer
-				};
-			}).sort((a, b) => scoreComment(b) - scoreComment(a)).slice(0, 3);
-			return {
-				number: d.number,
-				title: d.title,
-				body: d.body || "",
-				category: d.category?.name || "",
-				createdAt: d.createdAt,
-				url: d.url,
-				upvoteCount: d.upvoteCount || 0,
-				comments: d.comments?.totalCount || 0,
-				isMaintainer: [
-					"OWNER",
-					"MEMBER",
-					"COLLABORATOR"
-				].includes(d.authorAssociation),
-				answer,
-				topComments: comments
-			};
-		}).map((d) => ({
-			d,
-			score: scoreDiscussion(d)
-		})).filter(({ score }) => score >= MIN_DISCUSSION_SCORE).sort((a, b) => {
-			const aHigh = HIGH_VALUE_CATEGORIES.has(a.d.category.toLowerCase()) ? 1 : 0;
-			const bHigh = HIGH_VALUE_CATEGORIES.has(b.d.category.toLowerCase()) ? 1 : 0;
-			if (aHigh !== bHigh) return bHigh - aHigh;
-			return b.score - a.score;
-		}).slice(0, limit).map(({ d }) => d);
+		const parsed = new URL(url);
+		if (parsed.protocol !== "https:") return false;
+		const host = parsed.hostname;
+		if (host === "localhost" || host === "0.0.0.0" || host === "[::1]") return false;
+		if (/^(?:127\.|10\.|172\.(?:1[6-9]|2\d|3[01])\.|192\.168\.|169\.254\.)/.test(host)) return false;
+		if (/^\[(?:f[cd]|fe[89ab]|::ffff:)/i.test(host)) return false;
+		return true;
 	} catch {
-		return [];
+		return false;
 	}
 }
-function formatDiscussionAsMarkdown(d) {
-	const fm = buildFrontmatter({
-		number: d.number,
-		title: d.title,
-		category: d.category,
-		created: isoDate(d.createdAt),
-		url: d.url,
-		upvotes: d.upvoteCount,
-		comments: d.comments,
-		answered: !!d.answer
-	});
-	const bodyLimit = d.upvoteCount >= 5 ? 1500 : 800;
-	const lines = [
-		fm,
-		"",
-		`# ${d.title}`
-	];
-	if (d.body) lines.push("", truncateBody(d.body, bodyLimit));
-	if (d.answer) lines.push("", "---", "", "## Accepted Answer", "", truncateBody(d.answer, 1e3));
-	else if (d.topComments.length > 0) {
-		lines.push("", "---", "", "## Top Comments");
-		for (const c of d.topComments) {
-			const reactions = c.reactions > 0 ? ` (+${c.reactions})` : "";
-			const maintainer = c.isMaintainer ? " [maintainer]" : "";
-			lines.push("", `**@${c.author}**${maintainer}${reactions}:`, "", truncateBody(c.body, 600));
-		}
-	}
-	return lines.join("\n");
+async function downloadLlmsDocs(llmsContent, baseUrl, onProgress) {
+	const limit = pLimit(5);
+	let completed = 0;
+	return (await Promise.all(llmsContent.links.map((link) => limit(async () => {
+		const url = link.url.startsWith("http") ? link.url : `${baseUrl.replace(/\/$/, "")}${link.url.startsWith("/") ? "" : "/"}${link.url}`;
+		if (!isSafeUrl(url)) return null;
+		const content = await fetchText(url);
+		onProgress?.(link.url, ++completed, llmsContent.links.length);
+		if (content && content.length > 100) return {
+			url: link.url.startsWith("http") ? new URL(link.url).pathname : link.url,
+			title: link.title,
+			content
+		};
+		return null;
+	})))).filter((d) => d !== null);
 }
-function generateDiscussionIndex(discussions) {
-	const byCategory = /* @__PURE__ */ new Map();
-	for (const d of discussions) mapInsert(byCategory, d.category || "Uncategorized", () => []).push(d);
-	const answered = discussions.filter((d) => d.answer).length;
-	const sections = [
-		[
-			"---",
-			`total: ${discussions.length}`,
-			`answered: ${answered}`,
-			"---"
-		].join("\n"),
-		"",
-		"# Discussions Index",
-		""
-	];
-	const cats = [...byCategory.keys()].sort((a, b) => {
-		return (HIGH_VALUE_CATEGORIES.has(a.toLowerCase()) ? 0 : 1) - (HIGH_VALUE_CATEGORIES.has(b.toLowerCase()) ? 0 : 1) || a.localeCompare(b);
-	});
-	for (const cat of cats) {
-		const group = byCategory.get(cat);
-		sections.push(`## ${cat} (${group.length})`, "");
-		for (const d of group) {
-			const upvotes = d.upvoteCount > 0 ? ` (+${d.upvoteCount})` : "";
-			const answered = d.answer ? " [answered]" : "";
-			const date = isoDate(d.createdAt);
-			sections.push(`- [#${d.number}](./discussion-${d.number}.md): ${d.title}${upvotes}${answered} (${date})`);
-		}
-		sections.push("");
+function normalizeLlmsLinks(content, baseUrl) {
+	let normalized = content;
+	if (baseUrl) {
+		const escaped = baseUrl.replace(/\/$/, "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		normalized = normalized.replace(new RegExp(`\\]\\(${escaped}(/[^)]+\\.md)\\)`, "g"), "](./docs$1)");
 	}
-	return sections.join("\n");
+	normalized = normalized.replace(/\]\(\/([^)]+\.md)\)/g, "](./docs/$1)");
+	return normalized;
 }
-function generateDocsIndex(docs) {
-	const docFiles = docs.filter((d) => d.path.startsWith("docs/") && d.path.endsWith(".md") && !d.path.endsWith("_INDEX.md")).sort((a, b) => a.path.localeCompare(b.path));
-	if (docFiles.length === 0) return "";
-	const rootFiles = [];
-	const byDir = /* @__PURE__ */ new Map();
-	for (const doc of docFiles) {
-		const rel = doc.path.slice(5);
-		const dir = rel.includes("/") ? rel.slice(0, rel.lastIndexOf("/")) : "";
-		if (!dir) rootFiles.push(doc);
-		else {
-			const list = byDir.get(dir);
-			if (list) list.push(doc);
-			else byDir.set(dir, [doc]);
+function extractSections(content, patterns) {
+	const sections = [];
+	const parts = content.split(/\n---\n/);
+	for (const part of parts) {
+		const urlMatch = part.match(/^url: *(\S.*)$/m);
+		if (!urlMatch) continue;
+		const url = urlMatch[1];
+		if (patterns.some((p) => url.includes(p))) {
+			const contentStart = part.indexOf("\n", part.indexOf("url:"));
+			if (contentStart > -1) sections.push(part.slice(contentStart + 1));
 		}
 	}
-	const sections = [
-		"---",
-		`total: ${docFiles.length}`,
-		"---",
-		"",
-		"# Docs Index",
-		""
-	];
-	for (const file of rootFiles) {
-		const rel = file.path.slice(5);
-		const title = extractTitle(file.content) || rel.replace(/\.md$/, "");
-		const desc = extractDescription(file.content);
-		const descPart = desc ? `: ${desc}` : "";
-		sections.push(`- [${title}](./${rel})${descPart}`);
+	if (sections.length === 0) return null;
+	return sections.join("\n\n---\n\n");
+}
+const MIN_GIT_DOCS = 5;
+const isShallowGitDocs = (n) => n > 0 && n < 5;
+async function listFilesAtRef(owner, repo, ref) {
+	if (!isKnownPrivateRepo(owner, repo)) {
+		const data = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/files/${ref}`).catch(() => null);
+		if (data?.files?.length) return data.files.map((f) => f.path);
 	}
-	if (rootFiles.length > 0) sections.push("");
-	for (const [dir, files] of byDir) {
-		sections.push(`## ${dir} (${files.length})`, "");
-		for (const file of files) {
-			const rel = file.path.slice(5);
-			const title = extractTitle(file.content) || rel.replace(/\.md$/, "").split("/").pop();
-			const desc = extractDescription(file.content);
-			const descPart = desc ? `: ${desc}` : "";
-			sections.push(`- [${title}](./${rel})${descPart}`);
-		}
-		sections.push("");
+	const tree = await ghApi(`repos/${owner}/${repo}/git/trees/${ref}?recursive=1`);
+	if (tree?.tree?.length) {
+		markRepoPrivate(owner, repo);
+		return tree.tree.map((f) => f.path);
 	}
-	return sections.join("\n");
+	return [];
 }
-const SKIP_DIRS = [
-	"node_modules",
-	"_vendor",
-	"__tests__",
-	"__mocks__",
-	"__fixtures__",
-	"test",
-	"tests",
-	"fixture",
-	"fixtures",
-	"locales",
-	"locale",
-	"i18n",
-	".git"
-];
-const SKIP_PATTERNS = [
-	"*.min.*",
-	"*.prod.*",
-	"*.global.*",
-	"*.browser.*",
-	"*.map",
-	"*.map.js",
-	"CHANGELOG*",
-	"LICENSE*",
-	"README*"
-];
-const MAX_FILE_SIZE = 500 * 1024;
-async function resolveEntryFiles(packageDir) {
-	if (!existsSync(join(packageDir, "package.json"))) return [];
-	const files = await glob(["**/*.d.{ts,mts,cts}"], {
-		cwd: packageDir,
-		ignore: [...SKIP_DIRS.map((d) => `**/${d}/**`), ...SKIP_PATTERNS],
-		absolute: false,
-		expandDirectories: false
-	});
-	const entries = [];
-	for (const file of files) {
-		const absPath = join(packageDir, file);
-		let content;
-		try {
-			content = readFileSync(absPath, "utf-8");
-		} catch {
-			continue;
+async function findGitTag(owner, repo, version, packageName, branchHint) {
+	const candidates = [`v${version}`, version];
+	if (packageName) candidates.push(`${packageName}@${version}`);
+	for (const tag of candidates) {
+		const files = await listFilesAtRef(owner, repo, tag);
+		if (files.length > 0) return {
+			ref: tag,
+			files
+		};
+	}
+	if (packageName) {
+		const latestTag = await findLatestReleaseTag(owner, repo, packageName);
+		if (latestTag) {
+			const files = await listFilesAtRef(owner, repo, latestTag);
+			if (files.length > 0) return {
+				ref: latestTag,
+				files
+			};
 		}
-		if (content.length > MAX_FILE_SIZE) continue;
-		entries.push({
-			path: file,
-			content,
-			type: "types"
-		});
 	}
-	return entries;
-}
-function parseGitSkillInput(input) {
-	const trimmed = input.trim();
-	if (trimmed.startsWith("@")) return null;
-	if (trimmed.startsWith("./") || trimmed.startsWith("../") || trimmed.startsWith("/") || trimmed.startsWith("~")) return {
-		type: "local",
-		localPath: trimmed.startsWith("~") ? resolve(process.env.HOME || "", trimmed.slice(1)) : resolve(trimmed)
-	};
-	if (trimmed.startsWith("git@")) {
-		const gh = parseGitHubUrl(normalizeRepoUrl(trimmed));
-		if (gh) return {
-			type: "github",
-			owner: gh.owner,
-			repo: gh.repo
+	const branches = branchHint ? [branchHint, ...["main", "master"].filter((b) => b !== branchHint)] : ["main", "master"];
+	for (const branch of branches) {
+		const files = await listFilesAtRef(owner, repo, branch);
+		if (files.length > 0) return {
+			ref: branch,
+			files,
+			fallback: true
 		};
-		return null;
 	}
-	if (trimmed.startsWith("https://") || trimmed.startsWith("http://")) return parseGitUrl(trimmed);
-	if (/^[\w.-]+\/[\w.-]+$/.test(trimmed)) return {
-		type: "github",
-		owner: trimmed.split("/")[0],
-		repo: trimmed.split("/")[1]
-	};
 	return null;
 }
-function parseGitUrl(url) {
-	try {
-		const parsed = new URL(url);
-		if (parsed.hostname === "github.com" || parsed.hostname === "www.github.com") {
-			const parts = parsed.pathname.replace(/^\//, "").replace(/\.git$/, "").split("/");
-			const owner = parts[0];
-			const repo = parts[1];
-			if (!owner || !repo) return null;
-			if (parts[2] === "tree" && parts.length >= 4) return {
-				type: "github",
-				owner,
-				repo,
-				ref: parts[3],
-				skillPath: parts.length > 4 ? parts.slice(4).join("/") : void 0
-			};
-			return {
-				type: "github",
-				owner,
-				repo
-			};
-		}
-		if (parsed.hostname === "gitlab.com") {
-			const parts = parsed.pathname.replace(/^\//, "").replace(/\.git$/, "").split("/");
-			const owner = parts[0];
-			const repo = parts[1];
-			if (!owner || !repo) return null;
-			return {
-				type: "gitlab",
-				owner,
-				repo
-			};
-		}
-		return null;
-	} catch {
-		return null;
+async function fetchUnghReleases(owner, repo) {
+	if (!isKnownPrivateRepo(owner, repo)) {
+		const data = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/releases`).catch(() => null);
+		if (data?.releases?.length) return data.releases;
+	}
+	const raw = await ghApiPaginated(`repos/${owner}/${repo}/releases`);
+	if (raw.length > 0) {
+		markRepoPrivate(owner, repo);
+		return raw.map((r) => ({
+			tag: r.tag_name,
+			publishedAt: r.published_at
+		}));
 	}
+	return [];
 }
-function parseSkillFrontmatterName(content) {
-	const fm = parseFrontmatter(content);
-	return {
-		name: fm.name,
-		description: fm.description
-	};
+async function findLatestReleaseTag(owner, repo, packageName) {
+	const prefix = `${packageName}@`;
+	return (await fetchUnghReleases(owner, repo)).find((r) => r.tag.startsWith(prefix))?.tag ?? null;
 }
-function collectFiles(dir, prefix = "") {
-	const files = [];
-	if (!existsSync(dir)) return files;
-	for (const entry of readdirSync(dir, { withFileTypes: true })) {
-		const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
-		const fullPath = resolve(dir, entry.name);
-		if (entry.isDirectory()) files.push(...collectFiles(fullPath, relPath));
-		else if (entry.isFile()) files.push({
-			path: relPath,
-			content: readFileSync(fullPath, "utf-8")
-		});
-	}
-	return files;
+function filterDocFiles(files, pathPrefix) {
+	return files.filter((f) => f.startsWith(pathPrefix) && /\.(?:md|mdx)$/.test(f));
 }
-async function fetchGitSkills(source, onProgress) {
-	if (source.type === "local") return fetchLocalSkills(source);
-	if (source.type === "github") return fetchGitHubSkills(source, onProgress);
-	if (source.type === "gitlab") return fetchGitLabSkills(source, onProgress);
-	return { skills: [] };
+const FRAMEWORK_NAMES = new Set([
+	"vue",
+	"react",
+	"solid",
+	"angular",
+	"svelte",
+	"preact",
+	"lit",
+	"qwik"
+]);
+function filterFrameworkDocs(files, packageName) {
+	if (!packageName) return files;
+	const shortName = packageName.replace(/^@.*\//, "");
+	const targetFramework = [...FRAMEWORK_NAMES].find((fw) => shortName.includes(fw));
+	if (!targetFramework) return files;
+	const otherFrameworks = [...FRAMEWORK_NAMES].filter((fw) => fw !== targetFramework);
+	const excludePattern = new RegExp(`\\b(?:${otherFrameworks.join("|")})\\b`);
+	return files.filter((f) => !excludePattern.test(f));
 }
-function fetchLocalSkills(source) {
-	const base = source.localPath;
-	if (!existsSync(base)) return { skills: [] };
-	const skills = [];
-	const skillsDir = resolve(base, "skills");
-	if (existsSync(skillsDir)) for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
-		if (!entry.isDirectory()) continue;
-		const skill = readLocalSkill(resolve(skillsDir, entry.name), `skills/${entry.name}`);
-		if (skill) skills.push(skill);
+const NOISE_PATTERNS = [
+	/^\.changeset\//,
+	/CHANGELOG\.md$/i,
+	/CONTRIBUTING\.md$/i,
+	/^\.github\//
+];
+const EXCLUDE_DIRS = new Set([
+	"test",
+	"tests",
+	"__tests__",
+	"fixtures",
+	"fixture",
+	"examples",
+	"example",
+	"node_modules",
+	".git",
+	"dist",
+	"build",
+	"coverage",
+	"e2e",
+	"spec",
+	"mocks",
+	"__mocks__"
+]);
+const DOC_DIR_BONUS = new Set([
+	"docs",
+	"documentation",
+	"pages",
+	"content",
+	"website",
+	"guide",
+	"guides",
+	"wiki",
+	"manual",
+	"api"
+]);
+function hasExcludedDir(path) {
+	return path.split("/").some((p) => EXCLUDE_DIRS.has(p.toLowerCase()));
+}
+function getPathDepth(path) {
+	return path.split("/").filter(Boolean).length;
+}
+function hasDocDirBonus(path) {
+	return path.split("/").some((p) => DOC_DIR_BONUS.has(p.toLowerCase()));
+}
+function scoreDocDir(dir, fileCount) {
+	const depth = getPathDepth(dir) || 1;
+	return fileCount * (hasDocDirBonus(dir) ? 1.5 : 1) / depth;
+}
+function discoverDocFiles(allFiles, packageName) {
+	const mdFiles = allFiles.filter((f) => /\.(?:md|mdx)$/.test(f)).filter((f) => !NOISE_PATTERNS.some((p) => p.test(f))).filter((f) => f.includes("/"));
+	if (packageName?.includes("/")) {
+		const subPkgPrefix = `packages/${packageName.split("/").pop().toLowerCase()}/`;
+		const subPkgFiles = mdFiles.filter((f) => f.startsWith(subPkgPrefix));
+		if (subPkgFiles.length >= 3) return {
+			files: subPkgFiles,
+			prefix: subPkgPrefix
+		};
 	}
-	if (skills.length === 0) {
-		const skill = readLocalSkill(base, "");
-		if (skill) skills.push(skill);
+	const docsGroups = /* @__PURE__ */ new Map();
+	for (const file of mdFiles) {
+		const docsIdx = file.lastIndexOf("/docs/");
+		if (docsIdx === -1) continue;
+		mapInsert(docsGroups, file.slice(0, docsIdx + 6), () => []).push(file);
 	}
-	return { skills };
+	if (docsGroups.size > 0) {
+		const largest = [...docsGroups.entries()].sort((a, b) => b[1].length - a[1].length)[0];
+		if (largest[1].length >= 3) {
+			const fullPrefix = largest[0];
+			const docsIdx = fullPrefix.lastIndexOf("docs/");
+			const stripPrefix = docsIdx > 0 ? fullPrefix.slice(0, docsIdx) : "";
+			return {
+				files: largest[1],
+				prefix: stripPrefix
+			};
+		}
+	}
+	const dirGroups = /* @__PURE__ */ new Map();
+	for (const file of mdFiles) {
+		if (hasExcludedDir(file)) continue;
+		const lastSlash = file.lastIndexOf("/");
+		if (lastSlash === -1) continue;
+		mapInsert(dirGroups, file.slice(0, lastSlash + 1), () => []).push(file);
+	}
+	if (dirGroups.size === 0) return null;
+	const scored = Array.from(dirGroups.entries(), ([dir, files]) => ({
+		dir,
+		files,
+		score: scoreDocDir(dir, files.length)
+	})).filter((d) => d.files.length >= 5).sort((a, b) => b.score - a.score);
+	if (scored.length === 0) return null;
+	const best = scored[0];
+	return {
+		files: best.files,
+		prefix: best.dir
+	};
 }
-function readLocalSkill(dir, repoPath) {
-	const skillMdPath = resolve(dir, "SKILL.md");
-	if (!existsSync(skillMdPath)) return null;
-	const content = readFileSync(skillMdPath, "utf-8");
-	const frontmatter = parseSkillFrontmatterName(content);
-	const dirName = dir.split("/").pop();
-	const name = frontmatter.name || dirName;
-	const files = collectFiles(dir).filter((f) => f.path !== "SKILL.md");
+async function listDocsAtRef(owner, repo, ref, pathPrefix = "docs/") {
+	return filterDocFiles(await listFilesAtRef(owner, repo, ref), pathPrefix);
+}
+async function fetchGitDocs(owner, repo, version, packageName, repoUrl) {
+	const override = packageName ? getDocOverride(packageName) : void 0;
+	if (override) {
+		const ref = override.ref || "main";
+		const fallback = !override.ref;
+		const files = await listDocsAtRef(override.owner, override.repo, ref, `${override.path}/`);
+		if (files.length === 0) return null;
+		return {
+			baseUrl: `https://raw.githubusercontent.com/${override.owner}/${override.repo}/${ref}`,
+			ref,
+			files,
+			fallback,
+			docsPrefix: `${override.path}/` !== "docs/" ? `${override.path}/` : void 0
+		};
+	}
+	const tag = await findGitTag(owner, repo, version, packageName, repoUrl ? extractBranchHint(repoUrl) : void 0);
+	if (!tag) return null;
+	let docs = filterDocFiles(tag.files, "docs/");
+	let docsPrefix;
+	let allFiles;
+	if (docs.length === 0) {
+		const discovered = discoverDocFiles(tag.files, packageName);
+		if (discovered) {
+			docs = discovered.files;
+			docsPrefix = discovered.prefix || void 0;
+			allFiles = tag.files;
+		}
+	}
+	docs = filterFrameworkDocs(docs, packageName);
+	if (docs.length === 0) return null;
 	return {
-		name,
-		description: frontmatter.description || "",
-		path: repoPath,
-		content,
-		files
+		baseUrl: `https://raw.githubusercontent.com/${owner}/${repo}/${tag.ref}`,
+		ref: tag.ref,
+		files: docs,
+		docsPrefix,
+		allFiles,
+		fallback: tag.fallback
 	};
 }
-async function fetchGitHubSkills(source, onProgress) {
-	const { owner, repo } = source;
-	if (!owner || !repo) return { skills: [] };
-	const ref = source.ref || "main";
-	const refs = ref === "main" ? ["main", "master"] : [ref];
-	for (const tryRef of refs) {
-		const skills = await downloadGitHubSkills(owner, repo, tryRef, source.skillPath, onProgress);
-		if (skills.length > 0) return { skills };
+function normalizePath(p) {
+	return p.replace(/^\//, "").replace(/\.(?:md|mdx)$/, "");
+}
+function validateGitDocsWithLlms(llmsLinks, repoFiles) {
+	if (llmsLinks.length === 0) return {
+		isValid: true,
+		matchRatio: 1
+	};
+	const sample = llmsLinks.slice(0, 10);
+	const normalizedLinks = sample.map((link) => {
+		let path = link.url;
+		if (path.startsWith("http")) try {
+			path = new URL(path).pathname;
+		} catch {}
+		return normalizePath(path);
+	});
+	const repoNormalized = new Set(repoFiles.map(normalizePath));
+	let matches = 0;
+	for (const linkPath of normalizedLinks) for (const repoPath of repoNormalized) if (repoPath === linkPath || repoPath.endsWith(`/${linkPath}`)) {
+		matches++;
+		break;
 	}
-	return { skills: [] };
+	const matchRatio = matches / sample.length;
+	return {
+		isValid: matchRatio >= .3,
+		matchRatio
+	};
 }
-async function downloadGitHubSkills(owner, repo, ref, skillPath, onProgress) {
-	const tempDir = join(tmpdir(), `skilld-${Date.now()}`);
-	try {
-		if (skillPath) {
-			onProgress?.(`Downloading ${owner}/${repo}/${skillPath}@${ref}`);
-			const { dir } = await downloadTemplate(`github:${owner}/${repo}/${skillPath}#${ref}`, {
-				dir: tempDir,
-				force: true,
-				auth: getGitHubToken() || void 0
-			});
-			const skill = readLocalSkill(dir, skillPath);
-			return skill ? [skill] : [];
-		}
-		onProgress?.(`Downloading ${owner}/${repo}/skills@${ref}`);
+async function verifyNpmRepo(owner, repo, packageName) {
+	const base = `https://raw.githubusercontent.com/${owner}/${repo}/HEAD`;
+	const paths = [
+		"package.json",
+		`packages/${packageName.replace(/^@.*\//, "")}/package.json`,
+		`packages/${packageName.replace(/^@/, "").replace("/", "-")}/package.json`
+	];
+	for (const path of paths) {
+		const text = await fetchGitHubRaw(`${base}/${path}`);
+		if (!text) continue;
 		try {
-			const { dir } = await downloadTemplate(`github:${owner}/${repo}/skills#${ref}`, {
-				dir: tempDir,
-				force: true,
-				auth: getGitHubToken() || void 0
-			});
-			const skills = [];
-			for (const entry of readdirSync(dir, { withFileTypes: true })) {
-				if (!entry.isDirectory()) continue;
-				const skill = readLocalSkill(resolve(dir, entry.name), `skills/${entry.name}`);
-				if (skill) skills.push(skill);
-			}
-			if (skills.length > 0) {
-				onProgress?.(`Found ${skills.length} skill(s)`);
-				return skills;
-			}
+			if (JSON.parse(text).name === packageName) return true;
 		} catch {}
-		const content = await fetchGitHubRaw(`https://raw.githubusercontent.com/${owner}/${repo}/${ref}/SKILL.md`);
-		if (content) {
-			const fm = parseSkillFrontmatterName(content);
-			onProgress?.("Found 1 skill");
-			return [{
-				name: fm.name || repo,
-				description: fm.description || "",
-				path: "",
-				content,
-				files: []
-			}];
-		}
-		return [];
-	} catch {
-		return [];
-	} finally {
-		rmSync(tempDir, {
-			recursive: true,
-			force: true
-		});
 	}
+	return false;
 }
-async function fetchGitLabSkills(source, onProgress) {
-	const { owner, repo } = source;
-	if (!owner || !repo) return { skills: [] };
-	const ref = source.ref || "main";
-	const tempDir = join(tmpdir(), `skilld-gitlab-${Date.now()}`);
-	try {
-		const subdir = source.skillPath || "skills";
-		onProgress?.(`Downloading ${owner}/${repo}/${subdir}@${ref}`);
-		const { dir } = await downloadTemplate(`gitlab:${owner}/${repo}/${subdir}#${ref}`, {
-			dir: tempDir,
-			force: true
-		});
-		if (source.skillPath) {
-			const skill = readLocalSkill(dir, source.skillPath);
-			return { skills: skill ? [skill] : [] };
-		}
-		const skills = [];
-		for (const entry of readdirSync(dir, { withFileTypes: true })) {
-			if (!entry.isDirectory()) continue;
-			const skill = readLocalSkill(resolve(dir, entry.name), `skills/${entry.name}`);
-			if (skill) skills.push(skill);
-		}
-		if (skills.length > 0) {
-			onProgress?.(`Found ${skills.length} skill(s)`);
-			return { skills };
-		}
-		const content = await $fetch(`https://gitlab.com/${owner}/${repo}/-/raw/${ref}/SKILL.md`, { responseType: "text" }).catch(() => null);
-		if (content) {
-			const fm = parseSkillFrontmatterName(content);
-			return { skills: [{
-				name: fm.name || repo,
-				description: fm.description || "",
-				path: "",
-				content,
-				files: []
-			}] };
+async function searchGitHubRepo(packageName) {
+	const shortName = packageName.replace(/^@.*\//, "");
+	for (const candidate of [packageName.replace(/^@/, "").replace("/", "/"), shortName]) {
+		if (!candidate.includes("/")) {
+			if ((await $fetch.raw(`https://ungh.cc/repos/${shortName}/${shortName}`).catch(() => null))?.ok) return `https://github.com/${shortName}/${shortName}`;
+			continue;
 		}
-		return { skills: [] };
-	} catch {
-		return { skills: [] };
-	} finally {
-		rmSync(tempDir, {
-			recursive: true,
-			force: true
+		if ((await $fetch.raw(`https://ungh.cc/repos/${candidate}`).catch(() => null))?.ok) return `https://github.com/${candidate}`;
+	}
+	const searchTerm = packageName.replace(/^@/, "");
+	if (isGhAvailable()) try {
+		const { stdout: json } = spawnSync("gh", [
+			"search",
+			"repos",
+			searchTerm,
+			"--json",
+			"fullName",
+			"--limit",
+			"5"
+		], {
+			encoding: "utf-8",
+			timeout: 15e3
 		});
+		if (!json) throw new Error("no output");
+		const repos = JSON.parse(json);
+		const match = repos.find((r) => r.fullName.toLowerCase().endsWith(`/${packageName.toLowerCase()}`) || r.fullName.toLowerCase().endsWith(`/${shortName.toLowerCase()}`));
+		if (match) return `https://github.com/${match.fullName}`;
+		for (const candidate of repos) {
+			const gh = parseGitHubUrl(`https://github.com/${candidate.fullName}`);
+			if (gh && await verifyNpmRepo(gh.owner, gh.repo, packageName)) return `https://github.com/${candidate.fullName}`;
+		}
+	} catch {}
+	const data = await $fetch(`https://api.github.com/search/repositories?q=${encodeURIComponent(`${searchTerm} in:name`)}&per_page=5`).catch(() => null);
+	if (!data?.items?.length) return null;
+	const match = data.items.find((r) => r.full_name.toLowerCase().endsWith(`/${packageName.toLowerCase()}`) || r.full_name.toLowerCase().endsWith(`/${shortName.toLowerCase()}`));
+	if (match) return `https://github.com/${match.full_name}`;
+	for (const candidate of data.items) {
+		const gh = parseGitHubUrl(`https://github.com/${candidate.full_name}`);
+		if (gh && await verifyNpmRepo(gh.owner, gh.repo, packageName)) return `https://github.com/${candidate.full_name}`;
 	}
-}
-async function fetchLlmsUrl(docsUrl) {
-	const llmsUrl = `${new URL(docsUrl).origin}/llms.txt`;
-	if (await verifyUrl(llmsUrl)) return llmsUrl;
 	return null;
 }
-async function fetchLlmsTxt(url) {
-	const content = await fetchText(url);
-	if (!content || content.length < 50) return null;
-	return {
-		raw: content,
-		links: parseMarkdownLinks(content)
-	};
-}
-function parseMarkdownLinks(content) {
-	return extractLinks(content).filter((l) => l.url.endsWith(".md"));
-}
-function isSafeUrl(url) {
-	try {
-		const parsed = new URL(url);
-		if (parsed.protocol !== "https:") return false;
-		const host = parsed.hostname;
-		if (host === "localhost" || host === "0.0.0.0" || host === "[::1]") return false;
-		if (/^(?:127\.|10\.|172\.(?:1[6-9]|2\d|3[01])\.|192\.168\.|169\.254\.)/.test(host)) return false;
-		if (/^\[(?:f[cd]|fe[89ab]|::ffff:)/i.test(host)) return false;
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function downloadLlmsDocs(llmsContent, baseUrl, onProgress) {
-	const limit = pLimit(5);
-	let completed = 0;
-	return (await Promise.all(llmsContent.links.map((link) => limit(async () => {
-		const url = link.url.startsWith("http") ? link.url : `${baseUrl.replace(/\/$/, "")}${link.url.startsWith("/") ? "" : "/"}${link.url}`;
-		if (!isSafeUrl(url)) return null;
-		const content = await fetchText(url);
-		onProgress?.(link.url, ++completed, llmsContent.links.length);
-		if (content && content.length > 100) return {
-			url: link.url.startsWith("http") ? new URL(link.url).pathname : link.url,
-			title: link.title,
-			content
-		};
-		return null;
-	})))).filter((d) => d !== null);
-}
-function normalizeLlmsLinks(content, baseUrl) {
-	let normalized = content;
-	if (baseUrl) {
-		const escaped = baseUrl.replace(/\/$/, "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-		normalized = normalized.replace(new RegExp(`\\]\\(${escaped}(/[^)]+\\.md)\\)`, "g"), "](./docs$1)");
-	}
-	normalized = normalized.replace(/\]\(\/([^)]+\.md)\)/g, "](./docs/$1)");
-	return normalized;
-}
-function extractSections(content, patterns) {
-	const sections = [];
-	const parts = content.split(/\n---\n/);
-	for (const part of parts) {
-		const urlMatch = part.match(/^url: *(\S.*)$/m);
-		if (!urlMatch) continue;
-		const url = urlMatch[1];
-		if (patterns.some((p) => url.includes(p))) {
-			const contentStart = part.indexOf("\n", part.indexOf("url:"));
-			if (contentStart > -1) sections.push(part.slice(contentStart + 1));
-		}
-	}
-	if (sections.length === 0) return null;
-	return sections.join("\n\n---\n\n");
+async function fetchGitHubRepoMeta(owner, repo, packageName) {
+	const override = packageName ? getDocOverride(packageName) : void 0;
+	if (override?.homepage) return { homepage: override.homepage };
+	const data = await ghApi(`repos/${owner}/${repo}`) ?? await $fetch(`https://api.github.com/repos/${owner}/${repo}`).catch(() => null);
+	return data?.homepage ? { homepage: data.homepage } : null;
 }
-const MIN_GIT_DOCS = 5;
-const isShallowGitDocs = (n) => n > 0 && n < 5;
-async function listFilesAtRef(owner, repo, ref) {
+async function fetchReadme(owner, repo, subdir, ref) {
+	const branch = ref || "main";
 	if (!isKnownPrivateRepo(owner, repo)) {
-		const data = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/files/${ref}`).catch(() => null);
-		if (data?.files?.length) return data.files.map((f) => f.path);
+		const unghUrl = subdir ? `https://ungh.cc/repos/${owner}/${repo}/files/${branch}/${subdir}/README.md` : `https://ungh.cc/repos/${owner}/${repo}/readme${ref ? `?ref=${ref}` : ""}`;
+		if ((await $fetch.raw(unghUrl).catch(() => null))?.ok) return `ungh://${owner}/${repo}${subdir ? `/${subdir}` : ""}${ref ? `@${ref}` : ""}`;
 	}
-	const tree = await ghApi(`repos/${owner}/${repo}/git/trees/${ref}?recursive=1`);
-	if (tree?.tree?.length) {
+	const basePath = subdir ? `${subdir}/` : "";
+	const branches = ref ? [ref] : ["main", "master"];
+	const token = isKnownPrivateRepo(owner, repo) ? getGitHubToken() : null;
+	const authHeaders = token ? { Authorization: `token ${token}` } : {};
+	for (const b of branches) for (const filename of [
+		"README.md",
+		"Readme.md",
+		"readme.md"
+	]) {
+		const readmeUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${b}/${basePath}${filename}`;
+		if ((await $fetch.raw(readmeUrl, { headers: authHeaders }).catch(() => null))?.ok) return readmeUrl;
+	}
+	const refParam = ref ? `?ref=${ref}` : "";
+	const apiData = await ghApi(subdir ? `repos/${owner}/${repo}/contents/${subdir}/README.md${refParam}` : `repos/${owner}/${repo}/readme${refParam}`);
+	if (apiData?.download_url) {
 		markRepoPrivate(owner, repo);
-		return tree.tree.map((f) => f.path);
+		return apiData.download_url;
 	}
-	return [];
+	return null;
 }
-async function findGitTag(owner, repo, version, packageName, branchHint) {
-	const candidates = [`v${version}`, version];
-	if (packageName) candidates.push(`${packageName}@${version}`);
-	for (const tag of candidates) {
-		const files = await listFilesAtRef(owner, repo, tag);
-		if (files.length > 0) return {
-			ref: tag,
-			files
-		};
+async function fetchReadmeContent(url) {
+	if (url.startsWith("file://")) {
+		const filePath = fileURLToPath(url);
+		if (!existsSync(filePath)) return null;
+		return readFileSync(filePath, "utf-8");
 	}
-	if (packageName) {
-		const latestTag = await findLatestReleaseTag(owner, repo, packageName);
-		if (latestTag) {
-			const files = await listFilesAtRef(owner, repo, latestTag);
-			if (files.length > 0) return {
-				ref: latestTag,
-				files
-			};
+	if (url.startsWith("ungh://")) {
+		let path = url.replace("ungh://", "");
+		let ref = "main";
+		const atIdx = path.lastIndexOf("@");
+		if (atIdx !== -1) {
+			ref = path.slice(atIdx + 1);
+			path = path.slice(0, atIdx);
+		}
+		const parts = path.split("/");
+		const owner = parts[0];
+		const repo = parts[1];
+		const subdir = parts.slice(2).join("/");
+		const text = await $fetch(subdir ? `https://ungh.cc/repos/${owner}/${repo}/files/${ref}/${subdir}/README.md` : `https://ungh.cc/repos/${owner}/${repo}/readme?ref=${ref}`, { responseType: "text" }).catch(() => null);
+		if (!text) return null;
+		try {
+			const json = JSON.parse(text);
+			return json.markdown || json.file?.contents || null;
+		} catch {
+			return text;
 		}
 	}
-	const branches = branchHint ? [branchHint, ...["main", "master"].filter((b) => b !== branchHint)] : ["main", "master"];
-	for (const branch of branches) {
-		const files = await listFilesAtRef(owner, repo, branch);
-		if (files.length > 0) return {
-			ref: branch,
-			files,
-			fallback: true
+	if (url.includes("raw.githubusercontent.com")) return fetchGitHubRaw(url);
+	return fetchText(url);
+}
+async function resolveGitHubRepo(owner, repo, onProgress) {
+	onProgress?.("Fetching repo metadata");
+	const repoUrl = `https://github.com/${owner}/${repo}`;
+	const meta = await ghApi(`repos/${owner}/${repo}`) ?? await $fetch(`https://api.github.com/repos/${owner}/${repo}`).catch(() => null);
+	const homepage = meta?.homepage || void 0;
+	const description = meta?.description || void 0;
+	onProgress?.("Fetching latest release");
+	const releases = await fetchUnghReleases(owner, repo);
+	let version = "main";
+	let releasedAt;
+	const latestRelease = releases[0];
+	if (latestRelease) {
+		version = latestRelease.tag.replace(/^v/, "");
+		releasedAt = latestRelease.publishedAt;
+	}
+	onProgress?.("Resolving docs");
+	const gitDocs = await fetchGitDocs(owner, repo, version);
+	const gitDocsUrl = gitDocs ? `${repoUrl}/tree/${gitDocs.ref}/docs` : void 0;
+	const gitRef = gitDocs?.ref;
+	onProgress?.("Fetching README");
+	const readmeUrl = await fetchReadme(owner, repo);
+	let llmsUrl;
+	if (homepage) {
+		onProgress?.("Checking llms.txt");
+		llmsUrl = await fetchLlmsUrl(homepage).catch(() => null) ?? void 0;
+	}
+	if (!gitDocsUrl && !readmeUrl && !llmsUrl) return null;
+	return {
+		name: repo,
+		version: latestRelease ? version : void 0,
+		releasedAt,
+		description,
+		repoUrl,
+		docsUrl: homepage,
+		gitDocsUrl,
+		gitRef,
+		gitDocsFallback: gitDocs?.fallback,
+		readmeUrl: readmeUrl ?? void 0,
+		llmsUrl
+	};
+}
+const VALID_CRATE_NAME = /^[a-z0-9][\w-]*$/;
+const runCratesApiRateLimited = createRateLimitedRunner(1e3);
+function selectCrateVersion(data, requestedVersion) {
+	const versions = data.versions || [];
+	if (requestedVersion) {
+		const exact = versions.find((v) => v.num === requestedVersion && !v.yanked);
+		if (exact?.num) return {
+			version: exact.num,
+			entry: exact
 		};
 	}
+	const crate = data.crate;
+	const preferred = [
+		crate?.max_stable_version,
+		crate?.newest_version,
+		crate?.max_version,
+		crate?.default_version
+	].find(Boolean);
+	if (preferred) {
+		const match = versions.find((v) => v.num === preferred && !v.yanked);
+		if (match?.num) return {
+			version: preferred,
+			entry: match
+		};
+		if (versions.length === 0) return { version: preferred };
+	}
+	const firstStable = versions.find((v) => !v.yanked && v.num);
+	if (firstStable?.num) return {
+		version: firstStable.num,
+		entry: firstStable
+	};
 	return null;
 }
-async function fetchUnghReleases(owner, repo) {
-	if (!isKnownPrivateRepo(owner, repo)) {
-		const data = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/releases`).catch(() => null);
-		if (data?.releases?.length) return data.releases;
+function pickPreferredUrl(...urls) {
+	return urls.map((v) => v?.trim()).find((v) => !!v);
+}
+async function fetchCratesApi(url) {
+	return runCratesApiRateLimited(() => $fetch(url).catch(() => null));
+}
+async function resolveCrateDocsWithAttempts(crateName, options = {}) {
+	const attempts = [];
+	const onProgress = options.onProgress;
+	const normalizedName = crateName.trim().toLowerCase();
+	if (!normalizedName || !VALID_CRATE_NAME.test(normalizedName)) {
+		attempts.push({
+			source: "crates",
+			status: "error",
+			message: `Invalid crate name: ${crateName}`
+		});
+		return {
+			package: null,
+			attempts
+		};
 	}
-	const raw = await ghApiPaginated(`repos/${owner}/${repo}/releases`);
-	if (raw.length > 0) {
-		markRepoPrivate(owner, repo);
-		return raw.map((r) => ({
-			tag: r.tag_name,
-			publishedAt: r.published_at
-		}));
+	onProgress?.("crates.io metadata");
+	const apiUrl = `https://crates.io/api/v1/crates/${encodeURIComponent(normalizedName)}`;
+	const data = await fetchCratesApi(apiUrl);
+	if (!data?.crate) {
+		attempts.push({
+			source: "crates",
+			url: apiUrl,
+			status: "not-found",
+			message: "Crate not found on crates.io"
+		});
+		return {
+			package: null,
+			attempts
+		};
 	}
-	return [];
-}
-async function findLatestReleaseTag(owner, repo, packageName) {
-	const prefix = `${packageName}@`;
-	return (await fetchUnghReleases(owner, repo)).find((r) => r.tag.startsWith(prefix))?.tag ?? null;
+	attempts.push({
+		source: "crates",
+		url: apiUrl,
+		status: "success",
+		message: `Found crate: ${data.crate.name || normalizedName}`
+	});
+	const selected = selectCrateVersion(data, options.version);
+	if (!selected) {
+		attempts.push({
+			source: "crates",
+			url: apiUrl,
+			status: "error",
+			message: "No usable crate versions found"
+		});
+		return {
+			package: null,
+			attempts
+		};
+	}
+	const version = selected.version;
+	const versionEntry = selected.entry;
+	const docsRsUrl = `https://docs.rs/${encodeURIComponent(normalizedName)}/${encodeURIComponent(version)}`;
+	const repositoryRaw = pickPreferredUrl(versionEntry?.repository, data.crate.repository);
+	const homepage = pickPreferredUrl(versionEntry?.homepage, data.crate.homepage);
+	const documentation = pickPreferredUrl(versionEntry?.documentation, data.crate.documentation);
+	const normalizedRepo = repositoryRaw ? normalizeRepoUrl(repositoryRaw) : void 0;
+	const repoUrl = normalizedRepo && isLikelyCodeHostUrl(normalizedRepo) ? normalizedRepo : isLikelyCodeHostUrl(homepage) ? homepage : void 0;
+	let resolved = {
+		name: normalizedName,
+		version,
+		releasedAt: versionEntry?.created_at || data.crate.updated_at || void 0,
+		description: versionEntry?.description || data.crate.description,
+		docsUrl: (() => {
+			if (documentation && !isUselessDocsUrl(documentation) && !isLikelyCodeHostUrl(documentation)) return documentation;
+			if (homepage && !isUselessDocsUrl(homepage) && !isLikelyCodeHostUrl(homepage)) return homepage;
+			return docsRsUrl;
+		})(),
+		repoUrl
+	};
+	const gh = repoUrl ? parseGitHubUrl(repoUrl) : null;
+	if (gh) {
+		onProgress?.("GitHub enrichment");
+		const ghResolved = await resolveGitHubRepo(gh.owner, gh.repo);
+		if (ghResolved) {
+			attempts.push({
+				source: "github-meta",
+				url: repoUrl,
+				status: "success",
+				message: "Enriched via GitHub repo metadata"
+			});
+			resolved = {
+				...ghResolved,
+				name: normalizedName,
+				version,
+				releasedAt: resolved.releasedAt || ghResolved.releasedAt,
+				description: resolved.description || ghResolved.description,
+				docsUrl: resolved.docsUrl || ghResolved.docsUrl,
+				repoUrl,
+				readmeUrl: ghResolved.readmeUrl || resolved.readmeUrl
+			};
+		} else attempts.push({
+			source: "github-meta",
+			url: repoUrl,
+			status: "not-found",
+			message: "GitHub enrichment failed, using crates.io metadata"
+		});
+	}
+	if (!resolved.llmsUrl && resolved.docsUrl) {
+		onProgress?.("llms.txt discovery");
+		resolved.llmsUrl = await fetchLlmsUrl(resolved.docsUrl).catch(() => null) ?? void 0;
+		if (resolved.llmsUrl) attempts.push({
+			source: "llms.txt",
+			url: resolved.llmsUrl,
+			status: "success"
+		});
+	}
+	return {
+		package: resolved,
+		attempts
+	};
 }
-function filterDocFiles(files, pathPrefix) {
-	return files.filter((f) => f.startsWith(pathPrefix) && /\.(?:md|mdx)$/.test(f));
+async function fetchCrawledDocs(url, onProgress, maxPages = 200) {
+	const outputDir = join(tmpdir(), "skilld-crawl", Date.now().toString());
+	onProgress?.(`Crawling ${url}`);
+	const userLang = getUserLang();
+	const foreignUrls = /* @__PURE__ */ new Set();
+	const doCrawl = () => crawlAndGenerate({
+		urls: [url],
+		outputDir,
+		driver: "http",
+		generateLlmsTxt: false,
+		generateIndividualMd: true,
+		maxRequestsPerCrawl: maxPages,
+		onPage: (page) => {
+			const lang = extractHtmlLang(page.html);
+			if (lang && !lang.startsWith("en") && !lang.startsWith(userLang)) foreignUrls.add(page.url);
+		}
+	}, (progress) => {
+		if (progress.crawling.status === "processing" && progress.crawling.total > 0) onProgress?.(`Crawling ${progress.crawling.processed}/${progress.crawling.total} pages`);
+	});
+	let results = await doCrawl().catch((err) => {
+		onProgress?.(`Crawl failed: ${err?.message || err}`);
+		return [];
+	});
+	if (results.length === 0) {
+		onProgress?.("Retrying crawl");
+		results = await doCrawl().catch(() => []);
+	}
+	rmSync(outputDir, {
+		recursive: true,
+		force: true
+	});
+	const docs = [];
+	let localeFiltered = 0;
+	for (const result of results) {
+		if (!result.success || !result.content) continue;
+		if (foreignUrls.has(result.url)) {
+			localeFiltered++;
+			continue;
+		}
+		const segments = (new URL(result.url).pathname.replace(/\/$/, "") || "/index").split("/").filter(Boolean);
+		if (isForeignPathPrefix(segments[0], userLang)) {
+			localeFiltered++;
+			continue;
+		}
+		const path = `docs/${segments.join("/")}.md`;
+		docs.push({
+			path,
+			content: result.content
+		});
+	}
+	if (localeFiltered > 0) onProgress?.(`Filtered ${localeFiltered} foreign locale pages`);
+	onProgress?.(`Crawled ${docs.length} pages`);
+	return docs;
 }
-const FRAMEWORK_NAMES = new Set([
-	"vue",
-	"react",
-	"solid",
-	"angular",
-	"svelte",
-	"preact",
-	"lit",
-	"qwik"
-]);
-function filterFrameworkDocs(files, packageName) {
-	if (!packageName) return files;
-	const shortName = packageName.replace(/^@.*\//, "");
-	const targetFramework = [...FRAMEWORK_NAMES].find((fw) => shortName.includes(fw));
-	if (!targetFramework) return files;
-	const otherFrameworks = [...FRAMEWORK_NAMES].filter((fw) => fw !== targetFramework);
-	const excludePattern = new RegExp(`\\b(?:${otherFrameworks.join("|")})\\b`);
-	return files.filter((f) => !excludePattern.test(f));
+const HTML_LANG_RE = /<html[^>]*\slang=["']([^"']+)["']/i;
+function extractHtmlLang(html) {
+	return HTML_LANG_RE.exec(html)?.[1]?.toLowerCase();
 }
-const NOISE_PATTERNS = [
-	/^\.changeset\//,
-	/CHANGELOG\.md$/i,
-	/CONTRIBUTING\.md$/i,
-	/^\.github\//
-];
-const EXCLUDE_DIRS = new Set([
-	"test",
-	"tests",
-	"__tests__",
-	"fixtures",
-	"fixture",
-	"examples",
-	"example",
-	"node_modules",
-	".git",
-	"dist",
-	"build",
-	"coverage",
-	"e2e",
-	"spec",
-	"mocks",
-	"__mocks__"
-]);
-const DOC_DIR_BONUS = new Set([
-	"docs",
-	"documentation",
-	"pages",
-	"content",
-	"website",
-	"guide",
-	"guides",
-	"wiki",
-	"manual",
-	"api"
+const LOCALE_CODES = new Set([
+	"ar",
+	"de",
+	"es",
+	"fr",
+	"id",
+	"it",
+	"ja",
+	"ko",
+	"nl",
+	"pl",
+	"pt",
+	"pt-br",
+	"ru",
+	"th",
+	"tr",
+	"uk",
+	"vi",
+	"zh",
+	"zh-cn",
+	"zh-tw"
 ]);
-function hasExcludedDir(path) {
-	return path.split("/").some((p) => EXCLUDE_DIRS.has(p.toLowerCase()));
+function isForeignPathPrefix(segment, userLang) {
+	if (!segment) return false;
+	const lower = segment.toLowerCase();
+	if (lower === "en" || lower.startsWith(userLang)) return false;
+	return LOCALE_CODES.has(lower);
 }
-function getPathDepth(path) {
-	return path.split("/").filter(Boolean).length;
+function getUserLang() {
+	const code = (process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || "").split(/[_.:-]/)[0]?.toLowerCase() || "";
+	return code.length >= 2 ? code.slice(0, 2) : "en";
 }
-function hasDocDirBonus(path) {
-	return path.split("/").some((p) => DOC_DIR_BONUS.has(p.toLowerCase()));
+function toCrawlPattern(docsUrl) {
+	return `${docsUrl.replace(/\/+$/, "")}/**`;
 }
-function scoreDocDir(dir, fileCount) {
-	const depth = getPathDepth(dir) || 1;
-	return fileCount * (hasDocDirBonus(dir) ? 1.5 : 1) / depth;
+const HIGH_VALUE_CATEGORIES = new Set([
+	"q&a",
+	"help",
+	"troubleshooting",
+	"support"
+]);
+const LOW_VALUE_CATEGORIES = new Set([
+	"show and tell",
+	"ideas",
+	"polls"
+]);
+const TITLE_NOISE_RE = /looking .*(?:developer|engineer|freelanc)|hiring|job post|guide me to (?:complete|finish|build)|help me (?:complete|finish|build)|seeking .* tutorial|recommend.* course/i;
+const MIN_DISCUSSION_SCORE = 3;
+function scoreComment(c) {
+	return (c.isMaintainer ? 3 : 1) * (hasCodeBlock(c.body) ? 2 : 1) * (1 + c.reactions);
 }
-function discoverDocFiles(allFiles, packageName) {
-	const mdFiles = allFiles.filter((f) => /\.(?:md|mdx)$/.test(f)).filter((f) => !NOISE_PATTERNS.some((p) => p.test(f))).filter((f) => f.includes("/"));
-	if (packageName?.includes("/")) {
-		const subPkgPrefix = `packages/${packageName.split("/").pop().toLowerCase()}/`;
-		const subPkgFiles = mdFiles.filter((f) => f.startsWith(subPkgPrefix));
-		if (subPkgFiles.length >= 3) return {
-			files: subPkgFiles,
-			prefix: subPkgPrefix
-		};
+function scoreDiscussion(d) {
+	if (TITLE_NOISE_RE.test(d.title)) return -1;
+	let score = 0;
+	if (d.isMaintainer) score += 3;
+	if (hasCodeBlock([
+		d.body,
+		d.answer || "",
+		...d.topComments.map((c) => c.body)
+	].join("\n"))) score += 3;
+	score += Math.min(d.upvoteCount, 5);
+	if (d.answer) {
+		score += 2;
+		if (d.answer.length > 100) score += 1;
 	}
-	const docsGroups = /* @__PURE__ */ new Map();
-	for (const file of mdFiles) {
-		const docsIdx = file.lastIndexOf("/docs/");
-		if (docsIdx === -1) continue;
-		mapInsert(docsGroups, file.slice(0, docsIdx + 6), () => []).push(file);
+	if (d.topComments.some((c) => c.isMaintainer)) score += 2;
+	if (d.topComments.some((c) => c.reactions > 0)) score += 1;
+	return score;
+}
+async function fetchGitHubDiscussions(owner, repo, limit = 20, releasedAt, fromDate) {
+	if (!isGhAvailable()) return [];
+	if (!fromDate && releasedAt) {
+		const cutoff = new Date(releasedAt);
+		cutoff.setMonth(cutoff.getMonth() + 6);
+		if (cutoff < /* @__PURE__ */ new Date()) return [];
 	}
-	if (docsGroups.size > 0) {
-		const largest = [...docsGroups.entries()].sort((a, b) => b[1].length - a[1].length)[0];
-		if (largest[1].length >= 3) {
-			const fullPrefix = largest[0];
-			const docsIdx = fullPrefix.lastIndexOf("docs/");
-			const stripPrefix = docsIdx > 0 ? fullPrefix.slice(0, docsIdx) : "";
+	try {
+		const { stdout: result } = spawnSync("gh", [
+			"api",
+			"graphql",
+			"-f",
+			`query=${`query($owner: String!, $repo: String!) { repository(owner: $owner, name: $repo) { discussions(first: ${Math.min(limit * 3, 80)}, orderBy: {field: CREATED_AT, direction: DESC}) { nodes { number title body category { name } createdAt url upvoteCount comments(first: 10) { totalCount nodes { body author { login } authorAssociation reactions { totalCount } } } answer { body author { login } authorAssociation } author { login } authorAssociation } } } }`}`,
+			"-f",
+			`owner=${owner}`,
+			"-f",
+			`repo=${repo}`
+		], {
+			encoding: "utf-8",
+			maxBuffer: 10 * 1024 * 1024
+		});
+		if (!result) return [];
+		const nodes = JSON.parse(result)?.data?.repository?.discussions?.nodes;
+		if (!Array.isArray(nodes)) return [];
+		const fromTs = fromDate ? new Date(fromDate).getTime() : null;
+		return nodes.filter((d) => d.author && !BOT_USERS.has(d.author.login)).filter((d) => {
+			const cat = (d.category?.name || "").toLowerCase();
+			return !LOW_VALUE_CATEGORIES.has(cat);
+		}).filter((d) => !fromTs || new Date(d.createdAt).getTime() >= fromTs).map((d) => {
+			let answer;
+			if (d.answer?.body) {
+				const isMaintainer = [
+					"OWNER",
+					"MEMBER",
+					"COLLABORATOR"
+				].includes(d.answer.authorAssociation);
+				const author = d.answer.author?.login;
+				answer = `${isMaintainer && author ? `**@${author}** [maintainer]:\n\n` : ""}${d.answer.body}`;
+			}
+			const comments = (d.comments?.nodes || []).filter((c) => c.author && !BOT_USERS.has(c.author.login)).filter((c) => !COMMENT_NOISE_RE.test((c.body || "").trim())).map((c) => {
+				const isMaintainer = [
+					"OWNER",
+					"MEMBER",
+					"COLLABORATOR"
+				].includes(c.authorAssociation);
+				return {
+					body: c.body || "",
+					author: c.author.login,
+					reactions: c.reactions?.totalCount || 0,
+					isMaintainer
+				};
+			}).sort((a, b) => scoreComment(b) - scoreComment(a)).slice(0, 3);
 			return {
-				files: largest[1],
-				prefix: stripPrefix
+				number: d.number,
+				title: d.title,
+				body: d.body || "",
+				category: d.category?.name || "",
+				createdAt: d.createdAt,
+				url: d.url,
+				upvoteCount: d.upvoteCount || 0,
+				comments: d.comments?.totalCount || 0,
+				isMaintainer: [
+					"OWNER",
+					"MEMBER",
+					"COLLABORATOR"
+				].includes(d.authorAssociation),
+				answer,
+				topComments: comments
 			};
-		}
-	}
-	const dirGroups = /* @__PURE__ */ new Map();
-	for (const file of mdFiles) {
-		if (hasExcludedDir(file)) continue;
-		const lastSlash = file.lastIndexOf("/");
-		if (lastSlash === -1) continue;
-		mapInsert(dirGroups, file.slice(0, lastSlash + 1), () => []).push(file);
+		}).map((d) => ({
+			d,
+			score: scoreDiscussion(d)
+		})).filter(({ score }) => score >= MIN_DISCUSSION_SCORE).sort((a, b) => {
+			const aHigh = HIGH_VALUE_CATEGORIES.has(a.d.category.toLowerCase()) ? 1 : 0;
+			const bHigh = HIGH_VALUE_CATEGORIES.has(b.d.category.toLowerCase()) ? 1 : 0;
+			if (aHigh !== bHigh) return bHigh - aHigh;
+			return b.score - a.score;
+		}).slice(0, limit).map(({ d }) => d);
+	} catch {
+		return [];
 	}
-	if (dirGroups.size === 0) return null;
-	const scored = Array.from(dirGroups.entries(), ([dir, files]) => ({
-		dir,
-		files,
-		score: scoreDocDir(dir, files.length)
-	})).filter((d) => d.files.length >= 5).sort((a, b) => b.score - a.score);
-	if (scored.length === 0) return null;
-	const best = scored[0];
-	return {
-		files: best.files,
-		prefix: best.dir
-	};
-}
-async function listDocsAtRef(owner, repo, ref, pathPrefix = "docs/") {
-	return filterDocFiles(await listFilesAtRef(owner, repo, ref), pathPrefix);
 }
-async function fetchGitDocs(owner, repo, version, packageName, repoUrl) {
-	const override = packageName ? getDocOverride(packageName) : void 0;
-	if (override) {
-		const ref = override.ref || "main";
-		const fallback = !override.ref;
-		const files = await listDocsAtRef(override.owner, override.repo, ref, `${override.path}/`);
-		if (files.length === 0) return null;
-		return {
-			baseUrl: `https://raw.githubusercontent.com/${override.owner}/${override.repo}/${ref}`,
-			ref,
-			files,
-			fallback,
-			docsPrefix: `${override.path}/` !== "docs/" ? `${override.path}/` : void 0
-		};
-	}
-	const tag = await findGitTag(owner, repo, version, packageName, repoUrl ? extractBranchHint(repoUrl) : void 0);
-	if (!tag) return null;
-	let docs = filterDocFiles(tag.files, "docs/");
-	let docsPrefix;
-	let allFiles;
-	if (docs.length === 0) {
-		const discovered = discoverDocFiles(tag.files, packageName);
-		if (discovered) {
-			docs = discovered.files;
-			docsPrefix = discovered.prefix || void 0;
-			allFiles = tag.files;
+function formatDiscussionAsMarkdown(d) {
+	const fm = buildFrontmatter({
+		number: d.number,
+		title: d.title,
+		category: d.category,
+		created: isoDate(d.createdAt),
+		url: d.url,
+		upvotes: d.upvoteCount,
+		comments: d.comments,
+		answered: !!d.answer
+	});
+	const bodyLimit = d.upvoteCount >= 5 ? 1500 : 800;
+	const lines = [
+		fm,
+		"",
+		`# ${d.title}`
+	];
+	if (d.body) lines.push("", truncateBody(d.body, bodyLimit));
+	if (d.answer) lines.push("", "---", "", "## Accepted Answer", "", truncateBody(d.answer, 1e3));
+	else if (d.topComments.length > 0) {
+		lines.push("", "---", "", "## Top Comments");
+		for (const c of d.topComments) {
+			const reactions = c.reactions > 0 ? ` (+${c.reactions})` : "";
+			const maintainer = c.isMaintainer ? " [maintainer]" : "";
+			lines.push("", `**@${c.author}**${maintainer}${reactions}:`, "", truncateBody(c.body, 600));
 		}
 	}
-	docs = filterFrameworkDocs(docs, packageName);
-	if (docs.length === 0) return null;
-	return {
-		baseUrl: `https://raw.githubusercontent.com/${owner}/${repo}/${tag.ref}`,
-		ref: tag.ref,
-		files: docs,
-		docsPrefix,
-		allFiles,
-		fallback: tag.fallback
-	};
-}
-function normalizePath(p) {
-	return p.replace(/^\//, "").replace(/\.(?:md|mdx)$/, "");
+	return lines.join("\n");
 }
-function validateGitDocsWithLlms(llmsLinks, repoFiles) {
-	if (llmsLinks.length === 0) return {
-		isValid: true,
-		matchRatio: 1
-	};
-	const sample = llmsLinks.slice(0, 10);
-	const normalizedLinks = sample.map((link) => {
-		let path = link.url;
-		if (path.startsWith("http")) try {
-			path = new URL(path).pathname;
-		} catch {}
-		return normalizePath(path);
+function generateDiscussionIndex(discussions) {
+	const byCategory = /* @__PURE__ */ new Map();
+	for (const d of discussions) mapInsert(byCategory, d.category || "Uncategorized", () => []).push(d);
+	const answered = discussions.filter((d) => d.answer).length;
+	const sections = [
+		[
+			"---",
+			`total: ${discussions.length}`,
+			`answered: ${answered}`,
+			"---"
+		].join("\n"),
+		"",
+		"# Discussions Index",
+		""
+	];
+	const cats = [...byCategory.keys()].sort((a, b) => {
+		return (HIGH_VALUE_CATEGORIES.has(a.toLowerCase()) ? 0 : 1) - (HIGH_VALUE_CATEGORIES.has(b.toLowerCase()) ? 0 : 1) || a.localeCompare(b);
 	});
-	const repoNormalized = new Set(repoFiles.map(normalizePath));
-	let matches = 0;
-	for (const linkPath of normalizedLinks) for (const repoPath of repoNormalized) if (repoPath === linkPath || repoPath.endsWith(`/${linkPath}`)) {
-		matches++;
-		break;
+	for (const cat of cats) {
+		const group = byCategory.get(cat);
+		sections.push(`## ${cat} (${group.length})`, "");
+		for (const d of group) {
+			const upvotes = d.upvoteCount > 0 ? ` (+${d.upvoteCount})` : "";
+			const answered = d.answer ? " [answered]" : "";
+			const date = isoDate(d.createdAt);
+			sections.push(`- [#${d.number}](./discussion-${d.number}.md): ${d.title}${upvotes}${answered} (${date})`);
+		}
+		sections.push("");
 	}
-	const matchRatio = matches / sample.length;
-	return {
-		isValid: matchRatio >= .3,
-		matchRatio
-	};
+	return sections.join("\n");
 }
-async function verifyNpmRepo(owner, repo, packageName) {
-	const base = `https://raw.githubusercontent.com/${owner}/${repo}/HEAD`;
-	const paths = [
-		"package.json",
-		`packages/${packageName.replace(/^@.*\//, "")}/package.json`,
-		`packages/${packageName.replace(/^@/, "").replace("/", "-")}/package.json`
+function generateDocsIndex(docs) {
+	const docFiles = docs.filter((d) => d.path.startsWith("docs/") && d.path.endsWith(".md") && !d.path.endsWith("_INDEX.md")).sort((a, b) => a.path.localeCompare(b.path));
+	if (docFiles.length === 0) return "";
+	const rootFiles = [];
+	const byDir = /* @__PURE__ */ new Map();
+	for (const doc of docFiles) {
+		const rel = doc.path.slice(5);
+		const dir = rel.includes("/") ? rel.slice(0, rel.lastIndexOf("/")) : "";
+		if (!dir) rootFiles.push(doc);
+		else {
+			const list = byDir.get(dir);
+			if (list) list.push(doc);
+			else byDir.set(dir, [doc]);
+		}
+	}
+	const sections = [
+		"---",
+		`total: ${docFiles.length}`,
+		"---",
+		"",
+		"# Docs Index",
+		""
 	];
-	for (const path of paths) {
-		const text = await fetchGitHubRaw(`${base}/${path}`);
-		if (!text) continue;
-		try {
-			if (JSON.parse(text).name === packageName) return true;
-		} catch {}
+	for (const file of rootFiles) {
+		const rel = file.path.slice(5);
+		const title = extractTitle(file.content) || rel.replace(/\.md$/, "");
+		const desc = extractDescription(file.content);
+		const descPart = desc ? `: ${desc}` : "";
+		sections.push(`- [${title}](./${rel})${descPart}`);
 	}
-	return false;
+	if (rootFiles.length > 0) sections.push("");
+	for (const [dir, files] of byDir) {
+		sections.push(`## ${dir} (${files.length})`, "");
+		for (const file of files) {
+			const rel = file.path.slice(5);
+			const title = extractTitle(file.content) || rel.replace(/\.md$/, "").split("/").pop();
+			const desc = extractDescription(file.content);
+			const descPart = desc ? `: ${desc}` : "";
+			sections.push(`- [${title}](./${rel})${descPart}`);
+		}
+		sections.push("");
+	}
+	return sections.join("\n");
 }
-async function searchGitHubRepo(packageName) {
-	const shortName = packageName.replace(/^@.*\//, "");
-	for (const candidate of [packageName.replace(/^@/, "").replace("/", "/"), shortName]) {
-		if (!candidate.includes("/")) {
-			if ((await $fetch.raw(`https://ungh.cc/repos/${shortName}/${shortName}`).catch(() => null))?.ok) return `https://github.com/${shortName}/${shortName}`;
+const SKIP_DIRS = [
+	"node_modules",
+	"_vendor",
+	"__tests__",
+	"__mocks__",
+	"__fixtures__",
+	"test",
+	"tests",
+	"fixture",
+	"fixtures",
+	"locales",
+	"locale",
+	"i18n",
+	".git"
+];
+const SKIP_PATTERNS = [
+	"*.min.*",
+	"*.prod.*",
+	"*.global.*",
+	"*.browser.*",
+	"*.map",
+	"*.map.js",
+	"CHANGELOG*",
+	"LICENSE*",
+	"README*"
+];
+const MAX_FILE_SIZE = 500 * 1024;
+async function resolveEntryFiles(packageDir) {
+	if (!existsSync(join(packageDir, "package.json"))) return [];
+	const files = await glob(["**/*.d.{ts,mts,cts}"], {
+		cwd: packageDir,
+		ignore: [...SKIP_DIRS.map((d) => `**/${d}/**`), ...SKIP_PATTERNS],
+		absolute: false,
+		expandDirectories: false
+	});
+	const entries = [];
+	for (const file of files) {
+		const absPath = join(packageDir, file);
+		let content;
+		try {
+			content = readFileSync(absPath, "utf-8");
+		} catch {
 			continue;
 		}
-		if ((await $fetch.raw(`https://ungh.cc/repos/${candidate}`).catch(() => null))?.ok) return `https://github.com/${candidate}`;
-	}
-	const searchTerm = packageName.replace(/^@/, "");
-	if (isGhAvailable()) try {
-		const { stdout: json } = spawnSync("gh", [
-			"search",
-			"repos",
-			searchTerm,
-			"--json",
-			"fullName",
-			"--limit",
-			"5"
-		], {
-			encoding: "utf-8",
-			timeout: 15e3
+		if (content.length > MAX_FILE_SIZE) continue;
+		entries.push({
+			path: file,
+			content,
+			type: "types"
 		});
-		if (!json) throw new Error("no output");
-		const repos = JSON.parse(json);
-		const match = repos.find((r) => r.fullName.toLowerCase().endsWith(`/${packageName.toLowerCase()}`) || r.fullName.toLowerCase().endsWith(`/${shortName.toLowerCase()}`));
-		if (match) return `https://github.com/${match.fullName}`;
-		for (const candidate of repos) {
-			const gh = parseGitHubUrl(`https://github.com/${candidate.fullName}`);
-			if (gh && await verifyNpmRepo(gh.owner, gh.repo, packageName)) return `https://github.com/${candidate.fullName}`;
+	}
+	return entries;
+}
+function parseGitSkillInput(input) {
+	const trimmed = input.trim();
+	if (trimmed.startsWith("@")) return null;
+	if (trimmed.startsWith("./") || trimmed.startsWith("../") || trimmed.startsWith("/") || trimmed.startsWith("~")) return {
+		type: "local",
+		localPath: trimmed.startsWith("~") ? resolve(process.env.HOME || "", trimmed.slice(1)) : resolve(trimmed)
+	};
+	if (trimmed.startsWith("git@")) {
+		const gh = parseGitHubUrl(normalizeRepoUrl(trimmed));
+		if (gh) return {
+			type: "github",
+			owner: gh.owner,
+			repo: gh.repo
+		};
+		return null;
+	}
+	if (trimmed.startsWith("https://") || trimmed.startsWith("http://")) return parseGitUrl(trimmed);
+	if (/^[\w.-]+\/[\w.-]+$/.test(trimmed)) return {
+		type: "github",
+		owner: trimmed.split("/")[0],
+		repo: trimmed.split("/")[1]
+	};
+	return null;
+}
+function parseGitUrl(url) {
+	try {
+		const parsed = new URL(url);
+		if (parsed.hostname === "github.com" || parsed.hostname === "www.github.com") {
+			const parts = parsed.pathname.replace(/^\//, "").replace(/\.git$/, "").split("/");
+			const owner = parts[0];
+			const repo = parts[1];
+			if (!owner || !repo) return null;
+			if (parts[2] === "tree" && parts.length >= 4) return {
+				type: "github",
+				owner,
+				repo,
+				ref: parts[3],
+				skillPath: parts.length > 4 ? parts.slice(4).join("/") : void 0
+			};
+			return {
+				type: "github",
+				owner,
+				repo
+			};
 		}
-	} catch {}
-	const data = await $fetch(`https://api.github.com/search/repositories?q=${encodeURIComponent(`${searchTerm} in:name`)}&per_page=5`).catch(() => null);
-	if (!data?.items?.length) return null;
-	const match = data.items.find((r) => r.full_name.toLowerCase().endsWith(`/${packageName.toLowerCase()}`) || r.full_name.toLowerCase().endsWith(`/${shortName.toLowerCase()}`));
-	if (match) return `https://github.com/${match.full_name}`;
-	for (const candidate of data.items) {
-		const gh = parseGitHubUrl(`https://github.com/${candidate.full_name}`);
-		if (gh && await verifyNpmRepo(gh.owner, gh.repo, packageName)) return `https://github.com/${candidate.full_name}`;
+		if (parsed.hostname === "gitlab.com") {
+			const parts = parsed.pathname.replace(/^\//, "").replace(/\.git$/, "").split("/");
+			const owner = parts[0];
+			const repo = parts[1];
+			if (!owner || !repo) return null;
+			return {
+				type: "gitlab",
+				owner,
+				repo
+			};
+		}
+		return null;
+	} catch {
+		return null;
 	}
-	return null;
 }
-async function fetchGitHubRepoMeta(owner, repo, packageName) {
-	const override = packageName ? getDocOverride(packageName) : void 0;
-	if (override?.homepage) return { homepage: override.homepage };
-	const data = await ghApi(`repos/${owner}/${repo}`) ?? await $fetch(`https://api.github.com/repos/${owner}/${repo}`).catch(() => null);
-	return data?.homepage ? { homepage: data.homepage } : null;
+function parseSkillFrontmatterName(content) {
+	const fm = parseFrontmatter(content);
+	return {
+		name: fm.name,
+		description: fm.description
+	};
 }
-async function fetchReadme(owner, repo, subdir, ref) {
-	const branch = ref || "main";
-	if (!isKnownPrivateRepo(owner, repo)) {
-		const unghUrl = subdir ? `https://ungh.cc/repos/${owner}/${repo}/files/${branch}/${subdir}/README.md` : `https://ungh.cc/repos/${owner}/${repo}/readme${ref ? `?ref=${ref}` : ""}`;
-		if ((await $fetch.raw(unghUrl).catch(() => null))?.ok) return `ungh://${owner}/${repo}${subdir ? `/${subdir}` : ""}${ref ? `@${ref}` : ""}`;
+function collectFiles(dir, prefix = "") {
+	const files = [];
+	if (!existsSync(dir)) return files;
+	for (const entry of readdirSync(dir, { withFileTypes: true })) {
+		const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+		const fullPath = resolve(dir, entry.name);
+		if (entry.isDirectory()) files.push(...collectFiles(fullPath, relPath));
+		else if (entry.isFile()) files.push({
+			path: relPath,
+			content: readFileSync(fullPath, "utf-8")
+		});
 	}
-	const basePath = subdir ? `${subdir}/` : "";
-	const branches = ref ? [ref] : ["main", "master"];
-	const token = isKnownPrivateRepo(owner, repo) ? getGitHubToken() : null;
-	const authHeaders = token ? { Authorization: `token ${token}` } : {};
-	for (const b of branches) for (const filename of [
-		"README.md",
-		"Readme.md",
-		"readme.md"
-	]) {
-		const readmeUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${b}/${basePath}${filename}`;
-		if ((await $fetch.raw(readmeUrl, { headers: authHeaders }).catch(() => null))?.ok) return readmeUrl;
+	return files;
+}
+async function fetchGitSkills(source, onProgress) {
+	if (source.type === "local") return fetchLocalSkills(source);
+	if (source.type === "github") return fetchGitHubSkills(source, onProgress);
+	if (source.type === "gitlab") return fetchGitLabSkills(source, onProgress);
+	return { skills: [] };
+}
+function fetchLocalSkills(source) {
+	const base = source.localPath;
+	if (!existsSync(base)) return { skills: [] };
+	const skills = [];
+	const skillsDir = resolve(base, "skills");
+	if (existsSync(skillsDir)) for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+		if (!entry.isDirectory()) continue;
+		const skill = readLocalSkill(resolve(skillsDir, entry.name), `skills/${entry.name}`);
+		if (skill) skills.push(skill);
 	}
-	const refParam = ref ? `?ref=${ref}` : "";
-	const apiData = await ghApi(subdir ? `repos/${owner}/${repo}/contents/${subdir}/README.md${refParam}` : `repos/${owner}/${repo}/readme${refParam}`);
-	if (apiData?.download_url) {
-		markRepoPrivate(owner, repo);
-		return apiData.download_url;
+	if (skills.length === 0) {
+		const skill = readLocalSkill(base, "");
+		if (skill) skills.push(skill);
 	}
-	return null;
+	return { skills };
 }
-async function fetchReadmeContent(url) {
-	if (url.startsWith("file://")) {
-		const filePath = fileURLToPath(url);
-		if (!existsSync(filePath)) return null;
-		return readFileSync(filePath, "utf-8");
+function readLocalSkill(dir, repoPath) {
+	const skillMdPath = resolve(dir, "SKILL.md");
+	if (!existsSync(skillMdPath)) return null;
+	const content = readFileSync(skillMdPath, "utf-8");
+	const frontmatter = parseSkillFrontmatterName(content);
+	const dirName = dir.split("/").pop();
+	const name = frontmatter.name || dirName;
+	const files = collectFiles(dir).filter((f) => f.path !== "SKILL.md");
+	return {
+		name,
+		description: frontmatter.description || "",
+		path: repoPath,
+		content,
+		files
+	};
+}
+async function fetchGitHubSkills(source, onProgress) {
+	const { owner, repo } = source;
+	if (!owner || !repo) return { skills: [] };
+	const ref = source.ref || "main";
+	const refs = ref === "main" ? ["main", "master"] : [ref];
+	for (const tryRef of refs) {
+		const skills = await downloadGitHubSkills(owner, repo, tryRef, source.skillPath, onProgress);
+		if (skills.length > 0) return { skills };
 	}
-	if (url.startsWith("ungh://")) {
-		let path = url.replace("ungh://", "");
-		let ref = "main";
-		const atIdx = path.lastIndexOf("@");
-		if (atIdx !== -1) {
-			ref = path.slice(atIdx + 1);
-			path = path.slice(0, atIdx);
+	return { skills: [] };
+}
+async function downloadGitHubSkills(owner, repo, ref, skillPath, onProgress) {
+	const tempDir = join(tmpdir(), `skilld-${Date.now()}`);
+	try {
+		if (skillPath) {
+			onProgress?.(`Downloading ${owner}/${repo}/${skillPath}@${ref}`);
+			const { dir } = await downloadTemplate(`github:${owner}/${repo}/${skillPath}#${ref}`, {
+				dir: tempDir,
+				force: true,
+				auth: getGitHubToken() || void 0
+			});
+			const skill = readLocalSkill(dir, skillPath);
+			return skill ? [skill] : [];
 		}
-		const parts = path.split("/");
-		const owner = parts[0];
-		const repo = parts[1];
-		const subdir = parts.slice(2).join("/");
-		const text = await $fetch(subdir ? `https://ungh.cc/repos/${owner}/${repo}/files/${ref}/${subdir}/README.md` : `https://ungh.cc/repos/${owner}/${repo}/readme?ref=${ref}`, { responseType: "text" }).catch(() => null);
-		if (!text) return null;
+		onProgress?.(`Downloading ${owner}/${repo}/skills@${ref}`);
 		try {
-			const json = JSON.parse(text);
-			return json.markdown || json.file?.contents || null;
-		} catch {
-			return text;
+			const { dir } = await downloadTemplate(`github:${owner}/${repo}/skills#${ref}`, {
+				dir: tempDir,
+				force: true,
+				auth: getGitHubToken() || void 0
+			});
+			const skills = [];
+			for (const entry of readdirSync(dir, { withFileTypes: true })) {
+				if (!entry.isDirectory()) continue;
+				const skill = readLocalSkill(resolve(dir, entry.name), `skills/${entry.name}`);
+				if (skill) skills.push(skill);
+			}
+			if (skills.length > 0) {
+				onProgress?.(`Found ${skills.length} skill(s)`);
+				return skills;
+			}
+		} catch {}
+		const content = await fetchGitHubRaw(`https://raw.githubusercontent.com/${owner}/${repo}/${ref}/SKILL.md`);
+		if (content) {
+			const fm = parseSkillFrontmatterName(content);
+			onProgress?.("Found 1 skill");
+			return [{
+				name: fm.name || repo,
+				description: fm.description || "",
+				path: "",
+				content,
+				files: []
+			}];
 		}
+		return [];
+	} catch {
+		return [];
+	} finally {
+		rmSync(tempDir, {
+			recursive: true,
+			force: true
+		});
 	}
-	if (url.includes("raw.githubusercontent.com")) return fetchGitHubRaw(url);
-	return fetchText(url);
 }
-async function resolveGitHubRepo(owner, repo, onProgress) {
-	onProgress?.("Fetching repo metadata");
-	const repoUrl = `https://github.com/${owner}/${repo}`;
-	const meta = await ghApi(`repos/${owner}/${repo}`) ?? await $fetch(`https://api.github.com/repos/${owner}/${repo}`).catch(() => null);
-	const homepage = meta?.homepage || void 0;
-	const description = meta?.description || void 0;
-	onProgress?.("Fetching latest release");
-	const releases = await fetchUnghReleases(owner, repo);
-	let version = "main";
-	let releasedAt;
-	const latestRelease = releases[0];
-	if (latestRelease) {
-		version = latestRelease.tag.replace(/^v/, "");
-		releasedAt = latestRelease.publishedAt;
-	}
-	onProgress?.("Resolving docs");
-	const gitDocs = await fetchGitDocs(owner, repo, version);
-	const gitDocsUrl = gitDocs ? `${repoUrl}/tree/${gitDocs.ref}/docs` : void 0;
-	const gitRef = gitDocs?.ref;
-	onProgress?.("Fetching README");
-	const readmeUrl = await fetchReadme(owner, repo);
-	let llmsUrl;
-	if (homepage) {
-		onProgress?.("Checking llms.txt");
-		llmsUrl = await fetchLlmsUrl(homepage).catch(() => null) ?? void 0;
+async function fetchGitLabSkills(source, onProgress) {
+	const { owner, repo } = source;
+	if (!owner || !repo) return { skills: [] };
+	const ref = source.ref || "main";
+	const tempDir = join(tmpdir(), `skilld-gitlab-${Date.now()}`);
+	try {
+		const subdir = source.skillPath || "skills";
+		onProgress?.(`Downloading ${owner}/${repo}/${subdir}@${ref}`);
+		const { dir } = await downloadTemplate(`gitlab:${owner}/${repo}/${subdir}#${ref}`, {
+			dir: tempDir,
+			force: true
+		});
+		if (source.skillPath) {
+			const skill = readLocalSkill(dir, source.skillPath);
+			return { skills: skill ? [skill] : [] };
+		}
+		const skills = [];
+		for (const entry of readdirSync(dir, { withFileTypes: true })) {
+			if (!entry.isDirectory()) continue;
+			const skill = readLocalSkill(resolve(dir, entry.name), `skills/${entry.name}`);
+			if (skill) skills.push(skill);
+		}
+		if (skills.length > 0) {
+			onProgress?.(`Found ${skills.length} skill(s)`);
+			return { skills };
+		}
+		const content = await $fetch(`https://gitlab.com/${owner}/${repo}/-/raw/${ref}/SKILL.md`, { responseType: "text" }).catch(() => null);
+		if (content) {
+			const fm = parseSkillFrontmatterName(content);
+			return { skills: [{
+				name: fm.name || repo,
+				description: fm.description || "",
+				path: "",
+				content,
+				files: []
+			}] };
+		}
+		return { skills: [] };
+	} catch {
+		return { skills: [] };
+	} finally {
+		rmSync(tempDir, {
+			recursive: true,
+			force: true
+		});
 	}
-	if (!gitDocsUrl && !readmeUrl && !llmsUrl) return null;
-	return {
-		name: repo,
-		version: latestRelease ? version : void 0,
-		releasedAt,
-		description,
-		repoUrl,
-		docsUrl: homepage,
-		gitDocsUrl,
-		gitRef,
-		gitDocsFallback: gitDocs?.fallback,
-		readmeUrl: readmeUrl ?? void 0,
-		llmsUrl
-	};
 }
 async function searchNpmPackages(query, size = 5) {
 	const data = await $fetch(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(query)}&size=${size}`).catch(() => null);
@@ -2198,7 +2387,7 @@ async function fetchPkgDist(name, version) {
 	if (!data) return null;
 	const tarballUrl = data.dist?.tarball;
 	if (!tarballUrl) return null;
-	const tarballRes = await fetch(tarballUrl, { headers: { "User-Agent": "skilld/1.0" } }).catch(() => null);
+	const tarballRes = await fetch(tarballUrl, { headers: { "User-Agent": SKILLD_USER_AGENT } }).catch(() => null);
 	if (!tarballRes?.ok || !tarballRes.body) return null;
 	mkdirSync(pkgDir, { recursive: true });
 	const tmpTarball = join(cacheDir, "_pkg.tgz");
@@ -2267,6 +2456,6 @@ function getInstalledSkillVersion(skillDir) {
 	if (!existsSync(skillPath)) return null;
 	return readFileSync(skillPath, "utf-8").match(/^version:\s*"?([^"\n]+)"?/m)?.[1] || null;
 }
-export { isGitHubRepoUrl as $, parseGitSkillInput as A, isGhAvailable as B, downloadLlmsDocs as C, normalizeLlmsLinks as D, fetchLlmsUrl as E, formatDiscussionAsMarkdown as F, fetchReleaseNotes as G, toCrawlPattern as H, generateDiscussionIndex as I, parseSemver as J, generateReleaseIndex as K, fetchGitHubIssues as L, resolveEntryFiles as M, generateDocsIndex as N, parseMarkdownLinks as O, fetchGitHubDiscussions as P, fetchText as Q, formatIssueAsMarkdown as R, validateGitDocsWithLlms as S, fetchLlmsTxt as T, fetchBlogReleases as U, fetchCrawledDocs as V, compareSemver as W, extractBranchHint as X, $fetch as Y, fetchGitHubRaw as Z, fetchReadme as _, getInstalledSkillVersion as a, isShallowGitDocs as b, readLocalPackageInfo as c, resolvePackageDocs as d, normalizeRepoUrl as et, resolvePackageDocsWithAttempts as f, fetchGitHubRepoMeta as g, fetchGitDocs as h, fetchPkgDist as i, parseSkillFrontmatterName as j, fetchGitSkills as k, resolveInstalledVersion as l, MIN_GIT_DOCS as m, fetchNpmPackage as n, parsePackageSpec as nt, parseVersionSpecifier as o, searchNpmPackages as p, isPrerelease as q, fetchNpmRegistryMeta as r, verifyUrl as rt, readLocalDependencies as s, fetchLatestVersion as t, parseGitHubUrl as tt, resolveLocalPackageDocs as u, fetchReadmeContent as v, extractSections as w, resolveGitHubRepo as x, filterFrameworkDocs as y, generateIssueIndex as z };
+export { fetchText as $, filterFrameworkDocs as A, fetchGitHubIssues as B, toCrawlPattern as C, fetchGitHubRepoMeta as D, fetchGitDocs as E, extractSections as F, compareSemver as G, generateIssueIndex as H, fetchLlmsTxt as I, isPrerelease as J, fetchReleaseNotes as K, fetchLlmsUrl as L, resolveGitHubRepo as M, validateGitDocsWithLlms as N, fetchReadme as O, downloadLlmsDocs as P, fetchGitHubRaw as Q, normalizeLlmsLinks as R, fetchCrawledDocs as S, MIN_GIT_DOCS as T, isGhAvailable as U, formatIssueAsMarkdown as V, fetchBlogReleases as W, $fetch as X, parseSemver as Y, extractBranchHint as Z, resolveEntryFiles as _, getInstalledSkillVersion as a, formatDiscussionAsMarkdown as b, readLocalPackageInfo as c, resolvePackageDocs as d, isGitHubRepoUrl as et, resolvePackageDocsWithAttempts as f, parseSkillFrontmatterName as g, parseGitSkillInput as h, fetchPkgDist as i, verifyUrl as it, isShallowGitDocs as j, fetchReadmeContent as k, resolveInstalledVersion as l, fetchGitSkills as m, fetchNpmPackage as n, parseGitHubUrl as nt, parseVersionSpecifier as o, searchNpmPackages as p, generateReleaseIndex as q, fetchNpmRegistryMeta as r, parsePackageSpec as rt, readLocalDependencies as s, fetchLatestVersion as t, normalizeRepoUrl as tt, resolveLocalPackageDocs as u, generateDocsIndex as v, resolveCrateDocsWithAttempts as w, generateDiscussionIndex as x, fetchGitHubDiscussions as y, parseMarkdownLinks as z };
 
 //# sourceMappingURL=sources.mjs.map