skilld 1.1.1 → 1.2.0

package/dist/_chunks/sources.mjs

@@ -14,6 +14,7 @@ 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)
 */
@@ -33,903 +34,1053 @@ function buildFrontmatter(fields) {
 	lines.push("---");
 	return lines.join("\n");
 }
+let _ghToken;
 /**
-* 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
+* Get GitHub auth token from gh CLI (cached).
+* Returns null if gh CLI is not available or not authenticated.
 */
-let _ghAvailable;
+function getGitHubToken() {
+	if (_ghToken !== void 0) return _ghToken;
+	try {
+		const { stdout } = spawnSync("gh", ["auth", "token"], {
+			encoding: "utf-8",
+			timeout: 5e3,
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		});
+		_ghToken = stdout?.trim() || null;
+	} catch {
+		_ghToken = null;
+	}
+	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}`);
+}
+const GH_API = "https://api.github.com";
+const ghApiFetch = ofetch.create({
+	retry: 2,
+	retryDelay: 500,
+	timeout: 15e3,
+	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;
+}
 /**
-* Check if gh CLI is installed and authenticated (cached)
+* Authenticated fetch against api.github.com. Returns null if no token or request fails.
+* Endpoint should be relative, e.g. `repos/owner/repo/releases`.
 */
-function isGhAvailable() {
-	if (_ghAvailable !== void 0) return _ghAvailable;
-	const { status } = spawnSync("gh", ["auth", "status"], { stdio: "ignore" });
-	return _ghAvailable = status === 0;
+async function ghApi(endpoint) {
+	const token = getGitHubToken();
+	if (!token) return null;
+	return ghApiFetch(`${GH_API}/${endpoint}`, { headers: { Authorization: `token ${token}` } }).catch(() => null);
 }
-/** Labels that indicate noise — filter these out entirely */
-const NOISE_LABELS = new Set([
-	"duplicate",
-	"stale",
-	"invalid",
-	"wontfix",
-	"won't fix",
-	"spam",
-	"off-topic",
-	"needs triage",
-	"triage"
-]);
-/** Labels that indicate feature requests — deprioritize */
-const FEATURE_LABELS = new Set([
-	"enhancement",
-	"feature",
-	"feature request",
-	"feature-request",
-	"proposal",
-	"rfc",
-	"idea",
-	"suggestion"
-]);
-const BUG_LABELS = new Set([
-	"bug",
-	"defect",
-	"regression",
-	"error",
-	"crash",
-	"fix",
-	"confirmed",
-	"verified"
-]);
-const QUESTION_LABELS = new Set([
-	"question",
-	"help wanted",
-	"support",
-	"usage",
-	"how-to",
-	"help",
-	"assistance"
-]);
-const DOCS_LABELS = new Set([
-	"documentation",
-	"docs",
-	"doc",
-	"typo"
-]);
 /**
-* Check if a label contains any keyword from a set.
-* Handles emoji-prefixed labels like ":sparkles: feature request" or ":lady_beetle: bug".
+* Paginated GitHub API fetch. Follows Link headers, returns concatenated arrays.
+* Endpoint should return a JSON array, e.g. `repos/owner/repo/releases`.
 */
-function labelMatchesAny(label, keywords) {
-	for (const keyword of keywords) if (label === keyword || label.includes(keyword)) return true;
-	return false;
+async function ghApiPaginated(endpoint) {
+	const token = getGitHubToken();
+	if (!token) return [];
+	const headers = { Authorization: `token ${token}` };
+	const results = [];
+	let url = `${GH_API}/${endpoint}`;
+	while (url) {
+		const res = await ghApiFetch.raw(url, { headers }).catch(() => null);
+		if (!res?.ok || !Array.isArray(res._data)) break;
+		results.push(...res._data);
+		url = parseLinkNext(res.headers.get("link"));
+	}
+	return results;
 }
+//#endregion
+//#region src/sources/utils.ts
 /**
-* Classify an issue by its labels into a type useful for skill generation
+* Shared utilities for doc resolution
 */
-function classifyIssue(labels) {
-	const lower = labels.map((l) => l.toLowerCase());
-	if (lower.some((l) => labelMatchesAny(l, BUG_LABELS))) return "bug";
-	if (lower.some((l) => labelMatchesAny(l, QUESTION_LABELS))) return "question";
-	if (lower.some((l) => labelMatchesAny(l, DOCS_LABELS))) return "docs";
-	if (lower.some((l) => labelMatchesAny(l, FEATURE_LABELS))) return "feature";
-	return "other";
-}
+const $fetch = ofetch.create({
+	retry: 3,
+	retryDelay: 500,
+	timeout: 15e3,
+	headers: { "User-Agent": "skilld/1.0" }
+});
 /**
-* Check if an issue should be filtered out entirely
+* Fetch text content from URL
 */
-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;
+async function fetchText(url) {
+	return $fetch(url, { responseType: "text" }).catch(() => null);
 }
-/** Check if body contains a code block */
-function hasCodeBlock$1(text) {
-	return /```[\s\S]*?```/.test(text) || /`[^`]+`/.test(text);
+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 ? {
+		owner: match[1],
+		repo: match[2]
+	} : null;
 }
 /**
-* 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.
+* 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.
 */
-function isNonTechnical(issue) {
-	const body = (issue.body || "").trim();
-	if (body.length < 200 && !hasCodeBlock$1(body) && issue.reactions > 50) return true;
-	if (/\b(?:love|thank|awesome|great work)\b/i.test(issue.title) && !hasCodeBlock$1(body)) return true;
-	return false;
+async function fetchGitHubRaw(url) {
+	const gh = extractGitHubRepo(url);
+	if (!(gh ? isKnownPrivateRepo(gh.owner, gh.repo) : false)) {
+		const content = await fetchText(url);
+		if (content) return content;
+	}
+	if (!gh) return null;
+	const token = getGitHubToken();
+	if (!token) return null;
+	const content = await $fetch(url, {
+		responseType: "text",
+		headers: { Authorization: `token ${token}` }
+	}).catch(() => null);
+	if (content) markRepoPrivate(gh.owner, gh.repo);
+	return content;
 }
 /**
-* 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
+* Verify URL exists and is not HTML (likely 404 page)
 */
-function freshnessScore(reactions, createdAt) {
-	return reactions * (1 / (1 + (Date.now() - new Date(createdAt).getTime()) / (365.25 * 24 * 60 * 60 * 1e3) * .6));
+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");
 }
 /**
-* Type quotas — guarantee a mix of issue types.
-* Bugs and questions get priority; feature requests are hard-capped.
+* Check if URL points to a social media or package registry site (not real docs)
 */
-function applyTypeQuotas(issues, limit) {
-	const byType = /* @__PURE__ */ new Map();
-	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
-	for (const group of byType.values()) group.sort((a, b) => b.score - a.score);
-	const quotas = [
-		["bug", Math.ceil(limit * .4)],
-		["question", Math.ceil(limit * .3)],
-		["docs", Math.ceil(limit * .15)],
-		["feature", Math.ceil(limit * .1)],
-		["other", Math.ceil(limit * .05)]
-	];
-	const selected = [];
-	const used = /* @__PURE__ */ new Set();
-	let remaining = limit;
-	for (const [type, quota] of quotas) {
-		const group = byType.get(type) || [];
-		const take = Math.min(quota, group.length, remaining);
-		for (let i = 0; i < take; i++) {
-			selected.push(group[i]);
-			used.add(group[i].number);
-			remaining--;
-		}
+const USELESS_HOSTS = new Set([
+	"twitter.com",
+	"x.com",
+	"facebook.com",
+	"linkedin.com",
+	"youtube.com",
+	"instagram.com",
+	"npmjs.com",
+	"www.npmjs.com",
+	"yarnpkg.com"
+]);
+function isUselessDocsUrl(url) {
+	try {
+		const { hostname } = new URL(url);
+		return USELESS_HOSTS.has(hostname);
+	} catch {
+		return false;
 	}
-	if (remaining > 0) {
-		const unused = issues.filter((i) => !used.has(i.number) && i.type !== "feature").sort((a, b) => b.score - a.score);
-		for (const issue of unused) {
-			if (remaining <= 0) break;
-			selected.push(issue);
-			remaining--;
-		}
+}
+/**
+* Check if URL is a GitHub repo URL (not a docs site)
+*/
+function isGitHubRepoUrl(url) {
+	try {
+		const parsed = new URL(url);
+		return parsed.hostname === "github.com" || parsed.hostname === "www.github.com";
+	} catch {
+		return false;
 	}
-	return selected.sort((a, b) => b.score - a.score);
 }
 /**
-* Body truncation limit based on reactions — high-reaction issues deserve more space
+* Parse owner/repo from GitHub URL
 */
-function bodyLimit(reactions) {
-	if (reactions >= 10) return 2e3;
-	if (reactions >= 5) return 1500;
-	return 800;
+function parseGitHubUrl(url) {
+	const match = url.match(/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:[/#]|$)/);
+	if (!match) return null;
+	return {
+		owner: match[1],
+		repo: match[2]
+	};
 }
 /**
-* Smart body truncation — preserves code blocks and error messages.
-* Instead of slicing at a char limit, finds a safe break point.
+* Normalize git repo URL to https
 */
-function truncateBody$1(body, limit) {
-	if (body.length <= limit) return body;
-	const codeBlockRe = /```[\s\S]*?```/g;
-	let lastSafeEnd = limit;
-	let match;
-	while ((match = codeBlockRe.exec(body)) !== null) {
-		const blockStart = match.index;
-		const blockEnd = blockStart + match[0].length;
-		if (blockStart < limit && blockEnd > limit) {
-			if (blockEnd <= limit + 500) lastSafeEnd = blockEnd;
-			else lastSafeEnd = blockStart;
-			break;
+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("/");
+		if (slashIdx !== -1) {
+			const atIdx = spec.indexOf("@", slashIdx + 1);
+			if (atIdx !== -1) return {
+				name: spec.slice(0, atIdx),
+				tag: spec.slice(atIdx + 1)
+			};
 		}
+		return { name: spec };
 	}
-	const slice = body.slice(0, lastSafeEnd);
-	const lastParagraph = slice.lastIndexOf("\n\n");
-	if (lastParagraph > lastSafeEnd * .6) return `${slice.slice(0, lastParagraph)}\n\n...`;
-	return `${slice}...`;
+	const atIdx = spec.indexOf("@");
+	if (atIdx !== -1) return {
+		name: spec.slice(0, atIdx),
+		tag: spec.slice(atIdx + 1)
+	};
+	return { name: spec };
 }
 /**
-* Fetch issues for a state using GitHub Search API sorted by reactions
+* Extract branch hint from URL fragment (e.g. "git+https://...#main" → "main")
 */
-function fetchIssuesByState(owner, repo, state, count, releasedAt, fromDate) {
-	const fetchCount = Math.min(count * 3, 100);
-	let datePart = "";
-	if (fromDate) datePart = state === "closed" ? `+closed:>=${fromDate}` : `+created:>=${fromDate}`;
-	else if (state === "closed") if (releasedAt) {
-		const date = new Date(releasedAt);
-		date.setMonth(date.getMonth() + 6);
-		datePart = `+closed:<=${isoDate(date.toISOString())}`;
-	} else datePart = `+closed:>${oneYearAgo()}`;
-	else if (releasedAt) {
-		const date = new Date(releasedAt);
-		date.setMonth(date.getMonth() + 6);
-		datePart = `+created:<=${isoDate(date.toISOString())}`;
-	}
-	const { stdout: result } = spawnSync("gh", [
-		"api",
-		`search/issues?q=${`repo:${owner}/${repo}+is:issue+is:${state}${datePart}`}&sort=reactions&order=desc&per_page=${fetchCount}`,
-		"-q",
-		".items[] | {number, title, state, labels: [.labels[]?.name], body, createdAt: .created_at, url: .html_url, reactions: .reactions[\"+1\"], comments: .comments, user: .user.login, userType: .user.type, authorAssociation: .author_association}"
-	], {
-		encoding: "utf-8",
-		maxBuffer: 10 * 1024 * 1024
-	});
-	if (!result) return [];
-	return result.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line)).filter((issue) => !BOT_USERS.has(issue.user) && issue.userType !== "Bot").filter((issue) => !isNoiseIssue(issue)).filter((issue) => !isNonTechnical(issue)).map(({ user: _, userType: __, authorAssociation, ...issue }) => {
-		const isMaintainer = [
-			"OWNER",
-			"MEMBER",
-			"COLLABORATOR"
-		].includes(authorAssociation);
-		const isRoadmap = /\broadmap\b/i.test(issue.title) || issue.labels.some((l) => /roadmap/i.test(l));
-		return {
-			...issue,
-			type: classifyIssue(issue.labels),
-			topComments: [],
-			score: freshnessScore(issue.reactions, issue.createdAt) * (isMaintainer && isRoadmap ? 5 : 1)
-		};
-	}).sort((a, b) => b.score - a.score).slice(0, count);
-}
-function oneYearAgo() {
-	const d = /* @__PURE__ */ new Date();
-	d.setFullYear(d.getFullYear() - 1);
-	return isoDate(d.toISOString());
+function extractBranchHint(url) {
+	const hash = url.indexOf("#");
+	if (hash === -1) return void 0;
+	const fragment = url.slice(hash + 1);
+	if (!fragment || fragment === "readme") return void 0;
+	return fragment;
 }
-/** Noise patterns in comments — filter these out */
-const COMMENT_NOISE_RE$1 = /^(?:\+1|👍|same here|any update|bump|following|is there any progress|when will this|me too|i have the same|same issue)[\s!?.]*$/i;
+//#endregion
+//#region src/sources/releases.ts
 /**
-* 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.
+* GitHub release notes fetching via GitHub API (preferred) with ungh.cc fallback
 */
-function enrichWithComments(owner, repo, issues, topN = 15) {
-	const worth = issues.filter((i) => i.comments > 0 && (i.type === "bug" || i.type === "question" || i.reactions >= 3)).sort((a, b) => b.score - a.score).slice(0, topN);
-	if (worth.length === 0) return;
-	const query = `query($owner: String!, $repo: String!) { repository(owner: $owner, name: $repo) { ${worth.map((issue, i) => `i${i}: issue(number: ${issue.number}) { comments(first: 10) { nodes { body author { login } authorAssociation reactions { totalCount } } } }`).join(" ")} } }`;
-	try {
-		const { stdout: result } = spawnSync("gh", [
-			"api",
-			"graphql",
-			"-f",
-			`query=${query}`,
-			"-f",
-			`owner=${owner}`,
-			"-f",
-			`repo=${repo}`
-		], {
-			encoding: "utf-8",
-			maxBuffer: 10 * 1024 * 1024
-		});
-		if (!result) return;
-		const repo_ = JSON.parse(result)?.data?.repository;
-		if (!repo_) return;
-		for (let i = 0; i < worth.length; i++) {
-			const nodes = repo_[`i${i}`]?.comments?.nodes;
-			if (!Array.isArray(nodes)) continue;
-			const issue = worth[i];
-			const comments = nodes.filter((c) => c.author && !BOT_USERS.has(c.author.login)).filter((c) => !COMMENT_NOISE_RE$1.test((c.body || "").trim())).map((c) => {
-				const isMaintainer = [
-					"OWNER",
-					"MEMBER",
-					"COLLABORATOR"
-				].includes(c.authorAssociation);
-				const body = c.body || "";
-				const reactions = c.reactions?.totalCount || 0;
-				const _score = (isMaintainer ? 3 : 1) * (hasCodeBlock$1(body) ? 2 : 1) * (1 + reactions);
-				return {
-					body,
-					author: c.author.login,
-					reactions,
-					isMaintainer,
-					_score
-				};
-			}).sort((a, b) => b._score - a._score);
-			issue.topComments = comments.slice(0, 3).map(({ _score: _, ...c }) => c);
-			if (issue.state === "closed") issue.resolvedIn = detectResolvedVersion(comments);
-		}
-	} catch {}
+function parseSemver(version) {
+	const clean = version.replace(/^v/, "");
+	const match = clean.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+	if (!match) return null;
+	return {
+		major: +match[1],
+		minor: match[2] ? +match[2] : 0,
+		patch: match[3] ? +match[3] : 0,
+		raw: clean
+	};
 }
 /**
-* Try to detect which version fixed a closed issue from maintainer comments.
-* Looks for version patterns in maintainer/collaborator comments.
+* 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 detectResolvedVersion(comments) {
-	const maintainerComments = comments.filter((c) => c.isMaintainer);
-	for (const c of maintainerComments.reverse()) {
-		const match = c.body.match(/(?:fixed|landed|released|available|shipped|resolved|included)\s+in\s+v?(\d+\.\d+(?:\.\d+)?)/i);
-		if (match) return match[1];
-		if (c.body.length < 100) {
-			const vMatch = c.body.match(/\bv?(\d+\.\d+\.\d+)\b/);
-			if (vMatch) return vMatch[1];
-		}
+function extractVersion(tag, packageName) {
+	if (packageName) {
+		const atMatch = tag.match(new RegExp(`^${escapeRegex(packageName)}@(.+)$`));
+		if (atMatch) return atMatch[1];
+		const dashMatch = tag.match(new RegExp(`^${escapeRegex(packageName)}-v?(.+)$`));
+		if (dashMatch) return dashMatch[1];
 	}
+	return tag.replace(/^v/, "");
+}
+function escapeRegex(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 /**
-* 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.
+* Check if a release tag belongs to a specific package
 */
-async function fetchGitHubIssues(owner, repo, limit = 30, releasedAt, fromDate) {
-	if (!isGhAvailable()) return [];
-	const openCount = Math.ceil(limit * .75);
-	const closedCount = limit - openCount;
-	try {
-		const open = fetchIssuesByState(owner, repo, "open", Math.min(openCount * 2, 100), releasedAt, fromDate);
-		const closed = fetchIssuesByState(owner, repo, "closed", Math.min(closedCount * 2, 50), releasedAt, fromDate);
-		const selected = applyTypeQuotas([...open, ...closed], limit);
-		enrichWithComments(owner, repo, selected);
-		return selected;
-	} catch {
-		return [];
-	}
+function tagMatchesPackage(tag, packageName) {
+	return tag.startsWith(`${packageName}@`) || tag.startsWith(`${packageName}-v`) || tag.startsWith(`${packageName}-`);
 }
 /**
-* Format a single issue as markdown with YAML frontmatter
+* Check if a version string contains a prerelease suffix (e.g. 6.0.0-beta, 1.2.3-rc.1)
 */
-function formatIssueAsMarkdown(issue) {
-	const limit = bodyLimit(issue.reactions);
-	const fmFields = {
-		number: issue.number,
-		title: issue.title,
-		type: issue.type,
-		state: issue.state,
-		created: isoDate(issue.createdAt),
-		url: issue.url,
-		reactions: issue.reactions,
-		comments: issue.comments
+function isPrerelease(version) {
+	return /^\d+\.\d+\.\d+-.+/.test(version.replace(/^v/, ""));
+}
+function compareSemver(a, b) {
+	if (a.major !== b.major) return a.major - b.major;
+	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,
+		tag: r.tag_name,
+		name: r.name,
+		prerelease: r.prerelease,
+		createdAt: r.created_at,
+		publishedAt: r.published_at,
+		markdown: r.body
 	};
-	if (issue.resolvedIn) fmFields.resolvedIn = issue.resolvedIn;
-	if (issue.labels.length > 0) fmFields.labels = `[${issue.labels.join(", ")}]`;
-	const lines = [
-		buildFrontmatter(fmFields),
-		"",
-		`# ${issue.title}`
-	];
-	if (issue.body) {
-		const body = truncateBody$1(issue.body, limit);
-		lines.push("", body);
-	}
-	if (issue.topComments.length > 0) {
-		lines.push("", "---", "", "## Top Comments");
-		for (const c of issue.topComments) {
-			const reactions = c.reactions > 0 ? ` (+${c.reactions})` : "";
-			const maintainer = c.isMaintainer ? " [maintainer]" : "";
-			const commentBody = truncateBody$1(c.body, 600);
-			lines.push("", `**@${c.author}**${maintainer}${reactions}:`, "", commentBody);
+}
+/**
+* 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;
+	const installedIsPrerelease = installedVersion ? isPrerelease(installedVersion) : false;
+	const fromTs = fromDate ? new Date(fromDate).getTime() : null;
+	const sorted = releases.filter((r) => {
+		const ver = extractVersion(r.tag, hasMonorepoTags ? packageName : void 0);
+		if (!ver) return false;
+		const sv = parseSemver(ver);
+		if (!sv) return false;
+		if (hasMonorepoTags && packageName && !tagMatchesPackage(r.tag, packageName)) return false;
+		if (fromTs) {
+			const pubDate = r.publishedAt || r.createdAt;
+			if (pubDate && new Date(pubDate).getTime() < fromTs) return false;
 		}
-	}
-	return lines.join("\n");
+		if (r.prerelease) {
+			if (!installedIsPrerelease || !installedSv) return false;
+			return sv.major === installedSv.major && sv.minor === installedSv.minor;
+		}
+		if (installedSv && compareSemver(sv, installedSv) > 0) return false;
+		return true;
+	}).sort((a, b) => {
+		const verA = extractVersion(a.tag, hasMonorepoTags ? packageName : void 0);
+		const verB = extractVersion(b.tag, hasMonorepoTags ? packageName : void 0);
+		if (!verA || !verB) return 0;
+		return compareSemver(parseSemver(verB), parseSemver(verA));
+	});
+	return fromDate ? sorted : sorted.slice(0, 20);
 }
 /**
-* Generate a summary index of all issues for quick LLM scanning.
-* Groups by type so the LLM can quickly find bugs vs questions.
+* Format a release as markdown with YAML frontmatter
 */
-function generateIssueIndex(issues) {
-	const byType = /* @__PURE__ */ new Map();
-	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
-	const typeLabels = {
-		bug: "Bugs & Regressions",
-		question: "Questions & Usage Help",
-		docs: "Documentation",
-		feature: "Feature Requests",
-		other: "Other"
-	};
-	const typeOrder = [
-		"bug",
-		"question",
-		"docs",
-		"other",
-		"feature"
+function formatRelease(release, packageName) {
+	const date = isoDate(release.publishedAt || release.createdAt);
+	const version = extractVersion(release.tag, packageName) || release.tag;
+	const fm = [
+		"---",
+		`tag: ${release.tag}`,
+		`version: ${version}`,
+		`published: ${date}`
 	];
-	const sections = [
+	if (release.name && release.name !== release.tag) fm.push(`name: "${release.name.replace(/"/g, "\\\"")}"`);
+	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,
+		packageName
+	} : releasesOrOpts;
+	const { releases, blogReleases, hasChangelog } = opts;
+	const pkg = opts.packageName;
+	const lines = [
 		[
 			"---",
-			`total: ${issues.length}`,
-			`open: ${issues.filter((i) => i.state === "open").length}`,
-			`closed: ${issues.filter((i) => i.state !== "open").length}`,
+			`total: ${releases.length + (blogReleases?.length ?? 0)}`,
+			`latest: ${releases[0]?.tag || "unknown"}`,
 			"---"
 		].join("\n"),
 		"",
-		"# Issues Index",
+		"# Releases Index",
 		""
 	];
-	for (const type of typeOrder) {
-		const group = byType.get(type);
-		if (!group?.length) continue;
-		sections.push(`## ${typeLabels[type]} (${group.length})`, "");
-		for (const issue of group) {
-			const reactions = issue.reactions > 0 ? ` (+${issue.reactions})` : "";
-			const state = issue.state === "open" ? "" : " [closed]";
-			const resolved = issue.resolvedIn ? ` [fixed in ${issue.resolvedIn}]` : "";
-			const date = isoDate(issue.createdAt);
-			sections.push(`- [#${issue.number}](./issue-${issue.number}.md): ${issue.title}${reactions}${state}${resolved} (${date})`);
+	if (blogReleases && blogReleases.length > 0) {
+		lines.push("## Blog Releases", "");
+		for (const b of blogReleases) lines.push(`- [${b.version}](./blog-${b.version}.md): ${b.title} (${b.date})`);
+		lines.push("");
+	}
+	if (releases.length > 0) {
+		if (blogReleases && blogReleases.length > 0) lines.push("## Release Notes", "");
+		for (const r of releases) {
+			const date = isoDate(r.publishedAt || r.createdAt);
+			const filename = r.tag.includes("@") || r.tag.startsWith("v") ? r.tag : `v${r.tag}`;
+			const sv = parseSemver(extractVersion(r.tag, pkg) || r.tag);
+			const label = sv?.patch === 0 && sv.minor === 0 ? " **[MAJOR]**" : sv?.patch === 0 ? " **[MINOR]**" : "";
+			lines.push(`- [${r.tag}](./${filename}.md): ${r.name || r.tag} (${date})${label}`);
 		}
-		sections.push("");
+		lines.push("");
 	}
-	return sections.join("\n");
-}
-/**
-* Shared utilities for doc resolution
-*/
-const $fetch = ofetch.create({
-	retry: 3,
-	retryDelay: 500,
-	timeout: 15e3,
-	headers: { "User-Agent": "skilld/1.0" }
-});
-/**
-* Fetch text content from URL
-*/
-async function fetchText(url) {
-	return $fetch(url, { responseType: "text" }).catch(() => null);
+	if (hasChangelog) {
+		lines.push("## Changelog", "");
+		lines.push("- [CHANGELOG.md](./CHANGELOG.md)");
+		lines.push("");
+	}
+	return lines.join("\n");
 }
 /**
-* Verify URL exists and is not HTML (likely 404 page)
+* Check if a single release is a stub redirecting to CHANGELOG.md.
+* Short body (<500 chars) that mentions CHANGELOG indicates no real content.
 */
-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");
+function isStubRelease(release) {
+	const body = (release.markdown || "").trim();
+	return body.length < 500 && /changelog\.md/i.test(body);
 }
 /**
-* Check if URL points to a social media or package registry site (not real docs)
+* Fetch CHANGELOG.md from a GitHub repo at a specific ref as fallback.
+* For monorepos, also checks packages/{shortName}/CHANGELOG.md.
 */
-const USELESS_HOSTS = new Set([
-	"twitter.com",
-	"x.com",
-	"facebook.com",
-	"linkedin.com",
-	"youtube.com",
-	"instagram.com",
-	"npmjs.com",
-	"www.npmjs.com",
-	"yarnpkg.com"
-]);
-function isUselessDocsUrl(url) {
-	try {
-		const { hostname } = new URL(url);
-		return USELESS_HOSTS.has(hostname);
-	} catch {
-		return false;
+async function fetchChangelog(owner, repo, ref, packageName) {
+	const paths = [];
+	if (packageName) {
+		const shortName = packageName.replace(/^@.*\//, "");
+		const scopeless = packageName.replace(/^@/, "").replace("/", "-");
+		const candidates = [...new Set([shortName, scopeless])];
+		for (const name of candidates) paths.push(`packages/${name}/CHANGELOG.md`);
 	}
-}
-/**
-* Check if URL is a GitHub repo URL (not a docs site)
-*/
-function isGitHubRepoUrl(url) {
-	try {
-		const parsed = new URL(url);
-		return parsed.hostname === "github.com" || parsed.hostname === "www.github.com";
-	} catch {
-		return false;
+	paths.push("CHANGELOG.md", "changelog.md", "CHANGES.md");
+	for (const path of paths) {
+		const content = await fetchGitHubRaw(`https://raw.githubusercontent.com/${owner}/${repo}/${ref}/${path}`);
+		if (content) return content;
 	}
+	return null;
 }
 /**
-* Parse owner/repo from GitHub URL
+* 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
 */
-function parseGitHubUrl(url) {
-	const match = url.match(/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:[/#]|$)/);
-	if (!match) return null;
-	return {
-		owner: match[1],
-		repo: match[2]
-	};
+async function fetchReleaseNotes(owner, repo, installedVersion, gitRef, packageName, fromDate, changelogRef) {
+	const selected = selectReleases(await fetchAllReleases(owner, repo), packageName, installedVersion, fromDate);
+	if (selected.length > 0) {
+		const docs = selected.filter((r) => !isStubRelease(r)).map((r) => {
+			return {
+				path: `releases/${r.tag.includes("@") || r.tag.startsWith("v") ? r.tag : `v${r.tag}`}.md`,
+				content: formatRelease(r, packageName)
+			};
+		});
+		const changelog = await fetchChangelog(owner, repo, changelogRef || gitRef || selected[0].tag, packageName);
+		if (changelog && changelog.length < 5e5) docs.push({
+			path: "releases/CHANGELOG.md",
+			content: changelog
+		});
+		return docs;
+	}
+	const changelog = await fetchChangelog(owner, repo, changelogRef || gitRef || "main", packageName);
+	if (!changelog) return [];
+	return [{
+		path: "releases/CHANGELOG.md",
+		content: changelog
+	}];
 }
+//#endregion
+//#region src/sources/blog-releases.ts
 /**
-* Normalize git repo URL to https
+* Format a blog release as markdown with YAML frontmatter
 */
-function normalizeRepoUrl(url) {
-	return url.replace(/^git\+/, "").replace(/#.*$/, "").replace(/\.git$/, "").replace(/^git:\/\//, "https://").replace(/^ssh:\/\/git@github\.com/, "https://github.com").replace(/^git@github\.com:/, "https://github.com/");
+function formatBlogRelease(release) {
+	return `${[
+		"---",
+		`version: ${release.version}`,
+		`title: "${release.title.replace(/"/g, "\\\"")}"`,
+		`date: ${release.date}`,
+		`url: ${release.url}`,
+		`source: blog-release`,
+		"---"
+	].join("\n")}\n\n# ${release.title}\n\n${release.markdown}`;
 }
 /**
-* 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" }
+* Fetch and parse a single blog post using preset metadata for version/date
 */
-function parsePackageSpec(spec) {
-	if (spec.startsWith("@")) {
-		const slashIdx = spec.indexOf("/");
-		if (slashIdx !== -1) {
-			const atIdx = spec.indexOf("@", slashIdx + 1);
-			if (atIdx !== -1) return {
-				name: spec.slice(0, atIdx),
-				tag: spec.slice(atIdx + 1)
-			};
+async function fetchBlogPost(entry) {
+	try {
+		const html = await $fetch(entry.url, {
+			responseType: "text",
+			signal: AbortSignal.timeout(1e4)
+		}).catch(() => null);
+		if (!html) return null;
+		let title = "";
+		const titleMatch = html.match(/<h1[^>]*>([^<]+)<\/h1>/);
+		if (titleMatch) title = titleMatch[1].trim();
+		if (!title) {
+			const metaTitleMatch = html.match(/<title>([^<]+)<\/title>/);
+			if (metaTitleMatch) title = metaTitleMatch[1].trim();
 		}
-		return { name: spec };
-	}
-	const atIdx = spec.indexOf("@");
-	if (atIdx !== -1) return {
-		name: spec.slice(0, atIdx),
-		tag: spec.slice(atIdx + 1)
-	};
-	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;
-	const fragment = url.slice(hash + 1);
-	if (!fragment || fragment === "readme") return void 0;
-	return fragment;
+		const markdown = htmlToMarkdown(html);
+		if (!markdown) return null;
+		return {
+			version: entry.version,
+			title: title || entry.title || `Release ${entry.version}`,
+			date: entry.date,
+			markdown,
+			url: entry.url
+		};
+	} catch {
+		return null;
+	}
 }
 /**
-* GitHub release notes fetching via gh CLI (preferred) with ungh.cc fallback
+* Filter blog releases by installed version
+* Only includes releases where version <= installedVersion
+* Returns all releases if version parsing fails (fail-safe)
 */
-function parseSemver(version) {
-	const clean = version.replace(/^v/, "");
-	const match = clean.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
-	if (!match) return null;
-	return {
-		major: +match[1],
-		minor: match[2] ? +match[2] : 0,
-		patch: match[3] ? +match[3] : 0,
-		raw: clean
-	};
+function filterBlogsByVersion(entries, installedVersion) {
+	const installedSv = parseSemver(installedVersion);
+	if (!installedSv) return entries;
+	return entries.filter((entry) => {
+		const entrySv = parseSemver(entry.version);
+		if (!entrySv) return false;
+		return compareSemver(entrySv, installedSv) <= 0;
+	});
 }
 /**
-* 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`
+* 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
 */
-function extractVersion(tag, packageName) {
-	if (packageName) {
-		const atMatch = tag.match(new RegExp(`^${escapeRegex(packageName)}@(.+)$`));
-		if (atMatch) return atMatch[1];
-		const dashMatch = tag.match(new RegExp(`^${escapeRegex(packageName)}-v?(.+)$`));
-		if (dashMatch) return dashMatch[1];
+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);
 	}
-	return tag.replace(/^v/, "");
-}
-function escapeRegex(str) {
-	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	if (releases.length === 0) return [];
+	releases.sort((a, b) => {
+		const aVer = a.version.split(".").map(Number);
+		const bVer = b.version.split(".").map(Number);
+		for (let i = 0; i < Math.max(aVer.length, bVer.length); i++) {
+			const diff = (bVer[i] ?? 0) - (aVer[i] ?? 0);
+			if (diff !== 0) return diff;
+		}
+		return 0;
+	});
+	return releases.map((r) => ({
+		path: `releases/blog-${r.version}.md`,
+		content: formatBlogRelease(r)
+	}));
 }
+//#endregion
+//#region src/sources/crawl.ts
 /**
-* Check if a release tag belongs to a specific package
+* Website crawl doc source — fetches docs by crawling a URL pattern
 */
-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)
+* 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)
 */
-function isPrerelease(version) {
-	return /^\d+\.\d+\.\d+-.+/.test(version.replace(/^v/, ""));
+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;
 }
-function compareSemver(a, b) {
-	if (a.major !== b.major) return a.major - b.major;
-	if (a.minor !== b.minor) return a.minor - b.minor;
-	return a.patch - b.patch;
+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;
 /**
-* Fetch releases via gh CLI (fast, authenticated, paginated)
+* Check if gh CLI is installed and authenticated (cached)
 */
-function fetchReleasesViaGh(owner, repo) {
-	try {
-		const { stdout: ndjson } = spawnSync("gh", [
-			"api",
-			`repos/${owner}/${repo}/releases`,
-			"--paginate",
-			"--jq",
-			".[] | {id: .id, tag: .tag_name, name: .name, prerelease: .prerelease, createdAt: .created_at, publishedAt: .published_at, markdown: .body}"
-		], {
-			encoding: "utf-8",
-			timeout: 3e4,
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			]
-		});
-		if (!ndjson) return [];
-		return ndjson.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line));
-	} catch {
-		return [];
-	}
+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",
+	"invalid",
+	"wontfix",
+	"won't fix",
+	"spam",
+	"off-topic",
+	"needs triage",
+	"triage"
+]);
+/** Labels that indicate feature requests — deprioritize */
+const FEATURE_LABELS = new Set([
+	"enhancement",
+	"feature",
+	"feature request",
+	"feature-request",
+	"proposal",
+	"rfc",
+	"idea",
+	"suggestion"
+]);
+const BUG_LABELS = new Set([
+	"bug",
+	"defect",
+	"regression",
+	"error",
+	"crash",
+	"fix",
+	"confirmed",
+	"verified"
+]);
+const QUESTION_LABELS = new Set([
+	"question",
+	"help wanted",
+	"support",
+	"usage",
+	"how-to",
+	"help",
+	"assistance"
+]);
+const DOCS_LABELS = new Set([
+	"documentation",
+	"docs",
+	"doc",
+	"typo"
+]);
 /**
-* Fetch all releases from a GitHub repo via ungh.cc (fallback)
+* Check if a label contains any keyword from a set.
+* Handles emoji-prefixed labels like ":sparkles: feature request" or ":lady_beetle: bug".
 */
-async function fetchReleasesViaUngh(owner, repo) {
-	return (await $fetch(`https://ungh.cc/repos/${owner}/${repo}/releases`, { signal: AbortSignal.timeout(15e3) }).catch(() => null))?.releases ?? [];
+function labelMatchesAny(label, keywords) {
+	for (const keyword of keywords) if (label === keyword || label.includes(keyword)) return true;
+	return false;
 }
 /**
-* Fetch all releases — gh CLI first, ungh.cc fallback
+* Classify an issue by its labels into a type useful for skill generation
 */
-async function fetchAllReleases(owner, repo) {
-	if (isGhAvailable()) {
-		const releases = fetchReleasesViaGh(owner, repo);
-		if (releases.length > 0) return releases;
-	}
-	return fetchReleasesViaUngh(owner, repo);
+function classifyIssue(labels) {
+	const lower = labels.map((l) => l.toLowerCase());
+	if (lower.some((l) => labelMatchesAny(l, BUG_LABELS))) return "bug";
+	if (lower.some((l) => labelMatchesAny(l, QUESTION_LABELS))) return "question";
+	if (lower.some((l) => labelMatchesAny(l, DOCS_LABELS))) return "docs";
+	if (lower.some((l) => labelMatchesAny(l, FEATURE_LABELS))) return "feature";
+	return "other";
 }
 /**
-* 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.
+* Check if an issue should be filtered out entirely
 */
-function selectReleases(releases, packageName, installedVersion, fromDate) {
-	const hasMonorepoTags = packageName && releases.some((r) => tagMatchesPackage(r.tag, packageName));
-	const installedSv = installedVersion ? parseSemver(installedVersion) : null;
-	const installedIsPrerelease = installedVersion ? isPrerelease(installedVersion) : false;
-	const fromTs = fromDate ? new Date(fromDate).getTime() : null;
-	const sorted = releases.filter((r) => {
-		const ver = extractVersion(r.tag, hasMonorepoTags ? packageName : void 0);
-		if (!ver) return false;
-		const sv = parseSemver(ver);
-		if (!sv) return false;
-		if (hasMonorepoTags && packageName && !tagMatchesPackage(r.tag, packageName)) return false;
-		if (fromTs) {
-			const pubDate = r.publishedAt || r.createdAt;
-			if (pubDate && new Date(pubDate).getTime() < fromTs) return false;
-		}
-		if (r.prerelease) {
-			if (!installedIsPrerelease || !installedSv) return false;
-			return sv.major === installedSv.major && sv.minor === installedSv.minor;
-		}
-		if (installedSv && compareSemver(sv, installedSv) > 0) return false;
-		return true;
-	}).sort((a, b) => {
-		const verA = extractVersion(a.tag, hasMonorepoTags ? packageName : void 0);
-		const verB = extractVersion(b.tag, hasMonorepoTags ? packageName : void 0);
-		if (!verA || !verB) return 0;
-		return compareSemver(parseSemver(verB), parseSemver(verA));
-	});
-	return fromDate ? sorted : sorted.slice(0, 20);
+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;
+}
+/** Check if body contains a code block */
+function hasCodeBlock$1(text) {
+	return /```[\s\S]*?```/.test(text) || /`[^`]+`/.test(text);
+}
+/**
+* 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$1(body) && issue.reactions > 50) return true;
+	if (/\b(?:love|thank|awesome|great work)\b/i.test(issue.title) && !hasCodeBlock$1(body)) return true;
+	return false;
 }
 /**
-* Format a release as markdown with YAML frontmatter
+* 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 formatRelease(release, packageName) {
-	const date = isoDate(release.publishedAt || release.createdAt);
-	const version = extractVersion(release.tag, packageName) || release.tag;
-	const fm = [
-		"---",
-		`tag: ${release.tag}`,
-		`version: ${version}`,
-		`published: ${date}`
-	];
-	if (release.name && release.name !== release.tag) fm.push(`name: "${release.name.replace(/"/g, "\\\"")}"`);
-	fm.push("---");
-	return `${fm.join("\n")}\n\n# ${release.name || release.tag}\n\n${release.markdown}`;
+function freshnessScore(reactions, createdAt) {
+	return reactions * (1 / (1 + (Date.now() - new Date(createdAt).getTime()) / (365.25 * 24 * 60 * 60 * 1e3) * .6));
 }
 /**
-* Generate a unified summary index of all releases for quick LLM scanning.
-* Includes GitHub releases, blog release posts, and CHANGELOG link.
+* Type quotas — guarantee a mix of issue types.
+* Bugs and questions get priority; feature requests are hard-capped.
 */
-function generateReleaseIndex(releasesOrOpts, packageName) {
-	const opts = Array.isArray(releasesOrOpts) ? {
-		releases: releasesOrOpts,
-		packageName
-	} : releasesOrOpts;
-	const { releases, blogReleases, hasChangelog } = opts;
-	const pkg = opts.packageName;
-	const lines = [
-		[
-			"---",
-			`total: ${releases.length + (blogReleases?.length ?? 0)}`,
-			`latest: ${releases[0]?.tag || "unknown"}`,
-			"---"
-		].join("\n"),
-		"",
-		"# Releases Index",
-		""
+function applyTypeQuotas(issues, limit) {
+	const byType = /* @__PURE__ */ new Map();
+	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
+	for (const group of byType.values()) group.sort((a, b) => b.score - a.score);
+	const quotas = [
+		["bug", Math.ceil(limit * .4)],
+		["question", Math.ceil(limit * .3)],
+		["docs", Math.ceil(limit * .15)],
+		["feature", Math.ceil(limit * .1)],
+		["other", Math.ceil(limit * .05)]
 	];
-	if (blogReleases && blogReleases.length > 0) {
-		lines.push("## Blog Releases", "");
-		for (const b of blogReleases) lines.push(`- [${b.version}](./blog-${b.version}.md): ${b.title} (${b.date})`);
-		lines.push("");
-	}
-	if (releases.length > 0) {
-		if (blogReleases && blogReleases.length > 0) lines.push("## Release Notes", "");
-		for (const r of releases) {
-			const date = isoDate(r.publishedAt || r.createdAt);
-			const filename = r.tag.includes("@") || r.tag.startsWith("v") ? r.tag : `v${r.tag}`;
-			const sv = parseSemver(extractVersion(r.tag, pkg) || r.tag);
-			const label = sv?.patch === 0 && sv.minor === 0 ? " **[MAJOR]**" : sv?.patch === 0 ? " **[MINOR]**" : "";
-			lines.push(`- [${r.tag}](./${filename}.md): ${r.name || r.tag} (${date})${label}`);
+	const selected = [];
+	const used = /* @__PURE__ */ new Set();
+	let remaining = limit;
+	for (const [type, quota] of quotas) {
+		const group = byType.get(type) || [];
+		const take = Math.min(quota, group.length, remaining);
+		for (let i = 0; i < take; i++) {
+			selected.push(group[i]);
+			used.add(group[i].number);
+			remaining--;
 		}
-		lines.push("");
 	}
-	if (hasChangelog) {
-		lines.push("## Changelog", "");
-		lines.push("- [CHANGELOG.md](./CHANGELOG.md)");
-		lines.push("");
+	if (remaining > 0) {
+		const unused = issues.filter((i) => !used.has(i.number) && i.type !== "feature").sort((a, b) => b.score - a.score);
+		for (const issue of unused) {
+			if (remaining <= 0) break;
+			selected.push(issue);
+			remaining--;
+		}
 	}
-	return lines.join("\n");
+	return selected.sort((a, b) => b.score - a.score);
 }
 /**
-* Check if a single release is a stub redirecting to CHANGELOG.md.
-* Short body (<500 chars) that mentions CHANGELOG indicates no real content.
+* Body truncation limit based on reactions — high-reaction issues deserve more space
 */
-function isStubRelease(release) {
-	const body = (release.markdown || "").trim();
-	return body.length < 500 && /changelog\.md/i.test(body);
+function bodyLimit(reactions) {
+	if (reactions >= 10) return 2e3;
+	if (reactions >= 5) return 1500;
+	return 800;
 }
 /**
-* Fetch CHANGELOG.md from a GitHub repo at a specific ref as fallback.
-* For monorepos, also checks packages/{shortName}/CHANGELOG.md.
+* Smart body truncation — preserves code blocks and error messages.
+* Instead of slicing at a char limit, finds a safe break point.
 */
-async function fetchChangelog(owner, repo, ref, packageName) {
-	const paths = [];
-	if (packageName) {
-		const shortName = packageName.replace(/^@.*\//, "");
-		const scopeless = packageName.replace(/^@/, "").replace("/", "-");
-		const candidates = [...new Set([shortName, scopeless])];
-		for (const name of candidates) paths.push(`packages/${name}/CHANGELOG.md`);
+function truncateBody$1(body, limit) {
+	if (body.length <= limit) return body;
+	const codeBlockRe = /```[\s\S]*?```/g;
+	let lastSafeEnd = limit;
+	let match;
+	while ((match = codeBlockRe.exec(body)) !== null) {
+		const blockStart = match.index;
+		const blockEnd = blockStart + match[0].length;
+		if (blockStart < limit && blockEnd > limit) {
+			if (blockEnd <= limit + 500) lastSafeEnd = blockEnd;
+			else lastSafeEnd = blockStart;
+			break;
+		}
 	}
-	paths.push("CHANGELOG.md", "changelog.md", "CHANGES.md");
-	for (const path of paths) {
-		const content = await $fetch(`https://raw.githubusercontent.com/${owner}/${repo}/${ref}/${path}`, {
-			responseType: "text",
-			signal: AbortSignal.timeout(1e4)
-		}).catch(() => null);
-		if (content) return content;
+	const slice = body.slice(0, lastSafeEnd);
+	const lastParagraph = slice.lastIndexOf("\n\n");
+	if (lastParagraph > lastSafeEnd * .6) return `${slice.slice(0, lastParagraph)}\n\n...`;
+	return `${slice}...`;
+}
+/**
+* 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 = "";
+	if (fromDate) datePart = state === "closed" ? `+closed:>=${fromDate}` : `+created:>=${fromDate}`;
+	else if (state === "closed") if (releasedAt) {
+		const date = new Date(releasedAt);
+		date.setMonth(date.getMonth() + 6);
+		datePart = `+closed:<=${isoDate(date.toISOString())}`;
+	} else datePart = `+closed:>${oneYearAgo()}`;
+	else if (releasedAt) {
+		const date = new Date(releasedAt);
+		date.setMonth(date.getMonth() + 6);
+		datePart = `+created:<=${isoDate(date.toISOString())}`;
 	}
-	return null;
+	const { stdout: result } = spawnSync("gh", [
+		"api",
+		`search/issues?q=${`repo:${owner}/${repo}+is:issue+is:${state}${datePart}`}&sort=reactions&order=desc&per_page=${fetchCount}`,
+		"-q",
+		".items[] | {number, title, state, labels: [.labels[]?.name], body, createdAt: .created_at, url: .html_url, reactions: .reactions[\"+1\"], comments: .comments, user: .user.login, userType: .user.type, authorAssociation: .author_association}"
+	], {
+		encoding: "utf-8",
+		maxBuffer: 10 * 1024 * 1024
+	});
+	if (!result) return [];
+	return result.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line)).filter((issue) => !BOT_USERS.has(issue.user) && issue.userType !== "Bot").filter((issue) => !isNoiseIssue(issue)).filter((issue) => !isNonTechnical(issue)).map(({ user: _, userType: __, authorAssociation, ...issue }) => {
+		const isMaintainer = [
+			"OWNER",
+			"MEMBER",
+			"COLLABORATOR"
+		].includes(authorAssociation);
+		const isRoadmap = /\broadmap\b/i.test(issue.title) || issue.labels.some((l) => /roadmap/i.test(l));
+		return {
+			...issue,
+			type: classifyIssue(issue.labels),
+			topComments: [],
+			score: freshnessScore(issue.reactions, issue.createdAt) * (isMaintainer && isRoadmap ? 5 : 1)
+		};
+	}).sort((a, b) => b.score - a.score).slice(0, count);
+}
+function oneYearAgo() {
+	const d = /* @__PURE__ */ new Date();
+	d.setFullYear(d.getFullYear() - 1);
+	return isoDate(d.toISOString());
 }
+/** Noise patterns in comments — filter these out */
+const COMMENT_NOISE_RE$1 = /^(?:\+1|👍|same here|any update|bump|following|is there any progress|when will this|me too|i have the same|same issue)[\s!?.]*$/i;
 /**
-* 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
+* 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.
 */
-async function fetchReleaseNotes(owner, repo, installedVersion, gitRef, packageName, fromDate, changelogRef) {
-	const selected = selectReleases(await fetchAllReleases(owner, repo), packageName, installedVersion, fromDate);
-	if (selected.length > 0) {
-		const docs = selected.filter((r) => !isStubRelease(r)).map((r) => {
-			return {
-				path: `releases/${r.tag.includes("@") || r.tag.startsWith("v") ? r.tag : `v${r.tag}`}.md`,
-				content: formatRelease(r, packageName)
-			};
-		});
-		const changelog = await fetchChangelog(owner, repo, changelogRef || gitRef || selected[0].tag, packageName);
-		if (changelog && changelog.length < 5e5) docs.push({
-			path: "releases/CHANGELOG.md",
-			content: changelog
+function enrichWithComments(owner, repo, issues, topN = 15) {
+	const worth = issues.filter((i) => i.comments > 0 && (i.type === "bug" || i.type === "question" || i.reactions >= 3)).sort((a, b) => b.score - a.score).slice(0, topN);
+	if (worth.length === 0) return;
+	const query = `query($owner: String!, $repo: String!) { repository(owner: $owner, name: $repo) { ${worth.map((issue, i) => `i${i}: issue(number: ${issue.number}) { comments(first: 10) { nodes { body author { login } authorAssociation reactions { totalCount } } } }`).join(" ")} } }`;
+	try {
+		const { stdout: result } = spawnSync("gh", [
+			"api",
+			"graphql",
+			"-f",
+			`query=${query}`,
+			"-f",
+			`owner=${owner}`,
+			"-f",
+			`repo=${repo}`
+		], {
+			encoding: "utf-8",
+			maxBuffer: 10 * 1024 * 1024
 		});
-		return docs;
-	}
-	const changelog = await fetchChangelog(owner, repo, changelogRef || gitRef || "main", packageName);
-	if (!changelog) return [];
-	return [{
-		path: "releases/CHANGELOG.md",
-		content: changelog
-	}];
+		if (!result) return;
+		const repo_ = JSON.parse(result)?.data?.repository;
+		if (!repo_) return;
+		for (let i = 0; i < worth.length; i++) {
+			const nodes = repo_[`i${i}`]?.comments?.nodes;
+			if (!Array.isArray(nodes)) continue;
+			const issue = worth[i];
+			const comments = nodes.filter((c) => c.author && !BOT_USERS.has(c.author.login)).filter((c) => !COMMENT_NOISE_RE$1.test((c.body || "").trim())).map((c) => {
+				const isMaintainer = [
+					"OWNER",
+					"MEMBER",
+					"COLLABORATOR"
+				].includes(c.authorAssociation);
+				const body = c.body || "";
+				const reactions = c.reactions?.totalCount || 0;
+				const _score = (isMaintainer ? 3 : 1) * (hasCodeBlock$1(body) ? 2 : 1) * (1 + reactions);
+				return {
+					body,
+					author: c.author.login,
+					reactions,
+					isMaintainer,
+					_score
+				};
+			}).sort((a, b) => b._score - a._score);
+			issue.topComments = comments.slice(0, 3).map(({ _score: _, ...c }) => c);
+			if (issue.state === "closed") issue.resolvedIn = detectResolvedVersion(comments);
+		}
+	} catch {}
 }
 /**
-* Format a blog release as markdown with YAML frontmatter
+* Try to detect which version fixed a closed issue from maintainer comments.
+* Looks for version patterns in maintainer/collaborator comments.
 */
-function formatBlogRelease(release) {
-	return `${[
-		"---",
-		`version: ${release.version}`,
-		`title: "${release.title.replace(/"/g, "\\\"")}"`,
-		`date: ${release.date}`,
-		`url: ${release.url}`,
-		`source: blog-release`,
-		"---"
-	].join("\n")}\n\n# ${release.title}\n\n${release.markdown}`;
+function detectResolvedVersion(comments) {
+	const maintainerComments = comments.filter((c) => c.isMaintainer);
+	for (const c of maintainerComments.reverse()) {
+		const match = c.body.match(/(?:fixed|landed|released|available|shipped|resolved|included)\s+in\s+v?(\d+\.\d+(?:\.\d+)?)/i);
+		if (match) return match[1];
+		if (c.body.length < 100) {
+			const vMatch = c.body.match(/\bv?(\d+\.\d+\.\d+)\b/);
+			if (vMatch) return vMatch[1];
+		}
+	}
 }
 /**
-* Fetch and parse a single blog post using preset metadata for version/date
+* 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 fetchBlogPost(entry) {
+async function fetchGitHubIssues(owner, repo, limit = 30, releasedAt, fromDate) {
+	if (!isGhAvailable()) return [];
+	const openCount = Math.ceil(limit * .75);
+	const closedCount = limit - openCount;
 	try {
-		const html = await $fetch(entry.url, {
-			responseType: "text",
-			signal: AbortSignal.timeout(1e4)
-		}).catch(() => null);
-		if (!html) return null;
-		let title = "";
-		const titleMatch = html.match(/<h1[^>]*>([^<]+)<\/h1>/);
-		if (titleMatch) title = titleMatch[1].trim();
-		if (!title) {
-			const metaTitleMatch = html.match(/<title>([^<]+)<\/title>/);
-			if (metaTitleMatch) title = metaTitleMatch[1].trim();
-		}
-		const markdown = htmlToMarkdown(html);
-		if (!markdown) return null;
-		return {
-			version: entry.version,
-			title: title || entry.title || `Release ${entry.version}`,
-			date: entry.date,
-			markdown,
-			url: entry.url
-		};
+		const open = fetchIssuesByState(owner, repo, "open", Math.min(openCount * 2, 100), releasedAt, fromDate);
+		const closed = fetchIssuesByState(owner, repo, "closed", Math.min(closedCount * 2, 50), releasedAt, fromDate);
+		const selected = applyTypeQuotas([...open, ...closed], limit);
+		enrichWithComments(owner, repo, selected);
+		return selected;
 	} catch {
-		return null;
+		return [];
 	}
 }
 /**
-* 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;
-	return entries.filter((entry) => {
-		const entrySv = parseSemver(entry.version);
-		if (!entrySv) return false;
-		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
+* Format a single issue as markdown with YAML frontmatter
 */
-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);
+function formatIssueAsMarkdown(issue) {
+	const limit = bodyLimit(issue.reactions);
+	const fmFields = {
+		number: issue.number,
+		title: issue.title,
+		type: issue.type,
+		state: issue.state,
+		created: isoDate(issue.createdAt),
+		url: issue.url,
+		reactions: issue.reactions,
+		comments: issue.comments
+	};
+	if (issue.resolvedIn) fmFields.resolvedIn = issue.resolvedIn;
+	if (issue.labels.length > 0) fmFields.labels = `[${issue.labels.join(", ")}]`;
+	const lines = [
+		buildFrontmatter(fmFields),
+		"",
+		`# ${issue.title}`
+	];
+	if (issue.body) {
+		const body = truncateBody$1(issue.body, limit);
+		lines.push("", body);
 	}
-	if (releases.length === 0) return [];
-	releases.sort((a, b) => {
-		const aVer = a.version.split(".").map(Number);
-		const bVer = b.version.split(".").map(Number);
-		for (let i = 0; i < Math.max(aVer.length, bVer.length); i++) {
-			const diff = (bVer[i] ?? 0) - (aVer[i] ?? 0);
-			if (diff !== 0) return diff;
+	if (issue.topComments.length > 0) {
+		lines.push("", "---", "", "## Top Comments");
+		for (const c of issue.topComments) {
+			const reactions = c.reactions > 0 ? ` (+${c.reactions})` : "";
+			const maintainer = c.isMaintainer ? " [maintainer]" : "";
+			const commentBody = truncateBody$1(c.body, 600);
+			lines.push("", `**@${c.author}**${maintainer}${reactions}:`, "", commentBody);
 		}
-		return 0;
-	});
-	return releases.map((r) => ({
-		path: `releases/blog-${r.version}.md`,
-		content: formatBlogRelease(r)
-	}));
+	}
+	return lines.join("\n");
 }
 /**
-* 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)
+* Generate a summary index of all issues for quick LLM scanning.
+* Groups by type so the LLM can quickly find bugs vs questions.
 */
-async function fetchCrawledDocs(url, onProgress, maxPages = 200) {
-	const outputDir = join(tmpdir(), "skilld-crawl", Date.now().toString());
-	onProgress?.(`Crawling ${url}`);
-	const doCrawl = () => crawlAndGenerate({
-		urls: [url],
-		outputDir,
-		driver: "http",
-		generateLlmsTxt: false,
-		generateIndividualMd: false,
-		maxRequestsPerCrawl: maxPages
-	}, (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 = [];
-	for (const result of results) {
-		if (!result.success || !result.content) continue;
-		const path = `docs/${(new URL(result.url).pathname.replace(/\/$/, "") || "/index").split("/").filter(Boolean).join("/")}.md`;
-		docs.push({
-			path,
-			content: result.content
-		});
+function generateIssueIndex(issues) {
+	const byType = /* @__PURE__ */ new Map();
+	for (const issue of issues) mapInsert(byType, issue.type, () => []).push(issue);
+	const typeLabels = {
+		bug: "Bugs & Regressions",
+		question: "Questions & Usage Help",
+		docs: "Documentation",
+		feature: "Feature Requests",
+		other: "Other"
+	};
+	const typeOrder = [
+		"bug",
+		"question",
+		"docs",
+		"other",
+		"feature"
+	];
+	const sections = [
+		[
+			"---",
+			`total: ${issues.length}`,
+			`open: ${issues.filter((i) => i.state === "open").length}`,
+			`closed: ${issues.filter((i) => i.state !== "open").length}`,
+			"---"
+		].join("\n"),
+		"",
+		"# Issues Index",
+		""
+	];
+	for (const type of typeOrder) {
+		const group = byType.get(type);
+		if (!group?.length) continue;
+		sections.push(`## ${typeLabels[type]} (${group.length})`, "");
+		for (const issue of group) {
+			const reactions = issue.reactions > 0 ? ` (+${issue.reactions})` : "";
+			const state = issue.state === "open" ? "" : " [closed]";
+			const resolved = issue.resolvedIn ? ` [fixed in ${issue.resolvedIn}]` : "";
+			const date = isoDate(issue.createdAt);
+			sections.push(`- [#${issue.number}](./issue-${issue.number}.md): ${issue.title}${reactions}${state}${resolved} (${date})`);
+		}
+		sections.push("");
 	}
-	onProgress?.(`Crawled ${docs.length} pages`);
-	return docs;
-}
-/** Append glob pattern to a docs URL for crawling */
-function toCrawlPattern(docsUrl) {
-	return `${docsUrl.replace(/\/+$/, "")}/**`;
+	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
@@ -1163,6 +1314,8 @@ function generateDiscussionIndex(discussions) {
 	}
 	return sections.join("\n");
 }
+//#endregion
+//#region src/sources/docs.ts
 /**
 * Docs index generation — creates _INDEX.md for docs directory
 */
@@ -1215,6 +1368,8 @@ function generateDocsIndex(docs) {
 	}
 	return sections.join("\n");
 }
+//#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.
@@ -1275,6 +1430,8 @@ async function resolveEntryFiles(packageDir) {
 	}
 	return entries;
 }
+//#endregion
+//#region src/sources/git-skills.ts
 /**
 * Git repo skill source — parse inputs + fetch pre-authored skills from repos
 *
@@ -1430,7 +1587,8 @@ async function downloadGitHubSkills(owner, repo, ref, skillPath, onProgress) {
 			onProgress?.(`Downloading ${owner}/${repo}/${skillPath}@${ref}`);
 			const { dir } = await downloadTemplate(`github:${owner}/${repo}/${skillPath}#${ref}`, {
 				dir: tempDir,
-				force: true
+				force: true,
+				auth: getGitHubToken() || void 0
 			});
 			const skill = readLocalSkill(dir, skillPath);
 			return skill ? [skill] : [];
@@ -1439,7 +1597,8 @@ async function downloadGitHubSkills(owner, repo, ref, skillPath, onProgress) {
 		try {
 			const { dir } = await downloadTemplate(`github:${owner}/${repo}/skills#${ref}`, {
 				dir: tempDir,
-				force: true
+				force: true,
+				auth: getGitHubToken() || void 0
 			});
 			const skills = [];
 			for (const entry of readdirSync(dir, { withFileTypes: true })) {
@@ -1452,7 +1611,7 @@ async function downloadGitHubSkills(owner, repo, ref, skillPath, onProgress) {
 				return skills;
 			}
 		} catch {}
-		const content = await $fetch(`https://raw.githubusercontent.com/${owner}/${repo}/${ref}/SKILL.md`, { responseType: "text" }).catch(() => null);
+		const content = await fetchGitHubRaw(`https://raw.githubusercontent.com/${owner}/${repo}/${ref}/SKILL.md`);
 		if (content) {
 			const fm = parseSkillFrontmatterName(content);
 			onProgress?.("Found 1 skill");
@@ -1521,6 +1680,8 @@ async function fetchGitLabSkills(source, onProgress) {
 		});
 	}
 }
+//#endregion
+//#region src/sources/llms.ts
 /**
 * Check for llms.txt at a docs URL, returns the llms.txt URL if found
 */
@@ -1612,15 +1773,27 @@ function extractSections(content, patterns) {
 	if (sections.length === 0) return null;
 	return sections.join("\n\n---\n\n");
 }
+//#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 < MIN_GIT_DOCS;
+const isShallowGitDocs = (n) => n > 0 && n < 5;
 /**
-* List files at a git ref using ungh (no rate limits)
+* 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) {
-	return (await $fetch(`https://ungh.cc/repos/${owner}/${repo}/files/${ref}`).catch(() => null))?.files?.map((f) => f.path) ?? [];
+	if (!isKnownPrivateRepo(owner, repo)) {
+		const data = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/files/${ref}`).catch(() => null);
+		if (data?.files?.length) return data.files.map((f) => f.path);
+	}
+	const tree = await ghApi(`repos/${owner}/${repo}/git/trees/${ref}?recursive=1`);
+	if (tree?.tree?.length) {
+		markRepoPrivate(owner, repo);
+		return tree.tree.map((f) => f.path);
+	}
+	return [];
 }
 /**
 * Find git tag for a version by checking if ungh can list files at that ref.
@@ -1658,13 +1831,29 @@ async function findGitTag(owner, repo, version, packageName, branchHint) {
 	return null;
 }
 /**
-* Find the latest release tag matching `{packageName}@*` via ungh releases API.
-* Handles monorepos where npm version doesn't match git tag version.
+* 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;
+	}
+	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 [];
+}
+/**
+* Find the latest release tag matching `{packageName}@*`.
 */
 async function findLatestReleaseTag(owner, repo, packageName) {
-	const data = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/releases`).catch(() => null);
 	const prefix = `${packageName}@`;
-	return data?.releases?.find((r) => r.tag.startsWith(prefix))?.tag ?? null;
+	return (await fetchUnghReleases(owner, repo)).find((r) => r.tag.startsWith(prefix))?.tag ?? null;
 }
 /**
 * Filter file paths by prefix and md/mdx extension
@@ -1804,7 +1993,7 @@ function discoverDocFiles(allFiles, packageName) {
 		mapInsert(dirGroups, file.slice(0, lastSlash + 1), () => []).push(file);
 	}
 	if (dirGroups.size === 0) return null;
-	const scored = [...dirGroups.entries()].map(([dir, files]) => ({
+	const scored = Array.from(dirGroups.entries(), ([dir, files]) => ({
 		dir,
 		files,
 		score: scoreDocDir(dir, files.length)
@@ -1914,7 +2103,7 @@ async function verifyNpmRepo(owner, repo, packageName) {
 		`packages/${packageName.replace(/^@/, "").replace("/", "-")}/package.json`
 	];
 	for (const path of paths) {
-		const text = await fetchText(`${base}/${path}`);
+		const text = await fetchGitHubRaw(`${base}/${path}`);
 		if (!text) continue;
 		try {
 			if (JSON.parse(text).name === packageName) return true;
@@ -1971,38 +2160,35 @@ async function searchGitHubRepo(packageName) {
 async function fetchGitHubRepoMeta(owner, repo, packageName) {
 	const override = packageName ? getDocOverride(packageName) : void 0;
 	if (override?.homepage) return { homepage: override.homepage };
-	if (isGhAvailable()) try {
-		const { stdout: json } = spawnSync("gh", [
-			"api",
-			`repos/${owner}/${repo}`,
-			"-q",
-			"{homepage}"
-		], {
-			encoding: "utf-8",
-			timeout: 1e4
-		});
-		if (!json) throw new Error("no output");
-		const data = JSON.parse(json);
-		return data?.homepage ? { homepage: data.homepage } : null;
-	} catch {}
-	const data = await $fetch(`https://api.github.com/repos/${owner}/${repo}`).catch(() => null);
+	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;
 }
 /**
 * Resolve README URL for a GitHub repo, returns ungh:// pseudo-URL or raw URL
 */
 async function fetchReadme(owner, repo, subdir, ref) {
-	const unghUrl = subdir ? `https://ungh.cc/repos/${owner}/${repo}/files/${ref || "main"}/${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 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}` : ""}`;
+	}
 	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).catch(() => null))?.ok) return readmeUrl;
+		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 apiData.download_url;
 	}
 	return null;
 }
@@ -2036,6 +2222,7 @@ async function fetchReadmeContent(url) {
 			return text;
 		}
 	}
+	if (url.includes("raw.githubusercontent.com")) return fetchGitHubRaw(url);
 	return fetchText(url);
 }
 /**
@@ -2045,34 +2232,14 @@ async function fetchReadmeContent(url) {
 async function resolveGitHubRepo(owner, repo, onProgress) {
 	onProgress?.("Fetching repo metadata");
 	const repoUrl = `https://github.com/${owner}/${repo}`;
-	let homepage;
-	let description;
-	if (isGhAvailable()) try {
-		const { stdout: json } = spawnSync("gh", [
-			"api",
-			`repos/${owner}/${repo}`,
-			"--jq",
-			"{homepage: .homepage, description: .description}"
-		], {
-			encoding: "utf-8",
-			timeout: 1e4
-		});
-		if (json) {
-			const data = JSON.parse(json);
-			homepage = data.homepage || void 0;
-			description = data.description || void 0;
-		}
-	} catch {}
-	if (!homepage && !description) {
-		const data = await $fetch(`https://api.github.com/repos/${owner}/${repo}`).catch(() => null);
-		homepage = data?.homepage || void 0;
-		description = data?.description || void 0;
-	}
+	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 releasesData = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/releases`).catch(() => null);
+	const releases = await fetchUnghReleases(owner, repo);
 	let version = "main";
 	let releasedAt;
-	const latestRelease = releasesData?.releases?.[0];
+	const latestRelease = releases[0];
 	if (latestRelease) {
 		version = latestRelease.tag.replace(/^v/, "");
 		releasedAt = latestRelease.publishedAt;
@@ -2103,6 +2270,8 @@ async function resolveGitHubRepo(owner, repo, onProgress) {
 		llmsUrl
 	};
 }
+//#endregion
+//#region src/sources/npm.ts
 /**
 * Search npm registry for packages matching a query.
 * Used as a fallback when direct package lookup fails.
@@ -2545,6 +2714,7 @@ function getInstalledSkillVersion(skillDir) {
 	if (!existsSync(skillPath)) return null;
 	return readFileSync(skillPath, "utf-8").match(/^version:\s*"?([^"\n]+)"?/m)?.[1] || null;
 }
-export { fetchGitHubIssues as $, parseGitSkillInput as A, compareSemver as B, downloadLlmsDocs as C, normalizeLlmsLinks as D, fetchLlmsUrl as E, formatDiscussionAsMarkdown as F, $fetch as G, generateReleaseIndex as H, generateDiscussionIndex as I, isGitHubRepoUrl as J, extractBranchHint as K, fetchCrawledDocs as L, resolveEntryFiles as M, generateDocsIndex as N, parseMarkdownLinks as O, fetchGitHubDiscussions as P, verifyUrl as Q, toCrawlPattern as R, validateGitDocsWithLlms as S, fetchLlmsTxt as T, isPrerelease as U, fetchReleaseNotes as V, parseSemver as W, parseGitHubUrl as X, normalizeRepoUrl as Y, parsePackageSpec as Z, fetchReadme as _, getInstalledSkillVersion as a, isShallowGitDocs as b, readLocalPackageInfo as c, resolvePackageDocs as d, formatIssueAsMarkdown 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, isGhAvailable as nt, parseVersionSpecifier as o, searchNpmPackages as p, fetchText as q, fetchNpmRegistryMeta as r, readLocalDependencies as s, fetchLatestVersion as t, generateIssueIndex as tt, resolveLocalPackageDocs as u, fetchReadmeContent as v, extractSections as w, resolveGitHubRepo as x, filterFrameworkDocs as y, fetchBlogReleases as z };
+//#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 };
 
 //# sourceMappingURL=sources.mjs.map