skilld 0.9.5 → 0.10.0

package/dist/_chunks/npm.mjs

@@ -1,9 +1,10 @@
 import { i as getCacheDir } from "./config.mjs";
-import { c as getBlogPreset, l as getDocOverride, n as yamlParseKV, o as mapInsert } from "./yaml.mjs";
+import { a as getDocOverride, i as getBlogPreset, n as yamlParseKV } from "./yaml.mjs";
 import { basename, dirname, join, resolve } from "pathe";
 import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, unlinkSync } from "node:fs";
 import { htmlToMarkdown } from "mdream";
 import { spawnSync } from "node:child_process";
+import { gt } from "semver";
 import { ofetch } from "ofetch";
 import { globby } from "globby";
 import pLimit from "p-limit";
@@ -24,6 +25,22 @@ function buildFrontmatter(fields) {
 	lines.push("---");
 	return lines.join("\n");
 }
+function mapInsert(map, key, create) {
+	let val = map.get(key);
+	if (val === void 0) {
+		val = create();
+		map.set(key, val);
+	}
+	return val;
+}
+function semverGt(a, b) {
+	return gt(a, b, true);
+}
+const SHARED_SKILLS_DIR = ".skills";
+function getSharedSkillsDir(cwd = process.cwd()) {
+	const dir = join(cwd, SHARED_SKILLS_DIR);
+	return existsSync(dir) ? dir : null;
+}
 let _ghAvailable;
 function isGhAvailable() {
 	if (_ghAvailable !== void 0) return _ghAvailable;
@@ -401,6 +418,25 @@ function parseGitHubUrl(url) {
 function normalizeRepoUrl(url) {
 	return url.replace(/^git\+/, "").replace(/#.*$/, "").replace(/\.git$/, "").replace(/^git:\/\//, "https://").replace(/^ssh:\/\/git@github\.com/, "https://github.com").replace(/^git@github\.com:/, "https://github.com/");
 }
+function parsePackageSpec(spec) {
+	if (spec.startsWith("@")) {
+		const slashIdx = spec.indexOf("/");
+		if (slashIdx !== -1) {
+			const atIdx = spec.indexOf("@", slashIdx + 1);
+			if (atIdx !== -1) return {
+				name: spec.slice(0, atIdx),
+				tag: spec.slice(atIdx + 1)
+			};
+		}
+		return { name: spec };
+	}
+	const atIdx = spec.indexOf("@");
+	if (atIdx !== -1) return {
+		name: spec.slice(0, atIdx),
+		tag: spec.slice(atIdx + 1)
+	};
+	return { name: spec };
+}
 function extractBranchHint(url) {
 	const hash = url.indexOf("#");
 	if (hash === -1) return void 0;
@@ -557,21 +593,26 @@ function generateReleaseIndex(releasesOrOpts, packageName) {
 	}
 	return lines.join("\n");
 }
+function isStubRelease(release) {
+	const body = (release.markdown || "").trim();
+	return body.length < 500 && /changelog\.md/i.test(body);
+}
 function isChangelogRedirectPattern(releases) {
 	const sample = releases.slice(0, 3);
 	if (sample.length === 0) return false;
-	return sample.every((r) => {
-		const body = (r.markdown || "").trim();
-		return body.length < 500 && /changelog\.md/i.test(body);
-	});
+	return sample.every(isStubRelease);
 }
-async function fetchChangelog(owner, repo, ref) {
-	for (const filename of [
-		"CHANGELOG.md",
-		"changelog.md",
-		"CHANGES.md"
-	]) {
-		const content = await $fetch(`https://raw.githubusercontent.com/${owner}/${repo}/${ref}/${filename}`, {
+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`);
+	}
+	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);
@@ -583,26 +624,26 @@ async function fetchReleaseNotes(owner, repo, installedVersion, gitRef, packageN
 	const selected = selectReleases(await fetchAllReleases(owner, repo), packageName, installedVersion, fromDate);
 	if (selected.length > 0) {
 		if (isChangelogRedirectPattern(selected)) {
-			const changelog = await fetchChangelog(owner, repo, gitRef || selected[0].tag);
+			const changelog = await fetchChangelog(owner, repo, gitRef || selected[0].tag, packageName);
 			if (changelog) return [{
 				path: "releases/CHANGELOG.md",
 				content: changelog
 			}];
 		}
-		const docs = selected.map((r) => {
+		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, gitRef || selected[0].tag);
+		const changelog = await fetchChangelog(owner, repo, 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, gitRef || "main");
+	const changelog = await fetchChangelog(owner, repo, gitRef || "main", packageName);
 	if (!changelog) return [];
 	return [{
 		path: "releases/CHANGELOG.md",
@@ -1152,6 +1193,89 @@ async function fetchGitLabSkills(source, onProgress) {
 async function fetchRawGitLab(owner, repo, ref, path) {
 	return $fetch(`https://gitlab.com/${owner}/${repo}/-/raw/${ref}/${path}`, { responseType: "text" }).catch(() => null);
 }
+async function fetchLlmsUrl(docsUrl) {
+	const llmsUrl = `${new URL(docsUrl).origin}/llms.txt`;
+	if (await verifyUrl(llmsUrl)) return llmsUrl;
+	return null;
+}
+async function fetchLlmsTxt(url) {
+	const content = await fetchText(url);
+	if (!content || content.length < 50) return null;
+	return {
+		raw: content,
+		links: parseMarkdownLinks(content)
+	};
+}
+function parseMarkdownLinks(content) {
+	const links = [];
+	const seen = /* @__PURE__ */ new Set();
+	const linkRegex = /\[([^\]]+)\]\(([^)]+\.md)\)/g;
+	for (let match = linkRegex.exec(content); match !== null; match = linkRegex.exec(content)) {
+		const url = match[2];
+		if (!seen.has(url)) {
+			seen.add(url);
+			links.push({
+				title: match[1],
+				url
+			});
+		}
+	}
+	return links;
+}
+function isSafeUrl(url) {
+	try {
+		const parsed = new URL(url);
+		if (parsed.protocol !== "https:") return false;
+		const host = parsed.hostname;
+		if (host === "localhost" || host === "127.0.0.1" || host === "::1") return false;
+		if (host === "169.254.169.254") return false;
+		if (/^(?:10\.|172\.(?:1[6-9]|2\d|3[01])\.|192\.168\.)/.test(host)) return false;
+		if (host.startsWith("[")) return false;
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function downloadLlmsDocs(llmsContent, baseUrl, onProgress) {
+	const limit = pLimit(5);
+	let completed = 0;
+	return (await Promise.all(llmsContent.links.map((link) => limit(async () => {
+		const url = link.url.startsWith("http") ? link.url : `${baseUrl.replace(/\/$/, "")}${link.url.startsWith("/") ? "" : "/"}${link.url}`;
+		if (!isSafeUrl(url)) return null;
+		onProgress?.(link.url, completed++, llmsContent.links.length);
+		const content = await fetchText(url);
+		if (content && content.length > 100) return {
+			url: link.url,
+			title: link.title,
+			content
+		};
+		return null;
+	})))).filter((d) => d !== null);
+}
+function normalizeLlmsLinks(content, baseUrl) {
+	let normalized = content;
+	if (baseUrl) {
+		const escaped = baseUrl.replace(/\/$/, "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		normalized = normalized.replace(new RegExp(`\\]\\(${escaped}(/[^)]+\\.md)\\)`, "g"), "](./docs$1)");
+	}
+	normalized = normalized.replace(/\]\(\/([^)]+\.md)\)/g, "](./docs/$1)");
+	return normalized;
+}
+function extractSections(content, patterns) {
+	const sections = [];
+	const parts = content.split(/\n---\n/);
+	for (const part of parts) {
+		const urlMatch = part.match(/^url: *(\S.*)$/m);
+		if (!urlMatch) continue;
+		const url = urlMatch[1];
+		if (patterns.some((p) => url.includes(p))) {
+			const contentStart = part.indexOf("\n", part.indexOf("url:"));
+			if (contentStart > -1) sections.push(part.slice(contentStart + 1));
+		}
+	}
+	if (sections.length === 0) return null;
+	return sections.join("\n\n---\n\n");
+}
 const MIN_GIT_DOCS = 5;
 const isShallowGitDocs = (n) => n > 0 && n < MIN_GIT_DOCS;
 async function listFilesAtRef(owner, repo, ref) {
@@ -1299,7 +1423,8 @@ async function fetchGitDocs(owner, repo, version, packageName, repoUrl) {
 			baseUrl: `https://raw.githubusercontent.com/${override.owner}/${override.repo}/${ref}`,
 			ref,
 			files,
-			fallback
+			fallback,
+			docsPrefix: `${override.path}/` !== "docs/" ? `${override.path}/` : void 0
 		};
 	}
 	const tag = await findGitTag(owner, repo, version, packageName, repoUrl ? extractBranchHint(repoUrl) : void 0);
@@ -1475,89 +1600,67 @@ async function fetchReadmeContent(url) {
 	}
 	return fetchText(url);
 }
-async function fetchLlmsUrl(docsUrl) {
-	const llmsUrl = `${new URL(docsUrl).origin}/llms.txt`;
-	if (await verifyUrl(llmsUrl)) return llmsUrl;
-	return null;
-}
-async function fetchLlmsTxt(url) {
-	const content = await fetchText(url);
-	if (!content || content.length < 50) return null;
+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;
+	}
+	onProgress?.("Fetching latest release");
+	const releasesData = await $fetch(`https://ungh.cc/repos/${owner}/${repo}/releases`).catch(() => null);
+	let version = "main";
+	let releasedAt;
+	const latestRelease = releasesData?.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 {
-		raw: content,
-		links: parseMarkdownLinks(content)
+		name: repo,
+		version: latestRelease ? version : void 0,
+		releasedAt,
+		description,
+		repoUrl,
+		docsUrl: homepage,
+		gitDocsUrl,
+		gitRef,
+		gitDocsFallback: gitDocs?.fallback,
+		readmeUrl: readmeUrl ?? void 0,
+		llmsUrl
 	};
 }
-function parseMarkdownLinks(content) {
-	const links = [];
-	const seen = /* @__PURE__ */ new Set();
-	const linkRegex = /\[([^\]]+)\]\(([^)]+\.md)\)/g;
-	for (let match = linkRegex.exec(content); match !== null; match = linkRegex.exec(content)) {
-		const url = match[2];
-		if (!seen.has(url)) {
-			seen.add(url);
-			links.push({
-				title: match[1],
-				url
-			});
-		}
-	}
-	return links;
-}
-function isSafeUrl(url) {
-	try {
-		const parsed = new URL(url);
-		if (parsed.protocol !== "https:") return false;
-		const host = parsed.hostname;
-		if (host === "localhost" || host === "127.0.0.1" || host === "::1") return false;
-		if (host === "169.254.169.254") return false;
-		if (/^(?:10\.|172\.(?:1[6-9]|2\d|3[01])\.|192\.168\.)/.test(host)) return false;
-		if (host.startsWith("[")) return false;
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function downloadLlmsDocs(llmsContent, baseUrl, onProgress) {
-	const limit = pLimit(5);
-	let completed = 0;
-	return (await Promise.all(llmsContent.links.map((link) => limit(async () => {
-		const url = link.url.startsWith("http") ? link.url : `${baseUrl.replace(/\/$/, "")}${link.url.startsWith("/") ? "" : "/"}${link.url}`;
-		if (!isSafeUrl(url)) return null;
-		onProgress?.(link.url, completed++, llmsContent.links.length);
-		const content = await fetchText(url);
-		if (content && content.length > 100) return {
-			url: link.url,
-			title: link.title,
-			content
-		};
-		return null;
-	})))).filter((d) => d !== null);
-}
-function normalizeLlmsLinks(content, baseUrl) {
-	let normalized = content;
-	if (baseUrl) {
-		const escaped = baseUrl.replace(/\/$/, "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-		normalized = normalized.replace(new RegExp(`\\]\\(${escaped}(/[^)]+\\.md)\\)`, "g"), "](./docs$1)");
-	}
-	normalized = normalized.replace(/\]\(\/([^)]+\.md)\)/g, "](./docs/$1)");
-	return normalized;
-}
-function extractSections(content, patterns) {
-	const sections = [];
-	const parts = content.split(/\n---\n/);
-	for (const part of parts) {
-		const urlMatch = part.match(/^url: *(\S.*)$/m);
-		if (!urlMatch) continue;
-		const url = urlMatch[1];
-		if (patterns.some((p) => url.includes(p))) {
-			const contentStart = part.indexOf("\n", part.indexOf("url:"));
-			if (contentStart > -1) sections.push(part.slice(contentStart + 1));
-		}
-	}
-	if (sections.length === 0) return null;
-	return sections.join("\n\n---\n\n");
-}
 async function 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 [];
@@ -1948,6 +2051,6 @@ function getInstalledSkillVersion(skillDir) {
 	if (!existsSync(skillPath)) return null;
 	return readFileSync(skillPath, "utf-8").match(/^version:\s*"?([^"\n]+)"?/m)?.[1] || null;
 }
-export { resolveEntryFiles as A, $fetch as B, fetchReadme as C, fetchGitSkills as D, validateGitDocsWithLlms as E, compareSemver as F, parseGitHubUrl as G, fetchText as H, fetchReleaseNotes as I, formatIssueAsMarkdown as J, verifyUrl as K, generateReleaseIndex as L, formatDiscussionAsMarkdown as M, generateDiscussionIndex as N, parseGitSkillInput as O, fetchBlogReleases as P, isPrerelease as R, fetchGitHubRepoMeta as S, isShallowGitDocs as T, isGitHubRepoUrl as U, extractBranchHint as V, normalizeRepoUrl as W, isGhAvailable as X, generateIssueIndex as Y, fetchLlmsUrl as _, getInstalledSkillVersion as a, MIN_GIT_DOCS as b, readLocalPackageInfo as c, resolvePackageDocs as d, resolvePackageDocsWithAttempts as f, fetchLlmsTxt as g, extractSections as h, fetchPkgDist as i, fetchGitHubDiscussions as j, parseSkillFrontmatterName as k, resolveInstalledVersion as l, downloadLlmsDocs as m, fetchNpmPackage as n, parseVersionSpecifier as o, searchNpmPackages as p, fetchGitHubIssues as q, fetchNpmRegistryMeta as r, readLocalDependencies as s, fetchLatestVersion as t, resolveLocalPackageDocs as u, normalizeLlmsLinks as v, fetchReadmeContent as w, fetchGitDocs as x, parseMarkdownLinks as y, parseSemver as z };
+export { SHARED_SKILLS_DIR as $, parseSkillFrontmatterName as A, parseSemver as B, extractSections as C, parseMarkdownLinks as D, normalizeLlmsLinks as E, fetchBlogReleases as F, normalizeRepoUrl as G, extractBranchHint as H, compareSemver as I, verifyUrl as J, parseGitHubUrl as K, fetchReleaseNotes as L, fetchGitHubDiscussions as M, formatDiscussionAsMarkdown as N, fetchGitSkills as O, generateDiscussionIndex as P, isGhAvailable as Q, generateReleaseIndex as R, downloadLlmsDocs as S, fetchLlmsUrl as T, fetchText as U, $fetch as V, isGitHubRepoUrl as W, formatIssueAsMarkdown as X, fetchGitHubIssues as Y, generateIssueIndex as Z, fetchReadme as _, getInstalledSkillVersion as a, resolveGitHubRepo as b, readLocalPackageInfo as c, resolvePackageDocs as d, getSharedSkillsDir as et, resolvePackageDocsWithAttempts as f, fetchGitHubRepoMeta as g, fetchGitDocs as h, fetchPkgDist as i, resolveEntryFiles as j, parseGitSkillInput as k, resolveInstalledVersion as l, MIN_GIT_DOCS as m, fetchNpmPackage as n, semverGt as nt, parseVersionSpecifier as o, searchNpmPackages as p, parsePackageSpec as q, fetchNpmRegistryMeta as r, readLocalDependencies as s, fetchLatestVersion as t, mapInsert as tt, resolveLocalPackageDocs as u, fetchReadmeContent as v, fetchLlmsTxt as w, validateGitDocsWithLlms as x, isShallowGitDocs as y, isPrerelease as z };
 
 //# sourceMappingURL=npm.mjs.map