skilld 1.5.5 → 1.7.0

package/dist/_chunks/sources.mjs

@@ -1,25 +1,22 @@
-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";
 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 pLimit from "p-limit";
 import { Writable } from "node:stream";
 import { resolvePathSync } from "mlly";
-//#region src/sources/github-common.ts
-/**
-* Shared constants and helpers for GitHub source modules (issues, discussions, releases)
-*/
 const BOT_USERS = new Set([
 	"renovate[bot]",
 	"dependabot[bot]",
@@ -27,25 +24,17 @@ const BOT_USERS = new Set([
 	"dependabot",
 	"github-actions[bot]"
 ]);
-/** Extract YYYY-MM-DD date from an ISO timestamp */
 const isoDate = (iso) => iso.split("T")[0];
-/** Build YAML frontmatter from a key-value object, auto-quoting strings with special chars */
 function buildFrontmatter(fields) {
 	const lines = ["---"];
 	for (const [k, v] of Object.entries(fields)) if (v !== void 0) lines.push(`${k}: ${typeof v === "string" ? yamlEscape(v) : v}`);
 	lines.push("---");
 	return lines.join("\n");
 }
-/** Check if body contains a code block */
 function hasCodeBlock(text) {
 	return /```[\s\S]*?```/.test(text) || /`[^`]+`/.test(text);
 }
-/** Noise patterns in comments — filter these out */
 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;
-/**
-* Smart body truncation — preserves code blocks and error messages.
-* Instead of slicing at a char limit, finds a safe break point.
-*/
 function truncateBody(body, limit) {
 	if (body.length <= limit) return body;
 	const codeBlockRe = /```[\s\S]*?```/g;
@@ -66,10 +55,6 @@ function truncateBody(body, limit) {
 	return `${slice}...`;
 }
 let _ghToken;
-/**
-* Get GitHub auth token from gh CLI (cached).
-* Returns null if gh CLI is not available or not authenticated.
-*/
 function getGitHubToken() {
 	if (_ghToken !== void 0) return _ghToken;
 	try {
@@ -88,13 +73,10 @@ function getGitHubToken() {
 	}
 	return _ghToken;
 }
-/** Repos where ungh.cc failed but gh api succeeded (likely private) */
 const _needsAuth = /* @__PURE__ */ new Set();
-/** Mark a repo as needing authenticated access */
 function markRepoPrivate(owner, repo) {
 	_needsAuth.add(`${owner}/${repo}`);
 }
-/** Check if a repo is known to need authenticated access */
 function isKnownPrivateRepo(owner, repo) {
 	return _needsAuth.has(`${owner}/${repo}`);
 }
@@ -106,24 +88,15 @@ const ghApiFetch = ofetch.create({
 	headers: { "User-Agent": "skilld/1.0" }
 });
 const LINK_NEXT_RE = /<([^>]+)>;\s*rel="next"/;
-/** Parse GitHub Link header for next page URL */
 function parseLinkNext(header) {
 	if (!header) return null;
 	return header.match(LINK_NEXT_RE)?.[1] ?? null;
 }
-/**
-* Authenticated fetch against api.github.com. Returns null if no token or request fails.
-* Endpoint should be relative, e.g. `repos/owner/repo/releases`.
-*/
 async function ghApi(endpoint) {
 	const token = getGitHubToken();
 	if (!token) return null;
 	return ghApiFetch(`${GH_API}/${endpoint}`, { headers: { Authorization: `token ${token}` } }).catch(() => null);
 }
-/**
-* Paginated GitHub API fetch. Follows Link headers, returns concatenated arrays.
-* Endpoint should return a JSON array, e.g. `repos/owner/repo/releases`.
-*/
 async function ghApiPaginated(endpoint) {
 	const token = getGitHubToken();
 	if (!token) return [];
@@ -138,25 +111,40 @@ async function ghApiPaginated(endpoint) {
 	}
 	return results;
 }
-//#endregion
-//#region src/sources/utils.ts
-/**
-* Shared utilities for doc resolution
-*/
+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 }
 });
-/**
-* Fetch text content from URL
-*/
+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);
 }
 const RAW_GH_RE = /raw\.githubusercontent\.com\/([^/]+)\/([^/]+)/;
-/** Extract owner/repo from a GitHub raw content URL */
 function extractGitHubRepo(url) {
 	const match = url.match(RAW_GH_RE);
 	return match ? {
@@ -164,14 +152,6 @@ function extractGitHubRepo(url) {
 		repo: match[2]
 	} : null;
 }
-/**
-* Fetch text from a GitHub raw URL with auth fallback for private repos.
-* Tries unauthenticated first (fast path), falls back to authenticated
-* request when the repo is known to be private or unauthenticated fails.
-*
-* Only sends auth tokens to raw.githubusercontent.com — returns null for
-* non-GitHub URLs that fail unauthenticated to prevent token leakage.
-*/
 async function fetchGitHubRaw(url) {
 	const gh = extractGitHubRepo(url);
 	if (!(gh ? isKnownPrivateRepo(gh.owner, gh.repo) : false)) {
@@ -188,17 +168,11 @@ async function fetchGitHubRaw(url) {
 	if (content) markRepoPrivate(gh.owner, gh.repo);
 	return content;
 }
-/**
-* Verify URL exists and is not HTML (likely 404 page)
-*/
 async function verifyUrl(url) {
 	const res = await $fetch.raw(url, { method: "HEAD" }).catch(() => null);
 	if (!res) return false;
 	return !(res.headers.get("content-type") || "").includes("text/html");
 }
-/**
-* Check if URL points to a social media or package registry site (not real docs)
-*/
 const USELESS_HOSTS = new Set([
 	"twitter.com",
 	"x.com",
@@ -218,9 +192,6 @@ function isUselessDocsUrl(url) {
 		return false;
 	}
 }
-/**
-* Check if URL is a GitHub repo URL (not a docs site)
-*/
 function isGitHubRepoUrl(url) {
 	try {
 		const parsed = new URL(url);
@@ -229,9 +200,20 @@ function isGitHubRepoUrl(url) {
 		return false;
 	}
 }
-/**
-* Parse owner/repo from GitHub URL
-*/
+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;
@@ -240,16 +222,9 @@ function parseGitHubUrl(url) {
 		repo: match[2]
 	};
 }
-/**
-* Normalize git repo URL to https
-*/
 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/");
 }
-/**
-* Parse package spec with optional dist-tag or version: "vue@beta" → { name: "vue", tag: "beta" }
-* Handles scoped packages: "@vue/reactivity@beta" → { name: "@vue/reactivity", tag: "beta" }
-*/
 function parsePackageSpec(spec) {
 	if (spec.startsWith("@")) {
 		const slashIdx = spec.indexOf("/");
@@ -269,9 +244,6 @@ function parsePackageSpec(spec) {
 	};
 	return { name: spec };
 }
-/**
-* Extract branch hint from URL fragment (e.g. "git+https://...#main" → "main")
-*/
 function extractBranchHint(url) {
 	const hash = url.indexOf("#");
 	if (hash === -1) return void 0;
@@ -279,11 +251,6 @@ function extractBranchHint(url) {
 	if (!fragment || fragment === "readme") return void 0;
 	return fragment;
 }
-//#endregion
-//#region src/sources/releases.ts
-/**
-* GitHub release notes fetching via GitHub API (preferred) with ungh.cc fallback
-*/
 function parseSemver(version) {
 	const clean = version.replace(/^v/, "");
 	const match = clean.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
@@ -295,13 +262,6 @@ function parseSemver(version) {
 		raw: clean
 	};
 }
-/**
-* Extract version from a release tag, handling monorepo formats:
-* - `pkg@1.2.3` → `1.2.3`
-* - `pkg-v1.2.3` → `1.2.3`
-* - `v1.2.3` → `1.2.3`
-* - `1.2.3` → `1.2.3`
-*/
 function extractVersion(tag, packageName) {
 	if (packageName) {
 		const atMatch = tag.match(new RegExp(`^${escapeRegex(packageName)}@(.+)$`));
@@ -314,15 +274,9 @@ function extractVersion(tag, packageName) {
 function escapeRegex(str) {
 	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-/**
-* Check if a release tag belongs to a specific package
-*/
 function tagMatchesPackage(tag, packageName) {
 	return tag.startsWith(`${packageName}@`) || tag.startsWith(`${packageName}-v`) || tag.startsWith(`${packageName}-`);
 }
-/**
-* Check if a version string contains a prerelease suffix (e.g. 6.0.0-beta, 1.2.3-rc.1)
-*/
 function isPrerelease(version) {
 	return /^\d+\.\d+\.\d+-.+/.test(version.replace(/^v/, ""));
 }
@@ -331,7 +285,6 @@ function compareSemver(a, b) {
 	if (a.minor !== b.minor) return a.minor - b.minor;
 	return a.patch - b.patch;
 }
-/** Map GitHub API release to our GitHubRelease shape */
 function mapApiRelease(r) {
 	return {
 		id: r.id,
@@ -343,20 +296,11 @@ function mapApiRelease(r) {
 		markdown: r.body
 	};
 }
-/**
-* Fetch all releases — GitHub API first (authenticated, async), ungh.cc fallback
-*/
 async function fetchAllReleases(owner, repo) {
 	const apiReleases = await ghApiPaginated(`repos/${owner}/${repo}/releases`);
 	if (apiReleases.length > 0) return apiReleases.map(mapApiRelease);
 	return (await $fetch(`https://ungh.cc/repos/${owner}/${repo}/releases`, { signal: AbortSignal.timeout(15e3) }).catch(() => null))?.releases ?? [];
 }
-/**
-* Select last 20 stable releases for a package, sorted newest first.
-* For monorepos, filters to package-specific tags (pkg@version).
-* Falls back to generic tags (v1.2.3) only if no package-specific found.
-* If installedVersion is provided, filters out releases newer than it.
-*/
 function selectReleases(releases, packageName, installedVersion, fromDate) {
 	const hasMonorepoTags = packageName && releases.some((r) => tagMatchesPackage(r.tag, packageName));
 	const installedSv = installedVersion ? parseSemver(installedVersion) : null;
@@ -386,9 +330,6 @@ function selectReleases(releases, packageName, installedVersion, fromDate) {
 	});
 	return fromDate ? sorted : sorted.slice(0, 20);
 }
-/**
-* Format a release as markdown with YAML frontmatter
-*/
 function formatRelease(release, packageName) {
 	const date = isoDate(release.publishedAt || release.createdAt);
 	const version = extractVersion(release.tag, packageName) || release.tag;
@@ -402,10 +343,6 @@ function formatRelease(release, packageName) {
 	fm.push("---");
 	return `${fm.join("\n")}\n\n# ${release.name || release.tag}\n\n${release.markdown}`;
 }
-/**
-* Generate a unified summary index of all releases for quick LLM scanning.
-* Includes GitHub releases, blog release posts, and CHANGELOG link.
-*/
 function generateReleaseIndex(releasesOrOpts, packageName) {
 	const opts = Array.isArray(releasesOrOpts) ? {
 		releases: releasesOrOpts,
@@ -447,18 +384,10 @@ function generateReleaseIndex(releasesOrOpts, packageName) {
 	}
 	return lines.join("\n");
 }
-/**
-* Check if a single release is a stub redirecting to CHANGELOG.md.
-* Short body (<500 chars) that mentions CHANGELOG indicates no real content.
-*/
 function isStubRelease(release) {
 	const body = (release.markdown || "").trim();
 	return body.length < 500 && /changelog\.md/i.test(body);
 }
-/**
-* Fetch CHANGELOG.md from a GitHub repo at a specific ref as fallback.
-* For monorepos, also checks packages/{shortName}/CHANGELOG.md.
-*/
 async function fetchChangelog(owner, repo, ref, packageName) {
 	const paths = [];
 	if (packageName) {
@@ -474,13 +403,6 @@ async function fetchChangelog(owner, repo, ref, packageName) {
 	}
 	return null;
 }
-/**
-* Fetch release notes for a package. Returns CachedDoc[] with releases/{tag}.md files.
-*
-* Strategy:
-* 1. Fetch GitHub releases, filter to package-specific tags for monorepos
-* 2. If no releases found, try CHANGELOG.md as fallback
-*/
 async function fetchReleaseNotes(owner, repo, installedVersion, gitRef, packageName, fromDate, changelogRef) {
 	const selected = selectReleases(await fetchAllReleases(owner, repo), packageName, installedVersion, fromDate);
 	if (selected.length > 0) {
@@ -504,11 +426,6 @@ async function fetchReleaseNotes(owner, repo, installedVersion, gitRef, packageN
 		content: changelog
 	}];
 }
-//#endregion
-//#region src/sources/blog-releases.ts
-/**
-* Format a blog release as markdown with YAML frontmatter
-*/
 function formatBlogRelease(release) {
 	return `${[
 		"---",
@@ -520,9 +437,6 @@ function formatBlogRelease(release) {
 		"---"
 	].join("\n")}\n\n# ${release.title}\n\n${release.markdown}`;
 }
-/**
-* Fetch and parse a single blog post using preset metadata for version/date
-*/
 async function fetchBlogPost(entry) {
 	try {
 		const html = await $fetch(entry.url, {
@@ -550,11 +464,6 @@ async function fetchBlogPost(entry) {
 		return null;
 	}
 }
-/**
-* Filter blog releases by installed version
-* Only includes releases where version <= installedVersion
-* Returns all releases if version parsing fails (fail-safe)
-*/
 function filterBlogsByVersion(entries, installedVersion) {
 	const installedSv = parseSemver(installedVersion);
 	if (!installedSv) return entries;
@@ -564,23 +473,13 @@ function filterBlogsByVersion(entries, installedVersion) {
 		return compareSemver(entrySv, installedSv) <= 0;
 	});
 }
-/**
-* Fetch blog release notes from package presets
-* Filters to only releases matching or older than the installed version
-* Returns CachedDoc[] with releases/blog-{version}.md files
-*/
 async function fetchBlogReleases(packageName, installedVersion) {
 	const preset = getBlogPreset(packageName);
 	if (!preset) return [];
 	const filteredReleases = filterBlogsByVersion(preset.releases, installedVersion);
 	if (filteredReleases.length === 0) return [];
-	const releases = [];
-	const batchSize = 3;
-	for (let i = 0; i < filteredReleases.length; i += batchSize) {
-		const batch = filteredReleases.slice(i, i + batchSize);
-		const results = await Promise.all(batch.map((entry) => fetchBlogPost(entry)));
-		for (const result of results) if (result) releases.push(result);
-	}
+	const limit = pLimit(3);
+	const releases = (await Promise.all(filteredReleases.map((entry) => limit(() => fetchBlogPost(entry))))).filter((r) => r !== null);
 	if (releases.length === 0) return [];
 	releases.sort((a, b) => {
 		const aVer = a.version.split(".").map(Number);
@@ -596,134 +495,12 @@ async function fetchBlogReleases(packageName, installedVersion) {
 		content: formatBlogRelease(r)
 	}));
 }
-//#endregion
-//#region src/sources/crawl.ts
-/**
-* Website crawl doc source — fetches docs by crawling a URL pattern
-*/
-/**
-* Crawl a URL pattern and return docs as cached doc format.
-* Uses HTTP crawler (no browser needed) with sitemap discovery + glob filtering.
-*
-* @param url - URL with optional glob pattern (e.g. 'https://example.com/docs/**')
-* @param onProgress - Optional progress callback
-* @param maxPages - Max pages to crawl (default 200)
-*/
-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;
-/** Extract lang attribute from <html> tag */
-function extractHtmlLang(html) {
-	return HTML_LANG_RE.exec(html)?.[1]?.toLowerCase();
-}
-/** Common ISO 639-1 locale codes for i18n'd doc sites */
-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"
-]);
-/** Check if a URL path segment is a known locale prefix foreign to both English and user's locale */
-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);
-}
-/** Detect user's 2-letter language code from env (e.g. 'ja' from LANG=ja_JP.UTF-8) */
-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";
-}
-/** Append glob pattern to a docs URL for crawling */
-function toCrawlPattern(docsUrl) {
-	return `${docsUrl.replace(/\/+$/, "")}/**`;
-}
-//#endregion
-//#region src/sources/issues.ts
-/**
-* GitHub issues fetching via gh CLI Search API
-* Freshness-weighted scoring, type quotas, comment quality filtering
-* Categorized by labels, noise filtered out, non-technical issues detected
-*/
 let _ghAvailable;
-/**
-* Check if gh CLI is installed and authenticated (cached)
-*/
 function isGhAvailable() {
 	if (_ghAvailable !== void 0) return _ghAvailable;
 	const { status } = spawnSync("gh", ["auth", "status"], { stdio: "ignore" });
 	return _ghAvailable = status === 0;
 }
-/** Labels that indicate noise — filter these out entirely */
 const NOISE_LABELS = new Set([
 	"duplicate",
 	"stale",
@@ -735,7 +512,6 @@ const NOISE_LABELS = new Set([
 	"needs triage",
 	"triage"
 ]);
-/** Labels that indicate feature requests — deprioritize */
 const FEATURE_LABELS = new Set([
 	"enhancement",
 	"feature",
@@ -771,7 +547,6 @@ const DOCS_LABELS = new Set([
 	"doc",
 	"typo"
 ]);
-/** Cache compiled word-boundary regexes per keyword set */
 const labelRegexCache = /* @__PURE__ */ new WeakMap();
 function getLabelRegex(keywords) {
 	let re = labelRegexCache.get(keywords);
@@ -782,18 +557,10 @@ function getLabelRegex(keywords) {
 	}
 	return re;
 }
-/**
-* Check if a label matches any keyword from a set using word boundaries.
-* Handles emoji-prefixed labels like ":sparkles: feature request" or ":lady_beetle: bug"
-* without false positives on substrings (e.g. "debug" should not match "bug").
-*/
 function labelMatchesAny(label, keywords) {
 	if (keywords.has(label)) return true;
 	return getLabelRegex(keywords).test(label);
 }
-/**
-* Classify an issue by its labels into a type useful for skill generation
-*/
 function classifyIssue(labels) {
 	const lower = labels.map((l) => l.toLowerCase());
 	if (lower.some((l) => labelMatchesAny(l, BUG_LABELS))) return "bug";
@@ -802,37 +569,20 @@ function classifyIssue(labels) {
 	if (lower.some((l) => labelMatchesAny(l, FEATURE_LABELS))) return "feature";
 	return "other";
 }
-/**
-* Check if an issue should be filtered out entirely
-*/
 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;
 }
-/**
-* Detect non-technical issues: fan mail, showcases, sentiment.
-* Short body + no code + high reactions = likely non-technical.
-* Note: roadmap/tracking issues are NOT filtered — they get score-boosted instead.
-*/
 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;
 }
-/**
-* Freshness-weighted score: reactions * decay(age_in_years)
-* Steep decay so recent issues dominate over old high-reaction ones.
-* At 0.6: 1yr=0.63x, 2yr=0.45x, 4yr=0.29x, 6yr=0.22x
-*/
 function freshnessScore(reactions, createdAt) {
 	return reactions * (1 / (1 + (Date.now() - new Date(createdAt).getTime()) / (365.25 * 24 * 60 * 60 * 1e3) * .6));
 }
-/**
-* Type quotas — guarantee a mix of issue types.
-* Bugs and questions get priority; feature requests are hard-capped.
-*/
 function applyTypeQuotas(issues, limit) {
 	const byType = /* @__PURE__ */ new Map();
 	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
@@ -866,17 +616,11 @@ function applyTypeQuotas(issues, limit) {
 	}
 	return selected.sort((a, b) => b.score - a.score);
 }
-/**
-* Body truncation limit based on reactions — high-reaction issues deserve more space
-*/
 function bodyLimit(reactions) {
 	if (reactions >= 10) return 2e3;
 	if (reactions >= 5) return 1500;
 	return 800;
 }
-/**
-* Fetch issues for a state using GitHub Search API sorted by reactions
-*/
 function fetchIssuesByState(owner, repo, state, count, releasedAt, fromDate) {
 	const fetchCount = Math.min(count * 3, 100);
 	let datePart = "";
@@ -922,12 +666,6 @@ function oneYearAgo() {
 	d.setFullYear(d.getFullYear() - 1);
 	return isoDate(d.toISOString());
 }
-/**
-* Batch-fetch top comments for issues via GraphQL.
-* Enriches the top N highest-score issues with their best comments.
-* Prioritizes: comments with code blocks, from maintainers, with high reactions.
-* Filters out "+1", "any updates?", "same here" noise.
-*/
 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;
@@ -975,10 +713,6 @@ function enrichWithComments(owner, repo, issues, topN = 15) {
 		}
 	} catch {}
 }
-/**
-* Try to detect which version fixed a closed issue from maintainer comments.
-* Looks for version patterns in maintainer/collaborator comments.
-*/
 function detectResolvedVersion(comments) {
 	const maintainerComments = comments.filter((c) => c.isMaintainer);
 	for (const c of maintainerComments.reverse()) {
@@ -990,11 +724,6 @@ function detectResolvedVersion(comments) {
 		}
 	}
 }
-/**
-* Fetch issues from a GitHub repo with freshness-weighted scoring and type quotas.
-* Returns a balanced mix: bugs > questions > docs > other > features.
-* Filters noise, non-technical content, and enriches with quality comments.
-*/
 async function fetchGitHubIssues(owner, repo, limit = 30, releasedAt, fromDate) {
 	if (!isGhAvailable()) return [];
 	const openCount = Math.ceil(limit * .75);
@@ -1009,9 +738,6 @@ async function fetchGitHubIssues(owner, repo, limit = 30, releasedAt, fromDate)
 		return [];
 	}
 }
-/**
-* Format a single issue as markdown with YAML frontmatter
-*/
 function formatIssueAsMarkdown(issue) {
 	const limit = bodyLimit(issue.reactions);
 	const fmFields = {
@@ -1046,10 +772,6 @@ function formatIssueAsMarkdown(issue) {
 	}
 	return lines.join("\n");
 }
-/**
-* Generate a summary index of all issues for quick LLM scanning.
-* Groups by type so the LLM can quickly find bugs vs questions.
-*/
 function generateIssueIndex(issues) {
 	const byType = /* @__PURE__ */ new Map();
 	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
@@ -1094,1173 +816,1236 @@ function generateIssueIndex(issues) {
 	}
 	return sections.join("\n");
 }
-//#endregion
-//#region src/sources/discussions.ts
-/**
-* GitHub discussions fetching via gh CLI GraphQL
-* Prioritizes Q&A and Help categories, includes accepted answers
-* Comment quality filtering, smart truncation, noise removal
-*/
-/** Categories most useful for skill generation (in priority order) */
-const HIGH_VALUE_CATEGORIES = new Set([
-	"q&a",
-	"help",
-	"troubleshooting",
-	"support"
-]);
-const LOW_VALUE_CATEGORIES = new Set([
-	"show and tell",
-	"ideas",
-	"polls"
-]);
-/** Off-topic or spam title patterns — instant reject */
-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;
-/** Minimum score for a discussion to be included */
-const MIN_DISCUSSION_SCORE = 3;
-/**
-* Score a comment for quality. Higher = more useful for skill generation.
-* Maintainers 3x, code blocks 2x, reactions linear.
-*/
-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;
 }
-/**
-* Score a discussion for overall quality. Used for filtering and sorting.
-* Returns -1 for instant-reject (spam/off-topic).
-*/
-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)
+	};
 }
-/**
-* Fetch discussions from a GitHub repo using gh CLI GraphQL.
-* Prioritizes Q&A and Help categories. Includes accepted answer body for answered discussions.
-* Fetches extra comments and scores them for quality.
-*/
-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;
 	}
 }
-/**
-* Format a single discussion as markdown with YAML frontmatter
-*/
-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);
 }
-/**
-* Generate a summary index of all discussions for quick LLM scanning.
-* Groups by category so the LLM can quickly find Q&A vs general discussions.
-*/
-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;
 }
-//#endregion
-//#region src/sources/docs.ts
-/**
-* Docs index generation — creates _INDEX.md for docs directory
-*/
-/**
-* Generate a _INDEX.md for a docs/ directory.
-* Input: array of cached docs with paths like `docs/api/reactivity.md`.
-* Output: markdown index grouped by directory with title + description per page.
-*/
-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 [];
 }
-//#endregion
-//#region src/sources/entries.ts
-/**
-* Globs .d.ts type definition files from a package for search indexing.
-* Only types — source code is too verbose.
-*/
-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;
-/**
-* Glob .d.ts type definition files from a package directory, skipping junk.
-*/
-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;
-}
-//#endregion
-//#region src/sources/git-skills.ts
-/**
-* Git repo skill source — parse inputs + fetch pre-authored skills from repos
-*
-* Supports GitHub shorthand (owner/repo), full URLs, SSH, GitLab, and local paths.
-* Skills are pre-authored SKILL.md files — no doc resolution or LLM generation needed.
-*/
-/**
-* Detect whether an input string is a git skill source.
-* Returns null for npm package names (including scoped @scope/pkg).
-*/
-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 [];
 }
-/**
-* Parse name and description from SKILL.md frontmatter.
-*/
-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;
 }
-/** Recursively collect all files in a directory, returning relative paths */
-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));
 }
-/**
-* Fetch skills from a git source. Returns list of discovered skills.
-*/
-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 };
-}
-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");
+	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 {
-		name,
-		description: frontmatter.description || "",
-		path: repoPath,
-		content,
-		files
+		files: best.files,
+		prefix: best.dir
 	};
 }
-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 };
-	}
-	return { skills: [] };
+async function listDocsAtRef(owner, repo, ref, pathPrefix = "docs/") {
+	return filterDocFiles(await listFilesAtRef(owner, repo, ref), pathPrefix);
 }
-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] : [];
+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;
 		}
-		onProgress?.(`Downloading ${owner}/${repo}/skills@${ref}`);
-		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;
-			}
-		} 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
-		});
-	}
-}
-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
-		});
 	}
-}
-//#endregion
-//#region src/sources/llms.ts
-/**
-* Check for llms.txt at a docs URL, returns the llms.txt URL if found
-*/
-async function fetchLlmsUrl(docsUrl) {
-	const llmsUrl = `${new URL(docsUrl).origin}/llms.txt`;
-	if (await verifyUrl(llmsUrl)) return llmsUrl;
-	return null;
-}
-/**
-* Fetch and parse llms.txt content
-*/
-async function fetchLlmsTxt(url) {
-	const content = await fetchText(url);
-	if (!content || content.length < 50) return null;
+	docs = filterFrameworkDocs(docs, packageName);
+	if (docs.length === 0) return null;
 	return {
-		raw: content,
-		links: parseMarkdownLinks(content)
+		baseUrl: `https://raw.githubusercontent.com/${owner}/${repo}/${tag.ref}`,
+		ref: tag.ref,
+		files: docs,
+		docsPrefix,
+		allFiles,
+		fallback: tag.fallback
 	};
 }
-/**
-* Parse markdown links from llms.txt to get .md file paths
-*/
-function parseMarkdownLinks(content) {
-	return extractLinks(content).filter((l) => l.url.endsWith(".md"));
+function normalizePath(p) {
+	return p.replace(/^\//, "").replace(/\.(?:md|mdx)$/, "");
 }
-/**
-* Download all .md files referenced in llms.txt
-*/
-/** Reject non-https URLs and private/link-local IPs */
-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;
+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
+	};
 }
-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);
-}
-/**
-* Normalize llms.txt links to relative paths for local access
-* Handles: absolute URLs, root-relative paths, and relative paths
-*/
-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)");
+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 {
+			if (JSON.parse(text).name === packageName) return true;
+		} catch {}
 	}
-	normalized = normalized.replace(/\]\(\/([^)]+\.md)\)/g, "](./docs/$1)");
-	return normalized;
+	return false;
 }
-/**
-* Extract sections from llms-full.txt by URL patterns
-* Format: ---\nurl: /path.md\n---\n<content>\n\n---\nurl: ...
-*/
-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));
+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;
 		}
+		if ((await $fetch.raw(`https://ungh.cc/repos/${candidate}`).catch(() => null))?.ok) return `https://github.com/${candidate}`;
 	}
-	if (sections.length === 0) return null;
-	return sections.join("\n\n---\n\n");
+	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}`;
+	}
+	return null;
 }
-//#endregion
-//#region src/sources/github.ts
-/** Minimum git-doc file count to prefer over llms.txt */
-const MIN_GIT_DOCS = 5;
-/** True when git-docs exist but are too few to be useful (< MIN_GIT_DOCS) */
-const isShallowGitDocs = (n) => n > 0 && n < 5;
-/**
-* List files at a git ref. Tries ungh.cc first (fast, no rate limits),
-* falls back to GitHub API for private repos.
-*/
-async function listFilesAtRef(owner, repo, ref) {
+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;
+}
+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;
 }
-/**
-* Find git tag for a version by checking if ungh can list files at that ref.
-* Tries v{version}, {version}, and optionally {packageName}@{version} (changeset convention).
-*/
-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;
 }
-/**
-* Fetch releases from ungh.cc first, fall back to GitHub API for private repos.
-*/
-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 [];
-}
-/**
-* Find the latest release tag matching `{packageName}@*`.
-*/
-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
+	};
 }
-/**
-* Filter file paths by prefix and md/mdx extension
-*/
-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"
-]);
-/**
-* Filter out docs for other frameworks when the package targets a specific one.
-* e.g. @tanstack/vue-query → keep vue + shared docs, exclude react/solid/angular
-* Uses word-boundary matching to catch all path conventions:
-*   framework/react/, 0.react/, api/ai-react.md, react-native.mdx, etc.
-*/
-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();
 }
-/** Known noise paths to exclude from doc discovery */
-const NOISE_PATTERNS = [
-	/^\.changeset\//,
-	/CHANGELOG\.md$/i,
-	/CONTRIBUTING\.md$/i,
-	/^\.github\//
-];
-/** Directories to exclude from "best directory" heuristic */
-const EXCLUDE_DIRS = new Set([
-	"test",
-	"tests",
-	"__tests__",
-	"fixtures",
-	"fixture",
-	"examples",
-	"example",
-	"node_modules",
-	".git",
-	"dist",
-	"build",
-	"coverage",
-	"e2e",
-	"spec",
-	"mocks",
-	"__mocks__"
-]);
-/** Directory names that suggest documentation */
-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"
 ]);
-/**
-* Check if a path contains any excluded directory
-*/
-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);
 }
-/**
-* Get the depth of a path (number of directory levels)
-*/
-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";
 }
-/**
-* Check if path contains a doc-related directory name
-*/
-function hasDocDirBonus(path) {
-	return path.split("/").some((p) => DOC_DIR_BONUS.has(p.toLowerCase()));
+function toCrawlPattern(docsUrl) {
+	return `${docsUrl.replace(/\/+$/, "")}/**`;
 }
-/**
-* Score a directory for doc likelihood.
-* Higher = better. Formula: count * nameBonus / depth
-*/
-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);
 }
-/**
-* Discover doc files in non-standard locations.
-* First tries to scope to sub-package dir in monorepos.
-* Then looks for clusters of md/mdx files in paths containing /docs/.
-* Falls back to finding the directory with the most markdown files (≥5).
-*/
-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
-	};
-}
-/**
-* List markdown files in a folder at a specific git ref
-*/
-async function listDocsAtRef(owner, repo, ref, pathPrefix = "docs/") {
-	return filterDocFiles(await listFilesAtRef(owner, repo, ref), pathPrefix);
 }
-/**
-* Fetch versioned docs from GitHub repo's docs/ folder.
-* Pass packageName to check doc overrides (e.g. vue -> vuejs/docs).
-*/
-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
-	};
-}
-/**
-* Strip file extension (.md, .mdx) and leading slash from a path
-*/
-function normalizePath(p) {
-	return p.replace(/^\//, "").replace(/\.(?:md|mdx)$/, "");
+	return lines.join("\n");
 }
-/**
-* Validate that discovered git docs are relevant by cross-referencing llms.txt links
-* against the repo file tree. Uses extensionless suffix matching to handle monorepo nesting.
-*
-* Returns { isValid, matchRatio } where isValid = matchRatio >= 0.3
-*/
-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");
 }
-/**
-* Verify a GitHub repo is the source for an npm package by checking package.json name field.
-* Checks root first, then common monorepo paths (packages/{shortName}, packages/{name}).
-*/
-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;
 }
-/**
-* Fetch GitHub repo metadata to get website URL.
-* Pass packageName to check doc overrides first (avoids API call).
-*/
-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
+	};
 }
-/**
-* Resolve README URL for a GitHub repo, returns ungh:// pseudo-URL or raw URL
-*/
-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 };
 }
-/**
-* Fetch README content from ungh:// pseudo-URL, file:// URL, or regular URL
-*/
-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);
 }
-/**
-* Resolve a GitHub repo into a ResolvedPackage (no npm registry needed).
-* Fetches repo meta, latest release version, git docs, README, and llms.txt.
-*/
-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
-	};
 }
-//#endregion
-//#region src/sources/npm.ts
-/**
-* Search npm registry for packages matching a query.
-* Used as a fallback when direct package lookup fails.
-*/
 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 [];
@@ -2270,17 +2055,11 @@ async function searchNpmPackages(query, size = 5) {
 		version: o.package.version
 	}));
 }
-/**
-* Fetch package info from npm registry
-*/
 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);
 }
-/**
-* Fetch release date and dist-tags from npm registry
-*/
 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);
@@ -2294,10 +2073,6 @@ async function fetchNpmRegistryMeta(packageName, version) {
 		distTags
 	};
 }
-/**
-* Shared GitHub resolution cascade: git docs → repo meta (homepage) → README.
-* Used for both "repo URL found in package.json" and "repo URL found via search" paths.
-*/
 async function resolveGitHub(gh, targetVersion, pkg, result, attempts, onProgress, opts) {
 	let allFiles;
 	if (targetVersion) {
@@ -2356,15 +2131,9 @@ async function resolveGitHub(gh, targetVersion, pkg, result, attempts, onProgres
 	});
 	return allFiles;
 }
-/**
-* Resolve documentation URL for a package (legacy - returns null on failure)
-*/
 async function resolvePackageDocs(packageName, options = {}) {
 	return (await resolvePackageDocsWithAttempts(packageName, options)).package;
 }
-/**
-* Resolve documentation URL for a package with attempt tracking
-*/
 async function resolvePackageDocsWithAttempts(packageName, options = {}) {
 	const attempts = [];
 	const { onProgress } = options;
@@ -2500,9 +2269,6 @@ async function resolvePackageDocsWithAttempts(packageName, options = {}) {
 		registryVersion: pkg.version
 	};
 }
-/**
-* Parse version specifier, handling protocols like link:, workspace:, npm:, file:
-*/
 function parseVersionSpecifier(name, version, cwd) {
 	if (version.startsWith("link:")) {
 		const linkedPkg = readPackageJsonSafe(join(resolve(cwd, version.slice(5)), "package.json"));
@@ -2537,10 +2303,6 @@ function parseVersionSpecifier(name, version, cwd) {
 	};
 	return null;
 }
-/**
-* Resolve the actual installed version of a package by finding its package.json
-* via mlly's resolvePathSync. Works regardless of package manager or version protocol.
-*/
 function resolveInstalledVersion(name, cwd) {
 	try {
 		return readPackageJsonSafe(resolvePathSync(`${name}/package.json`, { url: cwd }))?.parsed.version || null;
@@ -2558,9 +2320,6 @@ function resolveInstalledVersion(name, cwd) {
 		return null;
 	}
 }
-/**
-* Read package.json dependencies with versions
-*/
 async function readLocalDependencies(cwd) {
 	const result = readPackageJsonSafe(join(cwd, "package.json"));
 	if (!result) throw new Error("No package.json found in current directory");
@@ -2576,9 +2335,6 @@ async function readLocalDependencies(cwd) {
 	}
 	return results;
 }
-/**
-* Read package info from a local path (for link: deps)
-*/
 function readLocalPackageInfo(localPath) {
 	const result = readPackageJsonSafe(join(localPath, "package.json"));
 	if (!result) return null;
@@ -2594,9 +2350,6 @@ function readLocalPackageInfo(localPath) {
 		localPath
 	};
 }
-/**
-* Resolve docs for a local package (link: dependency)
-*/
 async function resolveLocalPackageDocs(localPath) {
 	const info = readLocalPackageInfo(localPath);
 	if (!info) return null;
@@ -2626,13 +2379,6 @@ async function resolveLocalPackageDocs(localPath) {
 	if (!result.readmeUrl && !result.gitDocsUrl) return null;
 	return result;
 }
-/**
-* Download and extract npm package tarball to cache directory.
-* Used when the package isn't available in node_modules.
-*
-* Extracts to: ~/.skilld/references/<pkg>@<version>/pkg/
-* Returns the extracted directory path, or null on failure.
-*/
 async function fetchPkgDist(name, version) {
 	const cacheDir = getCacheDir(name, version);
 	const pkgDir = join(cacheDir, "pkg");
@@ -2641,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");
@@ -2700,23 +2446,16 @@ async function fetchPkgDist(name, version) {
 		} catch {}
 	}
 }
-/**
-* Fetch just the latest version string from npm (lightweight)
-*/
 async function fetchLatestVersion(packageName) {
 	const data = await $fetch(`https://unpkg.com/${packageName}/package.json`).catch(() => null);
 	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;
 }
-/**
-* Get installed skill version from SKILL.md
-*/
 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;
 }
-//#endregion
-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