skilld 1.7.3 → 2.0.0

package/dist/_chunks/{sources.mjs → semver.mjs}

@@ -1,21 +1,27 @@
-import { t as getCacheDir } from "./version.mjs";
-import { i as readPackageJsonSafe } from "./package-json.mjs";
+import { D as getCrawlUrl, E as getBlogPreset, O as getDocOverride } from "./prompts.mjs";
+import { a as GIT_PROTOCOL_PREFIX_RE, c as NPM_SCOPE_PREFIX_RE, g as V_PREFIX_RE, h as VERSION_RANGE_PREFIX_RE, i as GIT_PLUS_PREFIX_RE, l as NPM_SCOPE_WITH_SLASH_RE, m as TRAILING_SLASH_RE, o as GIT_SUFFIX_RE, r as GITHUB_SSH_URL_PREFIX_RE, s as LEADING_SLASH_RE, u as README_FILENAME_RE } from "./regex.mjs";
 import { t as yamlEscape } from "./yaml.mjs";
+import { s as getCacheDir } from "./prepare.mjs";
+import { i as readPackageJsonSafe } from "./package-json.mjs";
+import "./cache.mjs";
+import { t as mapInsert } from "./map.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 { tmpdir } from "node:os";
-import { basename, dirname, join, resolve } from "pathe";
+import { createRequire } from "node:module";
 import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync } from "node:fs";
-import { htmlToMarkdown } from "mdream";
 import pLimit from "p-limit";
+import { basename, dirname, join, resolve } from "pathe";
 import { spawnSync } from "node:child_process";
-import { ofetch } from "ofetch";
+import { tmpdir } from "node:os";
+import { glob } from "node:fs/promises";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { htmlToMarkdown } from "mdream";
+import { ofetch } from "ofetch";
 import { crawlAndGenerate } from "@mdream/crawl";
-import { glob } from "tinyglobby";
 import { downloadTemplate } from "giget";
 import { Writable } from "node:stream";
-import { resolvePathSync } from "mlly";
+import { diff, gt, valid } from "semver";
+const STATIC_REGEX_1$9 = /```[\s\S]*?```/;
+const STATIC_REGEX_2$4 = /`[^`]+`/;
 const BOT_USERS = new Set([
 	"renovate[bot]",
 	"dependabot[bot]",
@@ -31,7 +37,7 @@ function buildFrontmatter(fields) {
 	return lines.join("\n");
 }
 function hasCodeBlock(text) {
-	return /```[\s\S]*?```/.test(text) || /`[^`]+`/.test(text);
+	return STATIC_REGEX_1$9.test(text) || STATIC_REGEX_2$4.test(text);
 }
 const COMMENT_NOISE_RE = /^(?:\+1|👍|same here|any update|bump|following|is there any progress|when will this|me too|i have the same|same issue|thanks|thank you)[\s!?.]*$/i;
 function truncateBody(body, limit) {
@@ -79,6 +85,15 @@ function markRepoPrivate(owner, repo) {
 function isKnownPrivateRepo(owner, repo) {
 	return _needsAuth.has(`${owner}/${repo}`);
 }
+async function fetchUnghOrApi(owner, repo, ungh, api) {
+	if (!isKnownPrivateRepo(owner, repo)) {
+		const r = await ungh().catch(() => null);
+		if (r) return r;
+	}
+	const r = await api();
+	if (r) markRepoPrivate(owner, repo);
+	return r;
+}
 const GH_API = "https://api.github.com";
 const ghApiFetch = ofetch.create({
 	retry: 2,
@@ -172,92 +187,12 @@ async function verifyUrl(url) {
 	if (!res) return false;
 	return !(res.headers.get("content-type") || "").includes("text/html");
 }
-const USELESS_HOSTS = new Set([
-	"twitter.com",
-	"x.com",
-	"facebook.com",
-	"linkedin.com",
-	"youtube.com",
-	"instagram.com",
-	"npmjs.com",
-	"www.npmjs.com",
-	"yarnpkg.com"
-]);
-function isUselessDocsUrl(url) {
-	try {
-		const { hostname } = new URL(url);
-		return USELESS_HOSTS.has(hostname);
-	} catch {
-		return false;
-	}
-}
-function isGitHubRepoUrl(url) {
-	try {
-		const parsed = new URL(url);
-		return parsed.hostname === "github.com" || parsed.hostname === "www.github.com";
-	} catch {
-		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;
-	return {
-		owner: match[1],
-		repo: match[2]
-	};
-}
-function parseGitHubRepoSlug(url) {
-	if (!url) return void 0;
-	const parsed = parseGitHubUrl(url);
-	return parsed ? `${parsed.owner}/${parsed.repo}` : void 0;
-}
-function normalizeRepoUrl(url) {
-	return url.replace(/^git\+/, "").replace(/#.*$/, "").replace(/\.git$/, "").replace(/^git:\/\//, "https://").replace(/^ssh:\/\/git@github\.com/, "https://github.com").replace(/^git@github\.com:/, "https://github.com/");
-}
-function parsePackageSpec(spec) {
-	if (spec.startsWith("@")) {
-		const slashIdx = spec.indexOf("/");
-		if (slashIdx !== -1) {
-			const atIdx = spec.indexOf("@", slashIdx + 1);
-			if (atIdx !== -1) return {
-				name: spec.slice(0, atIdx),
-				tag: spec.slice(atIdx + 1)
-			};
-		}
-		return { name: spec };
-	}
-	const atIdx = spec.indexOf("@");
-	if (atIdx !== -1) return {
-		name: spec.slice(0, atIdx),
-		tag: spec.slice(atIdx + 1)
-	};
-	return { name: spec };
-}
-function extractBranchHint(url) {
-	const hash = url.indexOf("#");
-	if (hash === -1) return void 0;
-	const fragment = url.slice(hash + 1);
-	if (!fragment || fragment === "readme") return void 0;
-	return fragment;
-}
+const STATIC_REGEX_2$3 = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?/;
+const STATIC_REGEX_3$3 = /^\d+\.\d+\.\d+-.+/;
+const STATIC_REGEX_4$1 = /changelog\.md/i;
 function parseSemver(version) {
-	const clean = version.replace(/^v/, "");
-	const match = clean.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+	const clean = version.replace(V_PREFIX_RE, "");
+	const match = clean.match(STATIC_REGEX_2$3);
 	if (!match) return null;
 	return {
 		major: +match[1],
@@ -273,7 +208,7 @@ function extractVersion(tag, packageName) {
 		const dashMatch = tag.match(new RegExp(`^${escapeRegex(packageName)}-v?(.+)$`));
 		if (dashMatch) return dashMatch[1];
 	}
-	return tag.replace(/^v/, "");
+	return tag.replace(V_PREFIX_RE, "");
 }
 function escapeRegex(str) {
 	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -282,7 +217,7 @@ function tagMatchesPackage(tag, packageName) {
 	return tag.startsWith(`${packageName}@`) || tag.startsWith(`${packageName}-v`) || tag.startsWith(`${packageName}-`);
 }
 function isPrerelease(version) {
-	return /^\d+\.\d+\.\d+-.+/.test(version.replace(/^v/, ""));
+	return STATIC_REGEX_3$3.test(version.replace(V_PREFIX_RE, ""));
 }
 function compareSemver(a, b) {
 	if (a.major !== b.major) return a.major - b.major;
@@ -390,13 +325,13 @@ function generateReleaseIndex(releasesOrOpts, packageName) {
 }
 function isStubRelease(release) {
 	const body = (release.markdown || "").trim();
-	return body.length < 500 && /changelog\.md/i.test(body);
+	return body.length < 500 && STATIC_REGEX_4$1.test(body);
 }
 async function fetchChangelog(owner, repo, ref, packageName) {
 	const paths = [];
 	if (packageName) {
-		const shortName = packageName.replace(/^@.*\//, "");
-		const scopeless = packageName.replace(/^@/, "").replace("/", "-");
+		const shortName = packageName.replace(NPM_SCOPE_WITH_SLASH_RE, "");
+		const scopeless = packageName.replace(NPM_SCOPE_PREFIX_RE, "").replace("/", "-");
 		const candidates = [...new Set([shortName, scopeless])];
 		for (const name of candidates) paths.push(`packages/${name}/CHANGELOG.md`);
 	}
@@ -430,6 +365,8 @@ async function fetchReleaseNotes(owner, repo, installedVersion, gitRef, packageN
 		content: changelog
 	}];
 }
+const STATIC_REGEX_1$8 = /<h1[^>]*>([^<]+)<\/h1>/;
+const STATIC_REGEX_2$2 = /<title>([^<]+)<\/title>/;
 function formatBlogRelease(release) {
 	return `${[
 		"---",
@@ -449,10 +386,10 @@ async function fetchBlogPost(entry) {
 		}).catch(() => null);
 		if (!html) return null;
 		let title = "";
-		const titleMatch = html.match(/<h1[^>]*>([^<]+)<\/h1>/);
+		const titleMatch = html.match(STATIC_REGEX_1$8);
 		if (titleMatch) title = titleMatch[1].trim();
 		if (!title) {
-			const metaTitleMatch = html.match(/<title>([^<]+)<\/title>/);
+			const metaTitleMatch = html.match(STATIC_REGEX_2$2);
 			if (metaTitleMatch) title = metaTitleMatch[1].trim();
 		}
 		const markdown = htmlToMarkdown(html);
@@ -499,342 +436,93 @@ async function fetchBlogReleases(packageName, installedVersion) {
 		content: formatBlogRelease(r)
 	}));
 }
-let _ghAvailable;
-function isGhAvailable() {
-	if (_ghAvailable !== void 0) return _ghAvailable;
-	const { status } = spawnSync("gh", ["auth", "status"], { stdio: "ignore" });
-	return _ghAvailable = status === 0;
+const STATIC_REGEX_1$7 = /github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:[/#]|$)/;
+const STATIC_REGEX_3$2 = /#.*$/;
+const STATIC_REGEX_7 = /^git@github\.com:/;
+const STATIC_REGEX_8 = /^(?:127\.|10\.|172\.(?:1[6-9]|2\d|3[01])\.|192\.168\.|169\.254\.)/;
+const STATIC_REGEX_9 = /^\[(?:f[cd]|fe[89ab]|::ffff:)/i;
+function parseGitHubUrl(url) {
+	const match = url.match(STATIC_REGEX_1$7);
+	if (!match) return null;
+	return {
+		owner: match[1],
+		repo: match[2]
+	};
 }
-const NOISE_LABELS = new Set([
-	"duplicate",
-	"stale",
-	"invalid",
-	"wontfix",
-	"won't fix",
-	"spam",
-	"off-topic",
-	"needs triage",
-	"triage"
-]);
-const FEATURE_LABELS = new Set([
-	"enhancement",
-	"feature",
-	"feature request",
-	"feature-request",
-	"proposal",
-	"rfc",
-	"idea",
-	"suggestion"
-]);
-const BUG_LABELS = new Set([
-	"bug",
-	"defect",
-	"regression",
-	"error",
-	"crash",
-	"fix",
-	"confirmed",
-	"verified"
-]);
-const QUESTION_LABELS = new Set([
-	"question",
-	"help wanted",
-	"support",
-	"usage",
-	"how-to",
-	"help",
-	"assistance"
-]);
-const DOCS_LABELS = new Set([
-	"documentation",
-	"docs",
-	"doc",
-	"typo"
-]);
-const labelRegexCache = /* @__PURE__ */ new WeakMap();
-function getLabelRegex(keywords) {
-	let re = labelRegexCache.get(keywords);
-	if (!re) {
-		const escaped = Array.from(keywords, (k) => k.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
-		re = new RegExp(`\\b(?:${escaped.join("|")})\\b`);
-		labelRegexCache.set(keywords, re);
+function parseGitHubRepoSlug(url) {
+	if (!url) return void 0;
+	const parsed = parseGitHubUrl(url);
+	return parsed ? `${parsed.owner}/${parsed.repo}` : void 0;
+}
+function parsePackageSpec(spec) {
+	if (spec.startsWith("@")) {
+		const slashIdx = spec.indexOf("/");
+		if (slashIdx !== -1) {
+			const atIdx = spec.indexOf("@", slashIdx + 1);
+			if (atIdx !== -1) return {
+				name: spec.slice(0, atIdx),
+				tag: spec.slice(atIdx + 1)
+			};
+		}
+		return { name: spec };
 	}
-	return re;
+	const atIdx = spec.indexOf("@");
+	if (atIdx !== -1) return {
+		name: spec.slice(0, atIdx),
+		tag: spec.slice(atIdx + 1)
+	};
+	return { name: spec };
 }
-function labelMatchesAny(label, keywords) {
-	if (keywords.has(label)) return true;
-	return getLabelRegex(keywords).test(label);
+function normalizeRepoUrl(url) {
+	return url.replace(GIT_PLUS_PREFIX_RE, "").replace(STATIC_REGEX_3$2, "").replace(GIT_SUFFIX_RE, "").replace(GIT_PROTOCOL_PREFIX_RE, "https://").replace(GITHUB_SSH_URL_PREFIX_RE, "https://github.com").replace(STATIC_REGEX_7, "https://github.com/");
 }
-function classifyIssue(labels) {
-	const lower = labels.map((l) => l.toLowerCase());
-	if (lower.some((l) => labelMatchesAny(l, BUG_LABELS))) return "bug";
-	if (lower.some((l) => labelMatchesAny(l, QUESTION_LABELS))) return "question";
-	if (lower.some((l) => labelMatchesAny(l, DOCS_LABELS))) return "docs";
-	if (lower.some((l) => labelMatchesAny(l, FEATURE_LABELS))) return "feature";
-	return "other";
+function extractBranchHint(url) {
+	const hash = url.indexOf("#");
+	if (hash === -1) return void 0;
+	const fragment = url.slice(hash + 1);
+	if (!fragment || fragment === "readme") return void 0;
+	return fragment;
 }
-function isNoiseIssue(issue) {
-	if (issue.labels.map((l) => l.toLowerCase()).some((l) => labelMatchesAny(l, NOISE_LABELS))) return true;
-	if (issue.title.startsWith("☂️") || issue.title.startsWith("[META]") || issue.title.startsWith("[Tracking]")) return true;
-	return false;
+function isGitHubRepoUrl(url) {
+	try {
+		const parsed = new URL(url);
+		return parsed.hostname === "github.com" || parsed.hostname === "www.github.com";
+	} catch {
+		return false;
+	}
 }
-function isNonTechnical(issue) {
-	const body = (issue.body || "").trim();
-	if (body.length < 200 && !hasCodeBlock(body) && issue.reactions > 50) return true;
-	if (/\b(?:love|thank|awesome|great work)\b/i.test(issue.title) && !hasCodeBlock(body)) return true;
-	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 freshnessScore(reactions, createdAt) {
-	return reactions * (1 / (1 + (Date.now() - new Date(createdAt).getTime()) / (365.25 * 24 * 60 * 60 * 1e3) * .6));
-}
-function applyTypeQuotas(issues, limit) {
-	const byType = /* @__PURE__ */ new Map();
-	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
-	for (const group of byType.values()) group.sort((a, b) => b.score - a.score);
-	const quotas = [
-		["bug", Math.ceil(limit * .4)],
-		["question", Math.ceil(limit * .3)],
-		["docs", Math.ceil(limit * .15)],
-		["feature", Math.ceil(limit * .1)],
-		["other", Math.ceil(limit * .05)]
-	];
-	const selected = [];
-	const used = /* @__PURE__ */ new Set();
-	let remaining = limit;
-	for (const [type, quota] of quotas) {
-		const group = byType.get(type) || [];
-		const take = Math.min(quota, group.length, remaining);
-		for (let i = 0; i < take; i++) {
-			selected.push(group[i]);
-			used.add(group[i].number);
-			remaining--;
-		}
-	}
-	if (remaining > 0) {
-		const unused = issues.filter((i) => !used.has(i.number) && i.type !== "feature").sort((a, b) => b.score - a.score);
-		for (const issue of unused) {
-			if (remaining <= 0) break;
-			selected.push(issue);
-			remaining--;
-		}
-	}
-	return selected.sort((a, b) => b.score - a.score);
-}
-function bodyLimit(reactions) {
-	if (reactions >= 10) return 2e3;
-	if (reactions >= 5) return 1500;
-	return 800;
-}
-function fetchIssuesByState(owner, repo, state, count, releasedAt, fromDate) {
-	const fetchCount = Math.min(count * 3, 100);
-	let datePart = "";
-	if (fromDate) datePart = state === "closed" ? `+closed:>=${fromDate}` : `+created:>=${fromDate}`;
-	else if (state === "closed") if (releasedAt) {
-		datePart = `+closed:>=${isoDate(releasedAt)}`;
-		const cap = new Date(releasedAt);
-		cap.setMonth(cap.getMonth() + 6);
-		if (cap < /* @__PURE__ */ new Date()) datePart += `+closed:<=${isoDate(cap.toISOString())}`;
-	} else datePart = `+closed:>${oneYearAgo()}`;
-	else if (releasedAt) {
-		const date = new Date(releasedAt);
-		date.setMonth(date.getMonth() + 6);
-		datePart = `+created:<=${isoDate(date.toISOString())}`;
-	}
-	const { stdout: result } = spawnSync("gh", [
-		"api",
-		`search/issues?q=${`repo:${owner}/${repo}+is:issue+is:${state}${datePart}`}&sort=reactions&order=desc&per_page=${fetchCount}`,
-		"-q",
-		".items[] | {number, title, state, labels: [.labels[]?.name], body, createdAt: .created_at, url: .html_url, reactions: .reactions[\"+1\"], comments: .comments, user: .user.login, userType: .user.type, authorAssociation: .author_association}"
-	], {
-		encoding: "utf-8",
-		maxBuffer: 10 * 1024 * 1024
-	});
-	if (!result) return [];
-	return result.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line)).filter((issue) => !BOT_USERS.has(issue.user) && issue.userType !== "Bot").filter((issue) => !isNoiseIssue(issue)).filter((issue) => !isNonTechnical(issue)).map(({ user: _, userType: __, authorAssociation, ...issue }) => {
-		const isMaintainer = [
-			"OWNER",
-			"MEMBER",
-			"COLLABORATOR"
-		].includes(authorAssociation);
-		const isRoadmap = /\broadmap\b/i.test(issue.title) || issue.labels.some((l) => /roadmap/i.test(l));
-		return {
-			...issue,
-			type: classifyIssue(issue.labels),
-			topComments: [],
-			score: freshnessScore(issue.reactions, issue.createdAt) * (isMaintainer && isRoadmap ? 5 : 1)
-		};
-	}).sort((a, b) => b.score - a.score).slice(0, count);
-}
-function oneYearAgo() {
-	const d = /* @__PURE__ */ new Date();
-	d.setFullYear(d.getFullYear() - 1);
-	return isoDate(d.toISOString());
-}
-function enrichWithComments(owner, repo, issues, topN = 15) {
-	const worth = issues.filter((i) => i.comments > 0 && (i.type === "bug" || i.type === "question" || i.reactions >= 3)).sort((a, b) => b.score - a.score).slice(0, topN);
-	if (worth.length === 0) return;
-	const query = `query($owner: String!, $repo: String!) { repository(owner: $owner, name: $repo) { ${worth.map((issue, i) => `i${i}: issue(number: ${issue.number}) { comments(first: 10) { nodes { body author { login } authorAssociation reactions { totalCount } } } }`).join(" ")} } }`;
-	try {
-		const { stdout: result } = spawnSync("gh", [
-			"api",
-			"graphql",
-			"-f",
-			`query=${query}`,
-			"-f",
-			`owner=${owner}`,
-			"-f",
-			`repo=${repo}`
-		], {
-			encoding: "utf-8",
-			maxBuffer: 10 * 1024 * 1024
-		});
-		if (!result) return;
-		const repo_ = JSON.parse(result)?.data?.repository;
-		if (!repo_) return;
-		for (let i = 0; i < worth.length; i++) {
-			const nodes = repo_[`i${i}`]?.comments?.nodes;
-			if (!Array.isArray(nodes)) continue;
-			const issue = worth[i];
-			const 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);
-				const body = c.body || "";
-				const reactions = c.reactions?.totalCount || 0;
-				const _score = (isMaintainer ? 3 : 1) * (hasCodeBlock(body) ? 2 : 1) * (1 + reactions);
-				return {
-					body,
-					author: c.author.login,
-					reactions,
-					isMaintainer,
-					_score
-				};
-			}).sort((a, b) => b._score - a._score);
-			issue.topComments = comments.slice(0, 3).map(({ _score: _, ...c }) => c);
-			if (issue.state === "closed") issue.resolvedIn = detectResolvedVersion(comments);
-		}
-	} catch {}
-}
-function detectResolvedVersion(comments) {
-	const maintainerComments = comments.filter((c) => c.isMaintainer);
-	for (const c of maintainerComments.reverse()) {
-		const match = c.body.match(/(?:fixed|landed|released|available|shipped|resolved|included)\s+in\s+v?(\d+\.\d+(?:\.\d+)?)/i);
-		if (match) return match[1];
-		if (c.body.length < 100) {
-			const vMatch = c.body.match(/\bv?(\d+\.\d+\.\d+)\b/);
-			if (vMatch) return vMatch[1];
-		}
-	}
-}
-async function fetchGitHubIssues(owner, repo, limit = 30, releasedAt, fromDate) {
-	if (!isGhAvailable()) return [];
-	const openCount = Math.ceil(limit * .75);
-	const closedCount = limit - openCount;
-	try {
-		const open = fetchIssuesByState(owner, repo, "open", Math.min(openCount * 2, 100), releasedAt, fromDate);
-		const closed = fetchIssuesByState(owner, repo, "closed", Math.min(closedCount * 2, 50), releasedAt, fromDate);
-		const selected = applyTypeQuotas([...open, ...closed], limit);
-		enrichWithComments(owner, repo, selected);
-		return selected;
-	} catch {
-		return [];
-	}
-}
-function formatIssueAsMarkdown(issue) {
-	const limit = bodyLimit(issue.reactions);
-	const fmFields = {
-		number: issue.number,
-		title: issue.title,
-		type: issue.type,
-		state: issue.state,
-		created: isoDate(issue.createdAt),
-		url: issue.url,
-		reactions: issue.reactions,
-		comments: issue.comments
-	};
-	if (issue.resolvedIn) fmFields.resolvedIn = issue.resolvedIn;
-	if (issue.labels.length > 0) fmFields.labels = `[${issue.labels.join(", ")}]`;
-	const lines = [
-		buildFrontmatter(fmFields),
-		"",
-		`# ${issue.title}`
-	];
-	if (issue.body) {
-		const body = truncateBody(issue.body, limit);
-		lines.push("", body);
-	}
-	if (issue.topComments.length > 0) {
-		lines.push("", "---", "", "## Top Comments");
-		for (const c of issue.topComments) {
-			const reactions = c.reactions > 0 ? ` (+${c.reactions})` : "";
-			const maintainer = c.isMaintainer ? " [maintainer]" : "";
-			const commentBody = truncateBody(c.body, 600);
-			lines.push("", `**@${c.author}**${maintainer}${reactions}:`, "", commentBody);
-		}
-	}
-	return lines.join("\n");
-}
-function generateIssueIndex(issues) {
-	const byType = /* @__PURE__ */ new Map();
-	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
-	const typeLabels = {
-		bug: "Bugs & Regressions",
-		question: "Questions & Usage Help",
-		docs: "Documentation",
-		feature: "Feature Requests",
-		other: "Other"
-	};
-	const typeOrder = [
-		"bug",
-		"question",
-		"docs",
-		"other",
-		"feature"
-	];
-	const sections = [
-		[
-			"---",
-			`total: ${issues.length}`,
-			`open: ${issues.filter((i) => i.state === "open").length}`,
-			`closed: ${issues.filter((i) => i.state !== "open").length}`,
-			"---"
-		].join("\n"),
-		"",
-		"# Issues Index",
-		""
-	];
-	for (const type of typeOrder) {
-		const group = byType.get(type);
-		if (!group?.length) continue;
-		sections.push(`## ${typeLabels[type]} (${group.length})`, "");
-		for (const issue of group) {
-			const reactions = issue.reactions > 0 ? ` (+${issue.reactions})` : "";
-			const state = issue.state === "open" ? "" : " [closed]";
-			const resolved = issue.resolvedIn ? ` [fixed in ${issue.resolvedIn}]` : "";
-			const date = isoDate(issue.createdAt);
-			sections.push(`- [#${issue.number}](./issue-${issue.number}.md): ${issue.title}${reactions}${state}${resolved} (${date})`);
-		}
-		sections.push("");
-	}
-	return sections.join("\n");
-}
-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"));
+const USELESS_HOSTS = new Set([
+	"twitter.com",
+	"x.com",
+	"facebook.com",
+	"linkedin.com",
+	"youtube.com",
+	"instagram.com",
+	"npmjs.com",
+	"www.npmjs.com",
+	"yarnpkg.com"
+]);
+function isUselessDocsUrl(url) {
+	try {
+		const { hostname } = new URL(url);
+		return USELESS_HOSTS.has(hostname);
+	} catch {
+		return false;
+	}
 }
 function isSafeUrl(url) {
 	try {
@@ -842,66 +530,21 @@ function isSafeUrl(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;
+		if (STATIC_REGEX_8.test(host)) return false;
+		if (STATIC_REGEX_9.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");
-}
-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);
-	}
-	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 [];
+async function listFilesAtRef(owner, repo, ref) {
+	return await fetchUnghOrApi(owner, repo, async () => {
+		const data = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/files/${ref}`);
+		return data.files?.length ? data.files.map((f) => f.path) : null;
+	}, async () => {
+		const tree = await ghApi(`repos/${owner}/${repo}/git/trees/${ref}?recursive=1`);
+		return tree?.tree?.length ? tree.tree.map((f) => f.path) : null;
+	}) ?? [];
 }
 async function findGitTag(owner, repo, version, packageName, branchHint) {
 	const candidates = [`v${version}`, version];
@@ -935,26 +578,25 @@ async function findGitTag(owner, repo, version, packageName, branchHint) {
 	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) => ({
+	return await fetchUnghOrApi(owner, repo, async () => {
+		const data = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/releases`);
+		return data.releases?.length ? data.releases : null;
+	}, async () => {
+		const raw = await ghApiPaginated(`repos/${owner}/${repo}/releases`);
+		return raw.length > 0 ? raw.map((r) => ({
 			tag: r.tag_name,
 			publishedAt: r.published_at
-		}));
-	}
-	return [];
+		})) : null;
+	}) ?? [];
 }
 async function findLatestReleaseTag(owner, repo, packageName) {
 	const prefix = `${packageName}@`;
 	return (await fetchUnghReleases(owner, repo)).find((r) => r.tag.startsWith(prefix))?.tag ?? null;
 }
+const STATIC_REGEX_1$6 = /\.(?:md|mdx)$/;
+const isShallowGitDocs = (n) => n > 0 && n < 5;
 function filterDocFiles(files, pathPrefix) {
-	return files.filter((f) => f.startsWith(pathPrefix) && /\.(?:md|mdx)$/.test(f));
+	return files.filter((f) => f.startsWith(pathPrefix) && STATIC_REGEX_1$6.test(f));
 }
 const FRAMEWORK_NAMES = new Set([
 	"vue",
@@ -968,7 +610,7 @@ const FRAMEWORK_NAMES = new Set([
 ]);
 function filterFrameworkDocs(files, packageName) {
 	if (!packageName) return files;
-	const shortName = packageName.replace(/^@.*\//, "");
+	const shortName = packageName.replace(NPM_SCOPE_WITH_SLASH_RE, "");
 	const targetFramework = [...FRAMEWORK_NAMES].find((fw) => shortName.includes(fw));
 	if (!targetFramework) return files;
 	const otherFrameworks = [...FRAMEWORK_NAMES].filter((fw) => fw !== targetFramework);
@@ -1025,7 +667,7 @@ function scoreDocDir(dir, fileCount) {
 	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("/"));
+	const mdFiles = allFiles.filter((f) => STATIC_REGEX_1$6.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));
@@ -1103,51 +745,418 @@ async function fetchGitDocs(owner, repo, version, packageName, repoUrl) {
 			allFiles = tag.files;
 		}
 	}
-	docs = filterFrameworkDocs(docs, packageName);
-	if (docs.length === 0) return null;
+	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(LEADING_SLASH_RE, "").replace(STATIC_REGEX_1$6, "");
+}
+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;
+	}
+	const matchRatio = matches / sample.length;
+	return {
+		isValid: matchRatio >= .3,
+		matchRatio
+	};
+}
+const STATIC_REGEX_1$5 = /\b(?:love|thank|awesome|great work)\b/i;
+const STATIC_REGEX_2$1 = /\broadmap\b/i;
+const STATIC_REGEX_3$1 = /roadmap/i;
+const STATIC_REGEX_4 = /(?:fixed|landed|released|available|shipped|resolved|included)\s+in\s+v?(\d+\.\d+(?:\.\d+)?)/i;
+const STATIC_REGEX_5 = /\bv?(\d+\.\d+\.\d+)\b/;
+let _ghAvailable;
+function isGhAvailable() {
+	if (_ghAvailable !== void 0) return _ghAvailable;
+	const { status } = spawnSync("gh", ["auth", "status"], { stdio: "ignore" });
+	return _ghAvailable = status === 0;
+}
+const NOISE_LABELS = new Set([
+	"duplicate",
+	"stale",
+	"invalid",
+	"wontfix",
+	"won't fix",
+	"spam",
+	"off-topic",
+	"needs triage",
+	"triage"
+]);
+const FEATURE_LABELS = new Set([
+	"enhancement",
+	"feature",
+	"feature request",
+	"feature-request",
+	"proposal",
+	"rfc",
+	"idea",
+	"suggestion"
+]);
+const BUG_LABELS = new Set([
+	"bug",
+	"defect",
+	"regression",
+	"error",
+	"crash",
+	"fix",
+	"confirmed",
+	"verified"
+]);
+const QUESTION_LABELS = new Set([
+	"question",
+	"help wanted",
+	"support",
+	"usage",
+	"how-to",
+	"help",
+	"assistance"
+]);
+const DOCS_LABELS = new Set([
+	"documentation",
+	"docs",
+	"doc",
+	"typo"
+]);
+const labelRegexCache = /* @__PURE__ */ new WeakMap();
+function getLabelRegex(keywords) {
+	let re = labelRegexCache.get(keywords);
+	if (!re) {
+		const escaped = Array.from(keywords, (k) => k.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+		re = new RegExp(`\\b(?:${escaped.join("|")})\\b`);
+		labelRegexCache.set(keywords, re);
+	}
+	return re;
+}
+function labelMatchesAny(label, keywords) {
+	if (keywords.has(label)) return true;
+	return getLabelRegex(keywords).test(label);
+}
+function classifyIssue(labels) {
+	const lower = labels.map((l) => l.toLowerCase());
+	if (lower.some((l) => labelMatchesAny(l, BUG_LABELS))) return "bug";
+	if (lower.some((l) => labelMatchesAny(l, QUESTION_LABELS))) return "question";
+	if (lower.some((l) => labelMatchesAny(l, DOCS_LABELS))) return "docs";
+	if (lower.some((l) => labelMatchesAny(l, FEATURE_LABELS))) return "feature";
+	return "other";
+}
+function isNoiseIssue(issue) {
+	if (issue.labels.map((l) => l.toLowerCase()).some((l) => labelMatchesAny(l, NOISE_LABELS))) return true;
+	if (issue.title.startsWith("☂️") || issue.title.startsWith("[META]") || issue.title.startsWith("[Tracking]")) return true;
+	return false;
+}
+function isNonTechnical(issue) {
+	const body = (issue.body || "").trim();
+	if (body.length < 200 && !hasCodeBlock(body) && issue.reactions > 50) return true;
+	if (STATIC_REGEX_1$5.test(issue.title) && !hasCodeBlock(body)) return true;
+	return false;
+}
+function freshnessScore(reactions, createdAt) {
+	return reactions * (1 / (1 + (Date.now() - new Date(createdAt).getTime()) / (365.25 * 24 * 60 * 60 * 1e3) * .6));
+}
+function applyTypeQuotas(issues, limit) {
+	const byType = /* @__PURE__ */ new Map();
+	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
+	for (const group of byType.values()) group.sort((a, b) => b.score - a.score);
+	const quotas = [
+		["bug", Math.ceil(limit * .4)],
+		["question", Math.ceil(limit * .3)],
+		["docs", Math.ceil(limit * .15)],
+		["feature", Math.ceil(limit * .1)],
+		["other", Math.ceil(limit * .05)]
+	];
+	const selected = [];
+	const used = /* @__PURE__ */ new Set();
+	let remaining = limit;
+	for (const [type, quota] of quotas) {
+		const group = byType.get(type) || [];
+		const take = Math.min(quota, group.length, remaining);
+		for (let i = 0; i < take; i++) {
+			selected.push(group[i]);
+			used.add(group[i].number);
+			remaining--;
+		}
+	}
+	if (remaining > 0) {
+		const unused = issues.filter((i) => !used.has(i.number) && i.type !== "feature").sort((a, b) => b.score - a.score);
+		for (const issue of unused) {
+			if (remaining <= 0) break;
+			selected.push(issue);
+			remaining--;
+		}
+	}
+	return selected.sort((a, b) => b.score - a.score);
+}
+function bodyLimit(reactions) {
+	if (reactions >= 10) return 2e3;
+	if (reactions >= 5) return 1500;
+	return 800;
+}
+function fetchIssuesByState(owner, repo, state, count, releasedAt, fromDate) {
+	const fetchCount = Math.min(count * 3, 100);
+	let datePart = "";
+	if (fromDate) datePart = state === "closed" ? `+closed:>=${fromDate}` : `+created:>=${fromDate}`;
+	else if (state === "closed") if (releasedAt) {
+		datePart = `+closed:>=${isoDate(releasedAt)}`;
+		const cap = new Date(releasedAt);
+		cap.setMonth(cap.getMonth() + 6);
+		if (cap < /* @__PURE__ */ new Date()) datePart += `+closed:<=${isoDate(cap.toISOString())}`;
+	} else datePart = `+closed:>${oneYearAgo()}`;
+	else if (releasedAt) {
+		const date = new Date(releasedAt);
+		date.setMonth(date.getMonth() + 6);
+		datePart = `+created:<=${isoDate(date.toISOString())}`;
+	}
+	const { stdout: result } = spawnSync("gh", [
+		"api",
+		`search/issues?q=${`repo:${owner}/${repo}+is:issue+is:${state}${datePart}`}&sort=reactions&order=desc&per_page=${fetchCount}`,
+		"-q",
+		".items[] | {number, title, state, labels: [.labels[]?.name], body, createdAt: .created_at, url: .html_url, reactions: .reactions[\"+1\"], comments: .comments, user: .user.login, userType: .user.type, authorAssociation: .author_association}"
+	], {
+		encoding: "utf-8",
+		maxBuffer: 10 * 1024 * 1024
+	});
+	if (!result) return [];
+	return result.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line)).filter((issue) => !BOT_USERS.has(issue.user) && issue.userType !== "Bot").filter((issue) => !isNoiseIssue(issue)).filter((issue) => !isNonTechnical(issue)).map(({ user: _, userType: __, authorAssociation, ...issue }) => {
+		const isMaintainer = [
+			"OWNER",
+			"MEMBER",
+			"COLLABORATOR"
+		].includes(authorAssociation);
+		const isRoadmap = STATIC_REGEX_2$1.test(issue.title) || issue.labels.some((l) => STATIC_REGEX_3$1.test(l));
+		return {
+			...issue,
+			type: classifyIssue(issue.labels),
+			topComments: [],
+			score: freshnessScore(issue.reactions, issue.createdAt) * (isMaintainer && isRoadmap ? 5 : 1)
+		};
+	}).sort((a, b) => b.score - a.score).slice(0, count);
+}
+function oneYearAgo() {
+	const d = /* @__PURE__ */ new Date();
+	d.setFullYear(d.getFullYear() - 1);
+	return isoDate(d.toISOString());
+}
+function enrichWithComments(owner, repo, issues, topN = 15) {
+	const worth = issues.filter((i) => i.comments > 0 && (i.type === "bug" || i.type === "question" || i.reactions >= 3)).sort((a, b) => b.score - a.score).slice(0, topN);
+	if (worth.length === 0) return;
+	const query = `query($owner: String!, $repo: String!) { repository(owner: $owner, name: $repo) { ${worth.map((issue, i) => `i${i}: issue(number: ${issue.number}) { comments(first: 10) { nodes { body author { login } authorAssociation reactions { totalCount } } } }`).join(" ")} } }`;
+	try {
+		const { stdout: result } = spawnSync("gh", [
+			"api",
+			"graphql",
+			"-f",
+			`query=${query}`,
+			"-f",
+			`owner=${owner}`,
+			"-f",
+			`repo=${repo}`
+		], {
+			encoding: "utf-8",
+			maxBuffer: 10 * 1024 * 1024
+		});
+		if (!result) return;
+		const repo_ = JSON.parse(result)?.data?.repository;
+		if (!repo_) return;
+		for (let i = 0; i < worth.length; i++) {
+			const nodes = repo_[`i${i}`]?.comments?.nodes;
+			if (!Array.isArray(nodes)) continue;
+			const issue = worth[i];
+			const 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);
+				const body = c.body || "";
+				const reactions = c.reactions?.totalCount || 0;
+				const _score = (isMaintainer ? 3 : 1) * (hasCodeBlock(body) ? 2 : 1) * (1 + reactions);
+				return {
+					body,
+					author: c.author.login,
+					reactions,
+					isMaintainer,
+					_score
+				};
+			}).sort((a, b) => b._score - a._score);
+			issue.topComments = comments.slice(0, 3).map(({ _score: _, ...c }) => c);
+			if (issue.state === "closed") issue.resolvedIn = detectResolvedVersion(comments);
+		}
+	} catch {}
+}
+function detectResolvedVersion(comments) {
+	const maintainerComments = comments.filter((c) => c.isMaintainer);
+	for (const c of maintainerComments.reverse()) {
+		const match = c.body.match(STATIC_REGEX_4);
+		if (match) return match[1];
+		if (c.body.length < 100) {
+			const vMatch = c.body.match(STATIC_REGEX_5);
+			if (vMatch) return vMatch[1];
+		}
+	}
+}
+async function fetchGitHubIssues(owner, repo, limit = 30, releasedAt, fromDate) {
+	if (!isGhAvailable()) return [];
+	const openCount = Math.ceil(limit * .75);
+	const closedCount = limit - openCount;
+	try {
+		const open = fetchIssuesByState(owner, repo, "open", Math.min(openCount * 2, 100), releasedAt, fromDate);
+		const closed = fetchIssuesByState(owner, repo, "closed", Math.min(closedCount * 2, 50), releasedAt, fromDate);
+		const selected = applyTypeQuotas([...open, ...closed], limit);
+		enrichWithComments(owner, repo, selected);
+		return selected;
+	} catch {
+		return [];
+	}
+}
+function formatIssueAsMarkdown(issue) {
+	const limit = bodyLimit(issue.reactions);
+	const fmFields = {
+		number: issue.number,
+		title: issue.title,
+		type: issue.type,
+		state: issue.state,
+		created: isoDate(issue.createdAt),
+		url: issue.url,
+		reactions: issue.reactions,
+		comments: issue.comments
+	};
+	if (issue.resolvedIn) fmFields.resolvedIn = issue.resolvedIn;
+	if (issue.labels.length > 0) fmFields.labels = `[${issue.labels.join(", ")}]`;
+	const lines = [
+		buildFrontmatter(fmFields),
+		"",
+		`# ${issue.title}`
+	];
+	if (issue.body) {
+		const body = truncateBody(issue.body, limit);
+		lines.push("", body);
+	}
+	if (issue.topComments.length > 0) {
+		lines.push("", "---", "", "## Top Comments");
+		for (const c of issue.topComments) {
+			const reactions = c.reactions > 0 ? ` (+${c.reactions})` : "";
+			const maintainer = c.isMaintainer ? " [maintainer]" : "";
+			const commentBody = truncateBody(c.body, 600);
+			lines.push("", `**@${c.author}**${maintainer}${reactions}:`, "", commentBody);
+		}
+	}
+	return lines.join("\n");
+}
+function generateIssueIndex(issues) {
+	const byType = /* @__PURE__ */ new Map();
+	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
+	const typeLabels = {
+		bug: "Bugs & Regressions",
+		question: "Questions & Usage Help",
+		docs: "Documentation",
+		feature: "Feature Requests",
+		other: "Other"
+	};
+	const typeOrder = [
+		"bug",
+		"question",
+		"docs",
+		"other",
+		"feature"
+	];
+	const sections = [
+		[
+			"---",
+			`total: ${issues.length}`,
+			`open: ${issues.filter((i) => i.state === "open").length}`,
+			`closed: ${issues.filter((i) => i.state !== "open").length}`,
+			"---"
+		].join("\n"),
+		"",
+		"# Issues Index",
+		""
+	];
+	for (const type of typeOrder) {
+		const group = byType.get(type);
+		if (!group?.length) continue;
+		sections.push(`## ${typeLabels[type]} (${group.length})`, "");
+		for (const issue of group) {
+			const reactions = issue.reactions > 0 ? ` (+${issue.reactions})` : "";
+			const state = issue.state === "open" ? "" : " [closed]";
+			const resolved = issue.resolvedIn ? ` [fixed in ${issue.resolvedIn}]` : "";
+			const date = isoDate(issue.createdAt);
+			sections.push(`- [#${issue.number}](./issue-${issue.number}.md): ${issue.title}${reactions}${state}${resolved} (${date})`);
+		}
+		sections.push("");
+	}
+	return sections.join("\n");
+}
+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 {
-		baseUrl: `https://raw.githubusercontent.com/${owner}/${repo}/${tag.ref}`,
-		ref: tag.ref,
-		files: docs,
-		docsPrefix,
-		allFiles,
-		fallback: tag.fallback
+		raw: content,
+		links: parseMarkdownLinks(content)
 	};
 }
-function normalizePath(p) {
-	return p.replace(/^\//, "").replace(/\.(?:md|mdx)$/, "");
+function parseMarkdownLinks(content) {
+	return extractLinks(content).filter((l) => l.url.endsWith(".md"));
 }
-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;
+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(TRAILING_SLASH_RE, "")}${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(TRAILING_SLASH_RE, "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		normalized = normalized.replace(new RegExp(`\\]\\(${escaped}(/[^)]+\\.md)\\)`, "g"), "](./docs$1)");
 	}
-	const matchRatio = matches / sample.length;
-	return {
-		isValid: matchRatio >= .3,
-		matchRatio
-	};
+	normalized = normalized.replace(/\]\(\/([^)]+\.md)\)/g, "](./docs/$1)");
+	return normalized;
 }
 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`
+		`packages/${packageName.replace(NPM_SCOPE_WITH_SLASH_RE, "")}/package.json`,
+		`packages/${packageName.replace(NPM_SCOPE_PREFIX_RE, "").replace("/", "-")}/package.json`
 	];
 	for (const path of paths) {
 		const text = await fetchGitHubRaw(`${base}/${path}`);
@@ -1159,15 +1168,15 @@ async function verifyNpmRepo(owner, repo, packageName) {
 	return false;
 }
 async function searchGitHubRepo(packageName) {
-	const shortName = packageName.replace(/^@.*\//, "");
-	for (const candidate of [packageName.replace(/^@/, "").replace("/", "/"), shortName]) {
+	const shortName = packageName.replace(NPM_SCOPE_WITH_SLASH_RE, "");
+	for (const candidate of [packageName.replace(NPM_SCOPE_PREFIX_RE, "").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;
 		}
 		if ((await $fetch.raw(`https://ungh.cc/repos/${candidate}`).catch(() => null))?.ok) return `https://github.com/${candidate}`;
 	}
-	const searchTerm = packageName.replace(/^@/, "");
+	const searchTerm = packageName.replace(NPM_SCOPE_PREFIX_RE, "");
 	if (isGhAvailable()) try {
 		const { stdout: json } = spawnSync("gh", [
 			"search",
@@ -1274,7 +1283,7 @@ async function resolveGitHubRepo(owner, repo, onProgress) {
 	let releasedAt;
 	const latestRelease = releases[0];
 	if (latestRelease) {
-		version = latestRelease.tag.replace(/^v/, "");
+		version = latestRelease.tag.replace(V_PREFIX_RE, "");
 		releasedAt = latestRelease.publishedAt;
 	}
 	onProgress?.("Resolving docs");
@@ -1453,6 +1462,8 @@ async function resolveCrateDocsWithAttempts(crateName, options = {}) {
 		attempts
 	};
 }
+const STATIC_REGEX_2 = /[_.:-]/;
+const STATIC_REGEX_3 = /\/+$/;
 async function fetchCrawledDocs(url, onProgress, maxPages = 200) {
 	const outputDir = join(tmpdir(), "skilld-crawl", Date.now().toString());
 	onProgress?.(`Crawling ${url}`);
@@ -1492,7 +1503,7 @@ async function fetchCrawledDocs(url, onProgress, maxPages = 200) {
 			localeFiltered++;
 			continue;
 		}
-		const segments = (new URL(result.url).pathname.replace(/\/$/, "") || "/index").split("/").filter(Boolean);
+		const segments = (new URL(result.url).pathname.replace(TRAILING_SLASH_RE, "") || "/index").split("/").filter(Boolean);
 		if (isForeignPathPrefix(segments[0], userLang)) {
 			localeFiltered++;
 			continue;
@@ -1540,11 +1551,11 @@ function isForeignPathPrefix(segment, userLang) {
 	return LOCALE_CODES.has(lower);
 }
 function getUserLang() {
-	const code = (process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || "").split(/[_.:-]/)[0]?.toLowerCase() || "";
+	const code = (process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || "").split(STATIC_REGEX_2)[0]?.toLowerCase() || "";
 	return code.length >= 2 ? code.slice(0, 2) : "en";
 }
 function toCrawlPattern(docsUrl) {
-	return `${docsUrl.replace(/\/+$/, "")}/**`;
+	return `${docsUrl.replace(STATIC_REGEX_3, "")}/**`;
 }
 const HIGH_VALUE_CATEGORIES = new Set([
 	"q&a",
@@ -1722,6 +1733,7 @@ function generateDiscussionIndex(discussions) {
 	}
 	return sections.join("\n");
 }
+const STATIC_REGEX_1$4 = /\.md$/;
 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 "";
@@ -1747,7 +1759,7 @@ function generateDocsIndex(docs) {
 	];
 	for (const file of rootFiles) {
 		const rel = file.path.slice(5);
-		const title = extractTitle(file.content) || rel.replace(/\.md$/, "");
+		const title = extractTitle(file.content) || rel.replace(STATIC_REGEX_1$4, "");
 		const desc = extractDescription(file.content);
 		const descPart = desc ? `: ${desc}` : "";
 		sections.push(`- [${title}](./${rel})${descPart}`);
@@ -1757,7 +1769,7 @@ function generateDocsIndex(docs) {
 		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 title = extractTitle(file.content) || rel.replace(STATIC_REGEX_1$4, "").split("/").pop();
 			const desc = extractDescription(file.content);
 			const descPart = desc ? `: ${desc}` : "";
 			sections.push(`- [${title}](./${rel})${descPart}`);
@@ -1795,12 +1807,24 @@ const SKIP_PATTERNS = [
 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 skipDirSet = new Set(SKIP_DIRS);
+	const isSkipPattern = (name) => SKIP_PATTERNS.some((p) => {
+		const star = p.indexOf("*");
+		if (star === -1) return name === p;
+		const prefix = p.slice(0, star);
+		const suffix = p.slice(star + 1);
+		return name.startsWith(prefix) && name.endsWith(suffix);
 	});
+	const files = [];
+	for await (const file of glob(["**/*.d.{ts,mts,cts}"], {
+		cwd: packageDir,
+		exclude: (p) => {
+			const segs = p.split("/");
+			const last = segs[segs.length - 1];
+			if (isSkipPattern(last)) return true;
+			return segs.some((s) => skipDirSet.has(s));
+		}
+	})) files.push(file);
 	const entries = [];
 	for (const file of files) {
 		const absPath = join(packageDir, file);
@@ -1819,6 +1843,7 @@ async function resolveEntryFiles(packageDir) {
 	}
 	return entries;
 }
+const STATIC_REGEX_1$3 = /^[\w.-]+\/[\w.-]+$/;
 function parseGitSkillInput(input) {
 	const trimmed = input.trim();
 	if (trimmed.startsWith("@")) return null;
@@ -1836,7 +1861,7 @@ function parseGitSkillInput(input) {
 		return null;
 	}
 	if (trimmed.startsWith("https://") || trimmed.startsWith("http://")) return parseGitUrl(trimmed);
-	if (/^[\w.-]+\/[\w.-]+$/.test(trimmed)) return {
+	if (STATIC_REGEX_1$3.test(trimmed)) return {
 		type: "github",
 		owner: trimmed.split("/")[0],
 		repo: trimmed.split("/")[1]
@@ -1847,7 +1872,7 @@ 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 parts = parsed.pathname.replace(LEADING_SLASH_RE, "").replace(GIT_SUFFIX_RE, "").split("/");
 			const owner = parts[0];
 			const repo = parts[1];
 			if (!owner || !repo) return null;
@@ -1865,7 +1890,7 @@ function parseGitUrl(url) {
 			};
 		}
 		if (parsed.hostname === "gitlab.com") {
-			const parts = parsed.pathname.replace(/^\//, "").replace(/\.git$/, "").split("/");
+			const parts = parsed.pathname.replace(LEADING_SLASH_RE, "").replace(GIT_SUFFIX_RE, "").split("/");
 			const owner = parts[0];
 			const repo = parts[1];
 			if (!owner || !repo) return null;
@@ -2004,287 +2029,65 @@ async function downloadGitHubSkills(owner, repo, ref, skillPath, onProgress) {
 				path: "",
 				content,
 				files: []
-			}];
-		}
-		return [];
-	} catch {
-		return [];
-	} finally {
-		rmSync(tempDir, {
-			recursive: true,
-			force: true
-		});
-	}
-}
-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 { dir: skillDir, repoPath } of findSkillDirs(dir, "skills")) {
-			const skill = readLocalSkill(skillDir, repoPath);
-			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
-		});
-	}
-}
-async function searchNpmPackages(query, size = 5) {
-	const data = await $fetch(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(query)}&size=${size}`).catch(() => null);
-	if (!data?.objects?.length) return [];
-	return data.objects.map((o) => ({
-		name: o.package.name,
-		description: o.package.description,
-		version: o.package.version
-	}));
-}
-async function fetchNpmPackage(packageName) {
-	const data = await $fetch(`https://unpkg.com/${packageName}/package.json`).catch(() => null);
-	if (data) return data;
-	return $fetch(`https://registry.npmjs.org/${packageName}/latest`).catch(() => null);
-}
-async function fetchNpmRegistryMeta(packageName, version) {
-	const { name: barePackageName } = parsePackageSpec(packageName);
-	const data = await $fetch(`https://registry.npmjs.org/${barePackageName}`, { headers: { Accept: "application/vnd.npm.install-v1+json" } }).catch(() => null);
-	if (!data) return {};
-	const distTags = data["dist-tags"] ? Object.fromEntries(Object.entries(data["dist-tags"]).map(([tag, ver]) => [tag, {
-		version: ver,
-		releasedAt: data.time?.[ver]
-	}])) : void 0;
-	return {
-		releasedAt: data.time?.[version] || void 0,
-		distTags
-	};
-}
-async function resolveGitHub(gh, targetVersion, pkg, result, attempts, onProgress, opts) {
-	let allFiles;
-	if (targetVersion) {
-		onProgress?.("github-docs");
-		const gitDocs = await fetchGitDocs(gh.owner, gh.repo, targetVersion, pkg.name, opts?.rawRepoUrl);
-		if (gitDocs) {
-			result.gitDocsUrl = gitDocs.baseUrl;
-			result.gitRef = gitDocs.ref;
-			result.gitDocsFallback = gitDocs.fallback;
-			allFiles = gitDocs.allFiles;
-			attempts.push({
-				source: "github-docs",
-				url: gitDocs.baseUrl,
-				status: "success",
-				message: gitDocs.fallback ? `Found ${gitDocs.files.length} docs at ${gitDocs.ref} (no tag for v${targetVersion})` : `Found ${gitDocs.files.length} docs at ${gitDocs.ref}`
-			});
-		} else attempts.push({
-			source: "github-docs",
-			url: `${result.repoUrl}/tree/v${targetVersion}/docs`,
-			status: "not-found",
-			message: "No docs/ folder found at version tag"
-		});
-	}
-	if (!result.docsUrl) {
-		onProgress?.("github-meta");
-		const repoMeta = await fetchGitHubRepoMeta(gh.owner, gh.repo, pkg.name);
-		if (repoMeta?.homepage && !isUselessDocsUrl(repoMeta.homepage)) {
-			result.docsUrl = repoMeta.homepage;
-			attempts.push({
-				source: "github-meta",
-				url: result.repoUrl,
-				status: "success",
-				message: `Found homepage: ${repoMeta.homepage}`
-			});
-		} else attempts.push({
-			source: "github-meta",
-			url: result.repoUrl,
-			status: "not-found",
-			message: "No homepage in repo metadata"
-		});
-	}
-	onProgress?.("readme");
-	const readmeUrl = await fetchReadme(gh.owner, gh.repo, opts?.subdir, result.gitRef);
-	if (readmeUrl) {
-		result.readmeUrl = readmeUrl;
-		attempts.push({
-			source: "readme",
-			url: readmeUrl,
-			status: "success"
-		});
-	} else attempts.push({
-		source: "readme",
-		url: `${result.repoUrl}/README.md`,
-		status: "not-found",
-		message: "No README found"
-	});
-	return allFiles;
-}
-async function resolvePackageDocs(packageName, options = {}) {
-	return (await resolvePackageDocsWithAttempts(packageName, options)).package;
-}
-async function resolvePackageDocsWithAttempts(packageName, options = {}) {
-	const attempts = [];
-	const { onProgress } = options;
-	onProgress?.("npm");
-	const pkg = await fetchNpmPackage(packageName);
-	if (!pkg) {
-		attempts.push({
-			source: "npm",
-			url: `https://registry.npmjs.org/${packageName}/latest`,
-			status: "not-found",
-			message: "Package not found on npm registry"
-		});
-		return {
-			package: null,
-			attempts
-		};
-	}
-	attempts.push({
-		source: "npm",
-		url: `https://registry.npmjs.org/${packageName}/latest`,
-		status: "success",
-		message: `Found ${pkg.name}@${pkg.version}`
-	});
-	const registryMeta = pkg.version ? await fetchNpmRegistryMeta(packageName, pkg.version) : {};
-	const result = {
-		name: pkg.name,
-		version: pkg.version,
-		releasedAt: registryMeta.releasedAt,
-		description: pkg.description,
-		dependencies: pkg.dependencies,
-		distTags: registryMeta.distTags
-	};
-	let gitDocsAllFiles;
-	let subdir;
-	let rawRepoUrl;
-	if (typeof pkg.repository === "object" && pkg.repository?.url) {
-		rawRepoUrl = pkg.repository.url;
-		const normalized = normalizeRepoUrl(rawRepoUrl);
-		if (!normalized.includes("://") && normalized.includes("/") && !normalized.includes(":")) result.repoUrl = `https://github.com/${normalized}`;
-		else result.repoUrl = normalized;
-		subdir = pkg.repository.directory;
-	} else if (typeof pkg.repository === "string") if (pkg.repository.includes("://")) {
-		const gh = parseGitHubUrl(pkg.repository);
-		if (gh) result.repoUrl = `https://github.com/${gh.owner}/${gh.repo}`;
-	} else {
-		const repo = pkg.repository.replace(/^github:/, "");
-		if (repo.includes("/") && !repo.includes(":")) result.repoUrl = `https://github.com/${repo}`;
-	}
-	if (pkg.homepage && !isGitHubRepoUrl(pkg.homepage) && !isUselessDocsUrl(pkg.homepage)) result.docsUrl = pkg.homepage;
-	if (result.repoUrl?.includes("github.com")) {
-		const gh = parseGitHubUrl(result.repoUrl);
-		if (gh) gitDocsAllFiles = await resolveGitHub(gh, options.version || pkg.version, pkg, result, attempts, onProgress, {
-			rawRepoUrl,
-			subdir
-		});
-	} else if (!result.repoUrl) {
-		onProgress?.("github-search");
-		const searchedUrl = await searchGitHubRepo(pkg.name);
-		if (searchedUrl) {
-			result.repoUrl = searchedUrl;
-			attempts.push({
-				source: "github-search",
-				url: searchedUrl,
-				status: "success",
-				message: `Found via GitHub search: ${searchedUrl}`
-			});
-			const gh = parseGitHubUrl(searchedUrl);
-			if (gh) gitDocsAllFiles = await resolveGitHub(gh, options.version || pkg.version, pkg, result, attempts, onProgress);
-		} else attempts.push({
-			source: "github-search",
-			status: "not-found",
-			message: "No repository URL in package.json and GitHub search found no match"
-		});
-	}
-	const crawlUrl = getCrawlUrl(packageName);
-	if (crawlUrl) result.crawlUrl = crawlUrl;
-	if (result.docsUrl) {
-		onProgress?.("llms.txt");
-		const llmsUrl = await fetchLlmsUrl(result.docsUrl);
-		if (llmsUrl) {
-			result.llmsUrl = llmsUrl;
-			attempts.push({
-				source: "llms.txt",
-				url: llmsUrl,
-				status: "success"
-			});
-		} else attempts.push({
-			source: "llms.txt",
-			url: `${new URL(result.docsUrl).origin}/llms.txt`,
-			status: "not-found",
-			message: "No llms.txt at docs URL"
+			}];
+		}
+		return [];
+	} catch {
+		return [];
+	} finally {
+		rmSync(tempDir, {
+			recursive: true,
+			force: true
 		});
 	}
-	if (result.gitDocsUrl && result.llmsUrl && gitDocsAllFiles) {
-		const llmsContent = await fetchLlmsTxt(result.llmsUrl);
-		if (llmsContent && llmsContent.links.length > 0) {
-			const validation = validateGitDocsWithLlms(llmsContent.links, gitDocsAllFiles);
-			if (!validation.isValid) {
-				attempts.push({
-					source: "github-docs",
-					url: result.gitDocsUrl,
-					status: "not-found",
-					message: `Heuristic git docs don't match llms.txt links (${Math.round(validation.matchRatio * 100)}% match), preferring llms.txt`
-				});
-				result.gitDocsUrl = void 0;
-				result.gitRef = 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] : [] };
 		}
-	}
-	if (!result.docsUrl && !result.llmsUrl && !result.readmeUrl && !result.gitDocsUrl && options.cwd) {
-		onProgress?.("local");
-		const pkgDir = join(options.cwd, "node_modules", packageName);
-		const readmeFile = existsSync(pkgDir) && readdirSync(pkgDir).find((f) => /^readme\.md$/i.test(f));
-		if (readmeFile) {
-			const readmePath = join(pkgDir, readmeFile);
-			result.readmeUrl = pathToFileURL(readmePath).href;
-			attempts.push({
-				source: "readme",
-				url: readmePath,
-				status: "success",
-				message: "Found local readme in node_modules"
-			});
+		const skills = [];
+		for (const { dir: skillDir, repoPath } of findSkillDirs(dir, "skills")) {
+			const skill = readLocalSkill(skillDir, repoPath);
+			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 (!result.docsUrl && !result.llmsUrl && !result.readmeUrl && !result.gitDocsUrl) return {
-		package: null,
-		attempts,
-		registryVersion: pkg.version
-	};
-	return {
-		package: result,
-		attempts,
-		registryVersion: pkg.version
-	};
 }
+const STATIC_REGEX_1$2 = /^[\^~>=<\d]/;
 function parseVersionSpecifier(name, version, cwd) {
 	if (version.startsWith("link:")) {
 		const linkedPkg = readPackageJsonSafe(join(resolve(cwd, version.slice(5)), "package.json"));
@@ -2309,9 +2112,9 @@ function parseVersionSpecifier(name, version, cwd) {
 		name,
 		version: installed
 	};
-	if (/^[\^~>=<\d]/.test(version)) return {
+	if (STATIC_REGEX_1$2.test(version)) return {
 		name,
-		version: version.replace(/^[\^~>=<]+/, "")
+		version: version.replace(VERSION_RANGE_PREFIX_RE, "")
 	};
 	if (version.startsWith("catalog:") || version.startsWith("workspace:")) return {
 		name,
@@ -2320,11 +2123,14 @@ function parseVersionSpecifier(name, version, cwd) {
 	return null;
 }
 function resolveInstalledVersion(name, cwd) {
+	const direct = readPackageJsonSafe(join(cwd, "node_modules", ...name.split("/"), "package.json"));
+	if (direct) return direct.parsed.version || null;
+	const req = createRequire(join(cwd, "package.json"));
 	try {
-		return readPackageJsonSafe(resolvePathSync(`${name}/package.json`, { url: cwd }))?.parsed.version || null;
+		return readPackageJsonSafe(req.resolve(`${name}/package.json`))?.parsed.version || null;
 	} catch {
 		try {
-			let dir = dirname(resolvePathSync(name, { url: cwd }));
+			let dir = dirname(req.resolve(name));
 			while (dir && basename(dir) !== "node_modules") {
 				const pkg = readPackageJsonSafe(join(dir, "package.json"));
 				if (pkg) return pkg.parsed.version || null;
@@ -2389,12 +2195,50 @@ async function resolveLocalPackageDocs(localPath) {
 		}
 	}
 	if (!result.readmeUrl && !result.gitDocsUrl) {
-		const readmeFile = readdirSync(localPath).find((f) => /^readme\.md$/i.test(f));
+		const readmeFile = readdirSync(localPath).find((f) => README_FILENAME_RE.test(f));
 		if (readmeFile) result.readmeUrl = pathToFileURL(join(localPath, readmeFile)).href;
 	}
 	if (!result.readmeUrl && !result.gitDocsUrl) return null;
 	return result;
 }
+async function resolveLocalDep(packageName, cwd) {
+	const result = readPackageJsonSafe(join(cwd, "package.json"));
+	if (!result) return null;
+	const pkg = result.parsed;
+	const depVersion = {
+		...pkg.dependencies,
+		...pkg.devDependencies
+	}[packageName];
+	if (!depVersion?.startsWith("link:")) return null;
+	return resolveLocalPackageDocs(resolve(cwd, depVersion.slice(5)));
+}
+async function searchNpmPackages(query, size = 5) {
+	const data = await $fetch(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(query)}&size=${size}`).catch(() => null);
+	if (!data?.objects?.length) return [];
+	return data.objects.map((o) => ({
+		name: o.package.name,
+		description: o.package.description,
+		version: o.package.version
+	}));
+}
+async function fetchNpmPackage(packageName) {
+	const data = await $fetch(`https://unpkg.com/${packageName}/package.json`).catch(() => null);
+	if (data) return data;
+	return $fetch(`https://registry.npmjs.org/${packageName}/latest`).catch(() => null);
+}
+async function fetchNpmRegistryMeta(packageName, version) {
+	const { name: barePackageName } = parsePackageSpec(packageName);
+	const data = await $fetch(`https://registry.npmjs.org/${barePackageName}`, { headers: { Accept: "application/vnd.npm.install-v1+json" } }).catch(() => null);
+	if (!data) return {};
+	const distTags = data["dist-tags"] ? Object.fromEntries(Object.entries(data["dist-tags"]).map(([tag, ver]) => [tag, {
+		version: ver,
+		releasedAt: data.time?.[ver]
+	}])) : void 0;
+	return {
+		releasedAt: data.time?.[version] || void 0,
+		distTags
+	};
+}
 async function fetchPkgDist(name, version) {
 	const cacheDir = getCacheDir(name, version);
 	const pkgDir = join(cacheDir, "pkg");
@@ -2467,11 +2311,457 @@ async function fetchLatestVersion(packageName) {
 	if (data?.version) return data.version;
 	return (await $fetch(`https://registry.npmjs.org/${packageName}`, { headers: { Accept: "application/vnd.npm.install-v1+json" } }).catch(() => null))?.["dist-tags"]?.latest || null;
 }
-function getInstalledSkillVersion(skillDir) {
-	const skillPath = join(skillDir, "SKILL.md");
-	if (!existsSync(skillPath)) return null;
-	return readFileSync(skillPath, "utf-8").match(/^version:\s*"?([^"\n]+)"?/m)?.[1] || null;
+const STATIC_REGEX_1$1 = /^[\w.-]+\/[\w.-]+/;
+function parseSkillInput(input) {
+	const trimmed = input.trim();
+	if (trimmed.startsWith("npm:")) {
+		const { name, tag } = splitPackageTag(trimmed.slice(4));
+		return {
+			type: "npm",
+			package: name,
+			tag
+		};
+	}
+	if (trimmed.startsWith("crate:")) {
+		const rest = trimmed.slice(6).trim();
+		const atIdx = rest.indexOf("@");
+		return {
+			type: "crate",
+			package: (atIdx === -1 ? rest : rest.slice(0, atIdx)).toLowerCase(),
+			version: atIdx === -1 ? void 0 : rest.slice(atIdx + 1) || void 0
+		};
+	}
+	if (trimmed.startsWith("gh:") || trimmed.startsWith("github:")) {
+		const rest = trimmed.startsWith("gh:") ? trimmed.slice(3) : trimmed.slice(7);
+		const gitSource = parseGitSkillInput(rest);
+		if (gitSource) return {
+			type: "git",
+			source: gitSource
+		};
+		if (STATIC_REGEX_1$1.test(rest)) {
+			const [owner, repo] = rest.split("/");
+			return {
+				type: "git",
+				source: {
+					type: "github",
+					owner,
+					repo
+				}
+			};
+		}
+		return {
+			type: "bare",
+			package: rest
+		};
+	}
+	if (trimmed.startsWith("@")) {
+		const rest = trimmed.slice(1);
+		if (rest.indexOf("/") === -1) return {
+			type: "curator",
+			handle: rest
+		};
+		const { name, tag } = splitPackageTag(trimmed);
+		return {
+			type: "bare",
+			package: name,
+			tag
+		};
+	}
+	const gitSource = parseGitSkillInput(trimmed);
+	if (gitSource) return {
+		type: "git",
+		source: gitSource
+	};
+	const { name, tag } = splitPackageTag(trimmed);
+	return {
+		type: "bare",
+		package: name,
+		tag
+	};
+}
+function resolveSkillName(input) {
+	const source = parseSkillInput(input);
+	switch (source.type) {
+		case "npm":
+		case "bare": return source.package;
+		case "crate": return `crate:${source.package}`;
+		case "git":
+			if (source.source.type === "github" && source.source.repo) return source.source.repo;
+			return null;
+		case "curator":
+		case "collection": return null;
+		default: throw new Error(`Unhandled SkillSource type: ${JSON.stringify(source)}`);
+	}
+}
+function toStoragePackageName(identityName) {
+	if (identityName.startsWith("crate:")) return `@skilld-crate/${identityName.slice(6)}`;
+	return identityName;
+}
+function isCrateSpec(spec) {
+	return spec.startsWith("crate:");
+}
+function toCrateIdentity(crateName) {
+	return `crate:${crateName}`;
+}
+function splitPackageTag(spec) {
+	if (spec.startsWith("@")) {
+		const slashIdx = spec.indexOf("/");
+		if (slashIdx !== -1) {
+			const afterSlash = spec.indexOf("@", slashIdx);
+			if (afterSlash !== -1) return {
+				name: spec.slice(0, afterSlash),
+				tag: spec.slice(afterSlash + 1) || void 0
+			};
+		}
+		return { name: spec };
+	}
+	const atIdx = spec.indexOf("@");
+	if (atIdx !== -1) return {
+		name: spec.slice(0, atIdx),
+		tag: spec.slice(atIdx + 1) || void 0
+	};
+	return { name: spec };
+}
+const crawlUrlResolver = defineResolver({
+	id: "crawl",
+	canResolve: (ctx) => !!ctx.result,
+	async run(ctx) {
+		const crawlUrl = getCrawlUrl(ctx.packageName);
+		if (crawlUrl) ctx.result.crawlUrl = crawlUrl;
+		return { kind: "ok" };
+	}
+});
+const gitTagResolver = defineResolver({
+	id: "github-docs",
+	canResolve: (ctx) => !!ctx.result?.repoUrl?.includes("github.com"),
+	async run(ctx) {
+		const result = ctx.result;
+		const gh = parseGitHubUrl(result.repoUrl);
+		if (!gh) return { kind: "skip" };
+		const targetVersion = ctx.options.version || ctx.npm?.version;
+		if (!targetVersion) return { kind: "skip" };
+		ctx.options.onProgress?.("github-docs");
+		const gitDocs = await fetchGitDocs(gh.owner, gh.repo, targetVersion, ctx.packageName, ctx.rawRepoUrl);
+		if (gitDocs) {
+			result.gitDocsUrl = gitDocs.baseUrl;
+			result.gitRef = gitDocs.ref;
+			result.gitDocsFallback = gitDocs.fallback;
+			ctx.gitDocsAllFiles = gitDocs.allFiles;
+			ctx.attempts.push({
+				source: "github-docs",
+				url: gitDocs.baseUrl,
+				status: "success",
+				message: gitDocs.fallback ? `Found ${gitDocs.files.length} docs at ${gitDocs.ref} (no tag for v${targetVersion})` : `Found ${gitDocs.files.length} docs at ${gitDocs.ref}`
+			});
+			return { kind: "ok" };
+		}
+		ctx.attempts.push({
+			source: "github-docs",
+			url: `${result.repoUrl}/tree/v${targetVersion}/docs`,
+			status: "not-found",
+			message: "No docs/ folder found at version tag"
+		});
+		return { kind: "skip" };
+	}
+});
+const githubMetaResolver = defineResolver({
+	id: "github-meta",
+	canResolve: (ctx) => !!ctx.result?.repoUrl?.includes("github.com") && !ctx.result.docsUrl,
+	async run(ctx) {
+		const result = ctx.result;
+		const gh = parseGitHubUrl(result.repoUrl);
+		if (!gh) return { kind: "skip" };
+		ctx.options.onProgress?.("github-meta");
+		const repoMeta = await fetchGitHubRepoMeta(gh.owner, gh.repo, ctx.packageName);
+		if (repoMeta?.homepage && !isUselessDocsUrl(repoMeta.homepage)) {
+			result.docsUrl = repoMeta.homepage;
+			ctx.attempts.push({
+				source: "github-meta",
+				url: result.repoUrl,
+				status: "success",
+				message: `Found homepage: ${repoMeta.homepage}`
+			});
+			return { kind: "ok" };
+		}
+		ctx.attempts.push({
+			source: "github-meta",
+			url: result.repoUrl,
+			status: "not-found",
+			message: "No homepage in repo metadata"
+		});
+		return { kind: "skip" };
+	}
+});
+const githubReadmeResolver = defineResolver({
+	id: "readme",
+	canResolve: (ctx) => !!ctx.result?.repoUrl?.includes("github.com"),
+	async run(ctx) {
+		const result = ctx.result;
+		const gh = parseGitHubUrl(result.repoUrl);
+		if (!gh) return { kind: "skip" };
+		ctx.options.onProgress?.("readme");
+		const readmeUrl = await fetchReadme(gh.owner, gh.repo, ctx.subdir, result.gitRef);
+		if (readmeUrl) {
+			result.readmeUrl = readmeUrl;
+			ctx.attempts.push({
+				source: "readme",
+				url: readmeUrl,
+				status: "success"
+			});
+			return { kind: "ok" };
+		}
+		ctx.attempts.push({
+			source: "readme",
+			url: `${result.repoUrl}/README.md`,
+			status: "not-found",
+			message: "No README found"
+		});
+		return { kind: "skip" };
+	}
+});
+const githubSearchResolver = defineResolver({
+	id: "github-search",
+	canResolve: (ctx) => !!ctx.result && !ctx.result.repoUrl,
+	async run(ctx) {
+		const result = ctx.result;
+		ctx.options.onProgress?.("github-search");
+		const searchedUrl = await searchGitHubRepo(ctx.packageName);
+		if (searchedUrl) {
+			result.repoUrl = searchedUrl;
+			ctx.attempts.push({
+				source: "github-search",
+				url: searchedUrl,
+				status: "success",
+				message: `Found via GitHub search: ${searchedUrl}`
+			});
+			return { kind: "ok" };
+		}
+		ctx.attempts.push({
+			source: "github-search",
+			status: "not-found",
+			message: "No repository URL in package.json and GitHub search found no match"
+		});
+		return { kind: "skip" };
+	}
+});
+const llmsTxtResolver = defineResolver({
+	id: "llms.txt",
+	canResolve: (ctx) => !!ctx.result?.docsUrl,
+	async run(ctx) {
+		const result = ctx.result;
+		ctx.options.onProgress?.("llms.txt");
+		const llmsUrl = await fetchLlmsUrl(result.docsUrl);
+		if (llmsUrl) {
+			result.llmsUrl = llmsUrl;
+			ctx.attempts.push({
+				source: "llms.txt",
+				url: llmsUrl,
+				status: "success"
+			});
+		} else ctx.attempts.push({
+			source: "llms.txt",
+			url: `${new URL(result.docsUrl).origin}/llms.txt`,
+			status: "not-found",
+			message: "No llms.txt at docs URL"
+		});
+		if (result.gitDocsUrl && result.llmsUrl && ctx.gitDocsAllFiles) {
+			const llmsContent = await fetchLlmsTxt(result.llmsUrl);
+			if (llmsContent && llmsContent.links.length > 0) {
+				const validation = validateGitDocsWithLlms(llmsContent.links, ctx.gitDocsAllFiles);
+				if (!validation.isValid) {
+					ctx.attempts.push({
+						source: "github-docs",
+						url: result.gitDocsUrl,
+						status: "not-found",
+						message: `Heuristic git docs don't match llms.txt links (${Math.round(validation.matchRatio * 100)}% match), preferring llms.txt`
+					});
+					result.gitDocsUrl = void 0;
+					result.gitRef = void 0;
+				}
+			}
+		}
+		return { kind: "ok" };
+	}
+});
+const localReadmeResolver = defineResolver({
+	id: "local",
+	canResolve: (ctx) => {
+		const r = ctx.result;
+		return !!r && !!ctx.options.cwd && !r.docsUrl && !r.llmsUrl && !r.readmeUrl && !r.gitDocsUrl;
+	},
+	async run(ctx) {
+		const result = ctx.result;
+		ctx.options.onProgress?.("local");
+		const pkgDir = join(ctx.options.cwd, "node_modules", ctx.packageName);
+		const readmeFile = existsSync(pkgDir) && readdirSync(pkgDir).find((f) => README_FILENAME_RE.test(f));
+		if (readmeFile) {
+			const readmePath = join(pkgDir, readmeFile);
+			result.readmeUrl = pathToFileURL(readmePath).href;
+			ctx.attempts.push({
+				source: "readme",
+				url: readmePath,
+				status: "success",
+				message: "Found local readme in node_modules"
+			});
+			return { kind: "ok" };
+		}
+		return { kind: "skip" };
+	}
+});
+const STATIC_REGEX_1 = /^github:/;
+const defaultResolvers = [
+	defineResolver({
+		id: "npm",
+		async run(ctx) {
+			ctx.options.onProgress?.("npm");
+			const pkg = await fetchNpmPackage(ctx.packageName);
+			if (!pkg) {
+				ctx.attempts.push({
+					source: "npm",
+					url: `https://registry.npmjs.org/${ctx.packageName}/latest`,
+					status: "not-found",
+					message: "Package not found on npm registry"
+				});
+				return { kind: "fatal" };
+			}
+			ctx.attempts.push({
+				source: "npm",
+				url: `https://registry.npmjs.org/${ctx.packageName}/latest`,
+				status: "success",
+				message: `Found ${pkg.name}@${pkg.version}`
+			});
+			const registryMeta = pkg.version ? await fetchNpmRegistryMeta(ctx.packageName, pkg.version) : {};
+			const result = {
+				name: pkg.name,
+				version: pkg.version,
+				releasedAt: registryMeta.releasedAt,
+				description: pkg.description,
+				dependencies: pkg.dependencies,
+				distTags: registryMeta.distTags
+			};
+			if (typeof pkg.repository === "object" && pkg.repository?.url) {
+				ctx.rawRepoUrl = pkg.repository.url;
+				const normalized = normalizeRepoUrl(pkg.repository.url);
+				if (!normalized.includes("://") && normalized.includes("/") && !normalized.includes(":")) result.repoUrl = `https://github.com/${normalized}`;
+				else result.repoUrl = normalized;
+				ctx.subdir = pkg.repository.directory;
+			} else if (typeof pkg.repository === "string") if (pkg.repository.includes("://")) {
+				const gh = parseGitHubUrl(pkg.repository);
+				if (gh) result.repoUrl = `https://github.com/${gh.owner}/${gh.repo}`;
+			} else {
+				const repo = pkg.repository.replace(STATIC_REGEX_1, "");
+				if (repo.includes("/") && !repo.includes(":")) result.repoUrl = `https://github.com/${repo}`;
+			}
+			if (pkg.homepage && !isGitHubRepoUrl(pkg.homepage) && !isUselessDocsUrl(pkg.homepage)) result.docsUrl = pkg.homepage;
+			ctx.npm = pkg;
+			ctx.result = result;
+			return { kind: "ok" };
+		}
+	}),
+	githubSearchResolver,
+	gitTagResolver,
+	githubMetaResolver,
+	githubReadmeResolver,
+	crawlUrlResolver,
+	llmsTxtResolver,
+	localReadmeResolver
+];
+function defineResolver(r) {
+	return r;
+}
+function createContentResolver(opts) {
+	return { async resolve(packageName, options = {}) {
+		const ctx = {
+			packageName,
+			options,
+			result: null,
+			attempts: []
+		};
+		let registryVersion;
+		for (const resolver of opts.resolvers) {
+			if (resolver.canResolve && !resolver.canResolve(ctx)) continue;
+			const outcome = await resolver.run(ctx);
+			if (outcome.kind === "fatal") return {
+				package: null,
+				attempts: ctx.attempts,
+				registryVersion: outcome.registryVersion ?? registryVersion
+			};
+		}
+		registryVersion = ctx.npm?.version;
+		const r = ctx.result;
+		if (!r || !r.docsUrl && !r.llmsUrl && !r.readmeUrl && !r.gitDocsUrl) return {
+			package: null,
+			attempts: ctx.attempts,
+			registryVersion
+		};
+		return {
+			package: r,
+			attempts: ctx.attempts,
+			registryVersion
+		};
+	} };
+}
+const defaultContentResolver = createContentResolver({ resolvers: defaultResolvers });
+async function resolvePackageDocs(packageName, options = {}) {
+	return (await defaultContentResolver.resolve(packageName, options)).package;
+}
+async function resolvePackageDocsWithAttempts(packageName, options = {}) {
+	return defaultContentResolver.resolve(packageName, options);
+}
+const RESOLVE_STEP_LABELS = {
+	"npm": "npm registry",
+	"github-docs": "GitHub docs",
+	"github-meta": "GitHub meta",
+	"github-search": "GitHub search",
+	"readme": "README",
+	"llms.txt": "llms.txt",
+	"crawl": "website crawl",
+	"local": "node_modules"
+};
+async function resolvePackageOrCrate(packageSpec, opts) {
+	const { cwd, onProgress } = opts;
+	const isCrate = isCrateSpec(packageSpec);
+	const normalizedSpec = isCrate ? packageSpec.slice(6).trim() : packageSpec;
+	const { name: parsedName, tag: requestedTag } = parsePackageSpec(normalizedSpec);
+	const packageName = isCrate ? parsedName.toLowerCase() : parsedName;
+	const identityPackageName = isCrate ? toCrateIdentity(packageName) : packageName;
+	const storagePackageName = toStoragePackageName(identityPackageName);
+	const localDeps = isCrate ? [] : await readLocalDependencies(cwd).catch(() => []);
+	const localVersion = isCrate ? void 0 : localDeps.find((d) => d.name === packageName)?.version;
+	const resolveResult = isCrate ? await resolveCrateDocsWithAttempts(packageName, {
+		version: requestedTag,
+		onProgress
+	}) : await resolvePackageDocsWithAttempts(requestedTag ? normalizedSpec : packageName, {
+		version: localVersion,
+		cwd,
+		onProgress: (step) => onProgress?.(RESOLVE_STEP_LABELS[step] ?? step)
+	});
+	let resolved = resolveResult.package;
+	if (!resolved && !isCrate) {
+		onProgress?.(RESOLVE_STEP_LABELS.local);
+		resolved = await resolveLocalDep(packageName, cwd);
+	}
+	return {
+		packageName,
+		identityPackageName,
+		storagePackageName,
+		isCrate,
+		requestedTag,
+		localVersion,
+		resolved,
+		attempts: resolveResult.attempts,
+		registryVersion: resolveResult.registryVersion
+	};
+}
+function semverValid(v) {
+	return valid(v, true);
+}
+function semverGt(a, b) {
+	return gt(a, b, true);
+}
+function semverDiff(a, b) {
+	return diff(a, b);
 }
-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, verifyUrl as at, formatDiscussionAsMarkdown as b, readLocalPackageInfo as c, resolvePackageDocs as d, isGitHubRepoUrl as et, resolvePackageDocsWithAttempts as f, parseSkillFrontmatterName as g, parseGitSkillInput as h, fetchPkgDist as i, parsePackageSpec as it, isShallowGitDocs as j, fetchReadmeContent as k, resolveInstalledVersion as l, fetchGitSkills as m, fetchNpmPackage as n, parseGitHubRepoSlug as nt, parseVersionSpecifier as o, searchNpmPackages as p, generateReleaseIndex as q, fetchNpmRegistryMeta as r, parseGitHubUrl 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 };
+export { fetchGitHubIssues as A, fetchBlogReleases as B, fetchCrawledDocs as C, downloadLlmsDocs as D, resolveGitHubRepo as E, filterFrameworkDocs as F, generateReleaseIndex as H, isShallowGitDocs as I, parseGitHubRepoSlug as L, generateIssueIndex as M, isGhAvailable as N, fetchLlmsTxt as O, fetchGitDocs as P, parseGitHubUrl as R, generateDiscussionIndex as S, fetchReadmeContent as T, isPrerelease as U, fetchReleaseNotes as V, fetchGitHubRaw as W, fetchGitSkills as _, resolvePackageDocs as a, fetchGitHubDiscussions as b, resolveSkillName as c, fetchNpmPackage as d, fetchNpmRegistryMeta as f, readLocalPackageInfo as g, readLocalDependencies as h, resolvePackageOrCrate as i, formatIssueAsMarkdown as j, normalizeLlmsLinks as k, toStoragePackageName as l, searchNpmPackages as m, semverGt as n, isCrateSpec as o, fetchPkgDist as p, semverValid as r, parseSkillInput as s, semverDiff as t, fetchLatestVersion as u, resolveEntryFiles as v, toCrawlPattern as w, formatDiscussionAsMarkdown as x, generateDocsIndex as y, parsePackageSpec as z };
 
-//# sourceMappingURL=sources.mjs.map
+//# sourceMappingURL=semver.mjs.map