jd-skills 0.1.2 → 0.1.3

package/dist/cli.mjs

@@ -3156,7 +3156,7 @@ async function tryBlobInstall(ownerRepo, options = {}) {
 		tree
 	};
 }
-var version$1 = "0.1.2";
+var version$1 = "0.1.3";
 const isCancelled$1 = (value) => typeof value === "symbol";
 async function isSourcePrivate(source) {
 	const ownerRepo = parseOwnerRepo(source);
@@ -4558,6 +4558,58 @@ let _lastJdSearchKind = null;
 function getLastJdSearchKind() {
 	return _lastJdSearchKind;
 }
+function skillDescriptionKey(skill) {
+	return `${skill.origin}:${skill.source}:${skill.slug}:${skill.name}`;
+}
+async function fetchUpstreamDescription(skill) {
+	const parts = skill.source.split("/");
+	if (parts.length < 2) return null;
+	const [owner, repo] = parts;
+	const slug = toSkillSlug(skill.name);
+	if (!slug) return null;
+	try {
+		const url = `${SEARCH_API_BASE}/api/download/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/${encodeURIComponent(slug)}`;
+		const res = await fetch(url, { signal: AbortSignal.timeout(5e3) });
+		if (!res.ok) return null;
+		const skillMd = (await res.json()).files?.find((f) => f.path === "SKILL.md" || f.path.endsWith("/SKILL.md"));
+		if (!skillMd?.contents) return null;
+		const { data: fm } = parseFrontmatter(skillMd.contents);
+		const desc = fm.description;
+		return typeof desc === "string" && desc.trim() ? sanitizeMetadata(desc.trim()) : null;
+	} catch {
+		return null;
+	}
+}
+function wrapDescriptionPreview(text, maxLines = 4) {
+	const cols = process.stdout.columns || 80;
+	const width = Math.max(24, cols - 4);
+	const plain = text.replace(/\s+/g, " ").trim();
+	if (!plain) return [];
+	const lines = [];
+	let line = "";
+	let truncated = false;
+	for (const word of plain.split(" ")) {
+		if (!line) {
+			line = word;
+			continue;
+		}
+		if (line.length + 1 + word.length <= width) line += ` ${word}`;
+		else {
+			lines.push(`  ${DIM$3}${line}${RESET$3}`);
+			line = word;
+			if (lines.length >= maxLines) {
+				truncated = true;
+				break;
+			}
+		}
+	}
+	if (!truncated && line && lines.length < maxLines) lines.push(`  ${DIM$3}${line}${RESET$3}`);
+	else if (truncated && lines.length > 0) {
+		const last = lines[lines.length - 1];
+		lines[lines.length - 1] = last.replace(new RegExp(`${RESET$3}$`), `…${RESET$3}`);
+	}
+	return lines;
+}
 async function searchUpstreamSkills(query) {
 	try {
 		const url = `${SEARCH_API_BASE}/api/search?q=${encodeURIComponent(query)}&limit=10`;
@@ -4626,6 +4678,42 @@ async function runSearchPrompt(initialQuery = "") {
 	let debounceTimer = null;
 	let lastRenderedLines = 0;
 	let jdNeedsLogin = false;
+	let scrollOffset = 0;
+	const maxVisibleResults = 8;
+	const descriptionCache = /* @__PURE__ */ new Map();
+	let descriptionFetchToken = 0;
+	let descriptionLoading = false;
+	function getSelectedDescription() {
+		const skill = results[selectedIndex];
+		if (!skill) return void 0;
+		if (skill.description?.trim()) return skill.description.trim();
+		if (skill.jdDetail?.description?.trim()) return skill.jdDetail.description.trim();
+		return descriptionCache.get(skillDescriptionKey(skill));
+	}
+	async function prefetchSelectedDescription() {
+		const skill = results[selectedIndex];
+		if (!skill || getSelectedDescription()) return;
+		const key = skillDescriptionKey(skill);
+		if (descriptionCache.has(key)) return;
+		const token = ++descriptionFetchToken;
+		descriptionLoading = true;
+		render();
+		const desc = skill.origin === "upstream" ? await fetchUpstreamDescription(skill) : skill.jdDetail?.description;
+		if (token !== descriptionFetchToken) return;
+		descriptionLoading = false;
+		if (desc?.trim()) {
+			descriptionCache.set(key, desc.trim());
+			render();
+		} else render();
+	}
+	function syncScrollOffset() {
+		if (results.length <= maxVisibleResults) {
+			scrollOffset = 0;
+			return;
+		}
+		if (selectedIndex < scrollOffset) scrollOffset = selectedIndex;
+		else if (selectedIndex >= scrollOffset + maxVisibleResults) scrollOffset = selectedIndex - maxVisibleResults + 1;
+	}
 	if (process.stdin.isTTY) process.stdin.setRawMode(true);
 	readline.emitKeypressEvents(process.stdin);
 	process.stdin.resume();
@@ -4641,10 +4729,11 @@ async function runSearchPrompt(initialQuery = "") {
 		else if (results.length === 0 && loading) lines.push(`${DIM$3}Searching...${RESET$3}`);
 		else if (results.length === 0) lines.push(`${DIM$3}No skills found${RESET$3}`);
 		else {
-			const visible = results.slice(0, 8);
+			syncScrollOffset();
+			const visible = results.slice(scrollOffset, scrollOffset + maxVisibleResults);
 			for (let i = 0; i < visible.length; i++) {
 				const skill = visible[i];
-				const isSelected = i === selectedIndex;
+				const isSelected = scrollOffset + i === selectedIndex;
 				const arrow = isSelected ? `${BOLD$3}>${RESET$3}` : " ";
 				const name = isSelected ? `${BOLD$3}${skill.name}${RESET$3}` : `${TEXT$2}${skill.name}${RESET$3}`;
 				const originBadge = skill.origin === "jd" ? ` ${YELLOW$1}[jd]${RESET$3}` : "";
@@ -4654,6 +4743,10 @@ async function runSearchPrompt(initialQuery = "") {
 				const loadingIndicator = loading && i === 0 ? ` ${DIM$3}...${RESET$3}` : "";
 				lines.push(`  ${arrow} ${originBadge}${name}${source}${installsBadge}${loadingIndicator}`);
 			}
+			lines.push("");
+			const preview = getSelectedDescription();
+			if (preview) lines.push(...wrapDescriptionPreview(preview));
+			else if (descriptionLoading) lines.push(`  ${DIM$3}Loading description…${RESET$3}`);
 		}
 		if (jdNeedsLogin) {
 			lines.push("");
@@ -4664,6 +4757,7 @@ async function runSearchPrompt(initialQuery = "") {
 		lines.push(footerHint);
 		for (const line of lines) process.stdout.write(line + "\n");
 		lastRenderedLines = lines.length;
+		if (results.length > 0 && !getSelectedDescription() && !descriptionLoading) prefetchSelectedDescription();
 	}
 	function triggerSearch(q) {
 		if (debounceTimer) {
@@ -4674,6 +4768,7 @@ async function runSearchPrompt(initialQuery = "") {
 		if (!isSearchableQuery(q)) {
 			results = [];
 			selectedIndex = 0;
+			scrollOffset = 0;
 			jdNeedsLogin = false;
 			render();
 			return;
@@ -4685,6 +4780,7 @@ async function runSearchPrompt(initialQuery = "") {
 			try {
 				results = await searchSkillsAPI(q);
 				selectedIndex = 0;
+				scrollOffset = 0;
 				if (isJdIntranetAvailable()) jdNeedsLogin = await getJdSourcePromptState() === "auth_required" || getLastJdSearchKind() === "auth_required";
 				else jdNeedsLogin = false;
 			} catch {
@@ -4719,11 +4815,15 @@ async function runSearchPrompt(initialQuery = "") {
 			}
 			if (key.name === "up") {
 				selectedIndex = Math.max(0, selectedIndex - 1);
+				descriptionFetchToken++;
+				descriptionLoading = false;
 				render();
 				return;
 			}
 			if (key.name === "down") {
 				selectedIndex = Math.min(Math.max(0, results.length - 1), selectedIndex + 1);
+				descriptionFetchToken++;
+				descriptionLoading = false;
 				render();
 				return;
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jd-skills",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "CLI for the agent skills ecosystem (JD fork of vercel-labs/skills)",
   "type": "module",
   "bin": {