skilld 0.15.1 → 0.15.3

package/dist/cli.mjs

@@ -776,15 +776,26 @@ function highlightTerms(content, terms) {
 	const pattern = new RegExp(`(${sorted.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")})`, "gi");
 	return content.replace(pattern, "\x1B[33m$1\x1B[0m");
 }
-function formatSnippet(r) {
+function scoreLabel(pct) {
+	return `${pct >= 70 ? "\x1B[32m" : pct >= 40 ? "\x1B[33m" : "\x1B[90m"}${pct}%\x1B[0m`;
+}
+function normalizeScores(results) {
+	const map = /* @__PURE__ */ new Map();
+	const max = results.reduce((m, r) => Math.max(m, r.score), 0);
+	for (const r of results) map.set(r, max > 0 ? Math.round(r.score / max * 100) : 0);
+	return map;
+}
+function formatSnippet(r, versions, pct) {
 	const refPath = `.claude/skills/${r.package}/.skilld/${r.source}`;
 	const lineRange = r.lineStart === r.lineEnd ? `L${r.lineStart}` : `L${r.lineStart}-${r.lineEnd}`;
-	const score = `\x1B[90m${r.score.toFixed(2)}\x1B[0m`;
+	const score = pct != null ? scoreLabel(pct) : `\x1B[90m${r.score.toFixed(2)}\x1B[0m`;
+	const version = versions?.get(r.package);
+	const pkgLabel = version ? `${r.package}@${version}` : r.package;
 	const scopeStr = r.scope?.length ? `${r.scope.map((e) => e.name).join(".")} → ` : "";
 	const entityStr = r.entities?.map((e) => e.signature || `${e.type} ${e.name}`).join(", ");
 	const highlighted = highlightTerms(r.content, r.highlights);
 	return [
-		`${r.package} ${score}${entityStr ? `  \x1B[36m${scopeStr}${entityStr}\x1B[0m` : ""}`,
+		`${pkgLabel} ${score}${entityStr ? `  \x1B[36m${scopeStr}${entityStr}\x1B[0m` : ""}`,
 		`\x1B[90m${refPath}:${lineRange}\x1B[0m`,
 		`  ${highlighted.replace(/\n/g, "\n  ")}`
 	].join("\n");
@@ -3428,35 +3439,56 @@ const removeCommandDef = defineCommand({
 });
 var search_exports = /* @__PURE__ */ __exportAll({
 	findPackageDbs: () => findPackageDbs,
+	getPackageVersions: () => getPackageVersions,
+	listLockPackages: () => listLockPackages,
 	parseFilterPrefix: () => parseFilterPrefix,
 	searchCommand: () => searchCommand,
 	searchCommandDef: () => searchCommandDef
 });
 function findPackageDbs(packageFilter) {
-	const cwd = process.cwd();
+	const lock = readProjectLock(process.cwd());
+	if (!lock) return [];
+	return filterLockDbs(lock, packageFilter);
+}
+function getPackageVersions(cwd = process.cwd()) {
+	const lock = readProjectLock(cwd);
+	const map = /* @__PURE__ */ new Map();
+	if (!lock) return map;
+	for (const s of Object.values(lock.skills)) if (s.packageName && s.version) map.set(s.packageName, s.version);
+	return map;
+}
+function readProjectLock(cwd) {
 	const shared = getSharedSkillsDir(cwd);
 	if (shared) {
 		const lock = readLock(shared);
-		if (lock) return filterLockDbs(lock, packageFilter);
+		if (lock) return lock;
 	}
 	const agent = detectTargetAgent();
-	if (!agent) return [];
-	const lock = readLock(`${cwd}/${targets[agent].skillsDir}`);
+	if (!agent) return null;
+	return readLock(`${cwd}/${targets[agent].skillsDir}`);
+}
+function listLockPackages(cwd = process.cwd()) {
+	const lock = readProjectLock(cwd);
 	if (!lock) return [];
-	return filterLockDbs(lock, packageFilter);
+	const seen = /* @__PURE__ */ new Map();
+	for (const s of Object.values(lock.skills)) if (s.packageName && s.version) seen.set(s.packageName, s.version);
+	return [...seen].map(([name, version]) => `${name}@${version}`);
 }
 function filterLockDbs(lock, packageFilter) {
 	if (!lock) return [];
-	const normalize = (s) => s.toLowerCase().replace(/[-_@/]/g, "");
+	const tokenize = (s) => s.toLowerCase().replace(/@/g, "").split(/[-_/]+/).filter(Boolean);
 	return Object.values(lock.skills).filter((info) => {
 		if (!info.packageName || !info.version) return false;
 		if (!packageFilter) return true;
-		const f = normalize(packageFilter);
-		return normalize(info.packageName).includes(f) || normalize(info.packageName) === f;
+		const filterTokens = tokenize(packageFilter);
+		const nameTokens = tokenize(info.packageName);
+		return filterTokens.every((ft) => nameTokens.some((nt) => nt.includes(ft) || ft.includes(nt)));
 	}).map((info) => {
 		const exact = getPackageDbPath(info.packageName, info.version);
 		if (existsSync(exact)) return exact;
-		return findAnyPackageDb(info.packageName);
+		const fallback = findAnyPackageDb(info.packageName);
+		if (fallback) p.log.warn(`Using cached search index for ${info.packageName} (v${info.version} not indexed). Run \`skilld update ${info.packageName}\` to re-index.`);
+		return fallback;
 	}).filter((db) => !!db);
 }
 function findAnyPackageDb(name) {
@@ -3499,23 +3531,36 @@ function parseFilterPrefix(rawQuery) {
 }
 async function searchCommand(rawQuery, packageFilter) {
 	const dbs = findPackageDbs(packageFilter);
+	const versions = getPackageVersions();
 	if (dbs.length === 0) {
-		if (packageFilter) p.log.warn(`No docs indexed for "${packageFilter}". Run \`skilld add ${packageFilter}\` first.`);
-		else p.log.warn("No docs indexed yet. Run `skilld add <package>` first.");
+		if (packageFilter) {
+			const available = listLockPackages();
+			if (available.length > 0) p.log.warn(`No docs indexed for "${packageFilter}". Available: ${available.join(", ")}`);
+			else p.log.warn(`No docs indexed for "${packageFilter}". Run \`skilld add ${packageFilter}\` first.`);
+		} else p.log.warn("No docs indexed yet. Run `skilld add <package>` first.");
 		return;
 	}
 	const { query, filter } = parseFilterPrefix(rawQuery);
 	const start = performance.now();
-	const merged = (await Promise.all(dbs.map((dbPath) => searchSnippets(query, { dbPath }, {
-		limit: filter ? 10 : 5,
+	const allResults = await Promise.all(dbs.map((dbPath) => searchSnippets(query, { dbPath }, {
+		limit: filter ? 20 : 10,
 		filter
-	})))).flat().sort((a, b) => b.score - a.score).slice(0, 5);
+	})));
+	const seen = /* @__PURE__ */ new Set();
+	const merged = allResults.flat().sort((a, b) => b.score - a.score).filter((r) => {
+		const key = `${r.source}:${r.lineStart}-${r.lineEnd}`;
+		if (seen.has(key)) return false;
+		seen.add(key);
+		return true;
+	}).slice(0, 5);
 	const elapsed = ((performance.now() - start) / 1e3).toFixed(2);
 	if (merged.length === 0) {
 		p.log.warn(`No results for "${query}"`);
 		return;
 	}
-	const output = sanitizeMarkdown(merged.map((r) => formatSnippet(r)).join("\n\n"));
+	for (const r of merged) r.content = sanitizeMarkdown(r.content);
+	const scores = normalizeScores(merged);
+	const output = merged.map((r) => formatSnippet(r, versions, scores.get(r))).join("\n\n");
 	const summary = `${merged.length} results (${elapsed}s)`;
 	if (!!detectCurrentAgent()) {
 		const sanitized = output.replace(/<\/search-results>/gi, "&lt;/search-results&gt;");
@@ -3563,11 +3608,6 @@ function filterToSearchFilter(label) {
 	if (label === "releases") return { type: "release" };
 	return { type: { $in: ["doc", "docs"] } };
 }
-function scoreColor(score) {
-	if (score >= .7) return "\x1B[32m";
-	if (score >= .4) return "\x1B[33m";
-	return "\x1B[90m";
-}
 const SPINNER_FRAMES = [
 	"◐",
 	"◓",
@@ -3576,8 +3616,13 @@ const SPINNER_FRAMES = [
 ];
 async function interactiveSearch(packageFilter) {
 	const dbs = findPackageDbs(packageFilter);
+	const versions = getPackageVersions();
 	if (dbs.length === 0) {
-		const msg = packageFilter ? `No docs indexed for "${packageFilter}". Run \`skilld add ${packageFilter}\` first.` : "No docs indexed yet. Run `skilld add <package>` first.";
+		let msg;
+		if (packageFilter) {
+			const available = listLockPackages();
+			msg = available.length > 0 ? `No docs indexed for "${packageFilter}". Available: ${available.join(", ")}` : `No docs indexed for "${packageFilter}". Run \`skilld add ${packageFilter}\` first.`;
+		} else msg = "No docs indexed yet. Run `skilld add <package>` first.";
 		process.stderr.write(`\x1B[33m${msg}\x1B[0m\n`);
 		return;
 	}
@@ -3628,18 +3673,21 @@ async function interactiveSearch(packageFilter) {
 		} else {
 			lines.push("");
 			const shown = results.slice(0, maxResults);
+			const scores = normalizeScores(results);
 			for (let i = 0; i < shown.length; i++) {
 				const r = shown[i];
 				const selected = i === selectedIndex;
 				const bullet = selected ? "\x1B[36m●\x1B[0m" : "\x1B[90m○\x1B[0m";
-				const sc = scoreColor(r.score);
+				const sc = scoreLabel(scores.get(r) ?? 0);
 				const { title, path, preview } = formatCompactSnippet(r, cols);
 				const highlighted = highlightTerms(preview, r.highlights);
+				const ver = versions.get(r.package);
+				const pkgLabel = ver ? `${r.package}@${ver}` : r.package;
 				if (selected) {
-					lines.push(`  ${bullet} \x1B[1m${r.package}\x1B[0m ${sc}${r.score.toFixed(2)}\x1B[0m  \x1B[36m${title}\x1B[0m`);
+					lines.push(`  ${bullet} \x1B[1m${pkgLabel}\x1B[0m ${sc}  \x1B[36m${title}\x1B[0m`);
 					lines.push(`    \x1B[90m${path}\x1B[0m`);
 					lines.push(`    ${highlighted}`);
-				} else lines.push(`  ${bullet} \x1B[90m${r.package}\x1B[0m ${sc}${r.score.toFixed(2)}\x1B[0m  \x1B[90m${title}\x1B[0m`);
+				} else lines.push(`  ${bullet} \x1B[90m${pkgLabel}\x1B[0m ${sc}  \x1B[90m${title}\x1B[0m`);
 			}
 		}
 		lines.push("");
@@ -3715,9 +3763,10 @@ async function interactiveSearch(packageFilter) {
 			const refPath = `.claude/skills/${r.package}/.skilld/${r.source}`;
 			const lineRange = r.lineStart === r.lineEnd ? `L${r.lineStart}` : `L${r.lineStart}-${r.lineEnd}`;
 			const highlighted = highlightTerms(sanitizeMarkdown(r.content), r.highlights);
+			const rVer = versions.get(r.package);
 			const out = [
 				"",
-				`  \x1B[1m${r.package}\x1B[0m ${scoreColor(r.score)}${r.score.toFixed(2)}\x1B[0m`,
+				`  \x1B[1m${rVer ? `${r.package}@${rVer}` : r.package}\x1B[0m ${scoreLabel(normalizeScores(results).get(r) ?? 0)}`,
 				`  \x1B[90m${refPath}:${lineRange}\x1B[0m`,
 				"",
 				`  ${highlighted.replace(/\n/g, "\n  ")}`,