happyskills 0.35.1 → 0.35.2

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.35.2] - 2026-04-11
+
+### Added
+- Add match quality labels to smart search output — each result shows its confidence level (Strong match, Good match, Partial match, Weak match) based on cosine similarity
+- Add weak-match notice when no results have strong or good match quality, warning that results may not match the user's intent
+- Add `match_quality` and `match_notice` fields to JSON search output
+
 ## [0.35.1] - 2026-04-10
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happyskills",
-	"version": "0.35.1",
+	"version": "0.35.2",
 	"description": "Package manager for AI agent skills",
 	"license": "SEE LICENSE IN LICENSE",
 	"author": "Nicolas Dao <nic@cloudlesslabs.com> (https://cloudlesslabs.com)",

package/src/commands/search.js

@@ -46,6 +46,13 @@ const QUALITY_TIERS = [
 	{ min: 20, label: 'Low quality', color: yellow },
 ]
 
+const MATCH_QUALITY_LABELS = {
+	strong: { label: 'Strong match', color: cyan },
+	good: { label: 'Good match', color: cyan },
+	partial: { label: 'Partial match', color: yellow },
+	weak: { label: 'Weak match', color: yellow },
+}
+
 const get_quality_label = (score) => {
 	if (score == null) return null
 	for (const tier of QUALITY_TIERS) {
@@ -67,10 +74,12 @@ const format_smart_result = (item, index) => {
 	const name = `${item.workspace_slug}/${item.name}`
 	const stars = item.star_count || 0
 	const tier = get_quality_label(item.quality_score)
+	const match = item.match_quality ? MATCH_QUALITY_LABELS[item.match_quality] : null
 
 	const star_str = `★ ${stars}`
 	const quality_str = tier ? tier.color(tier.label) : ''
-	const meta_parts = [star_str, quality_str].filter(Boolean).join(' · ')
+	const match_str = match ? match.color(match.label) : ''
+	const meta_parts = [match_str, star_str, quality_str].filter(Boolean).join(' · ')
 
 	const num = `  ${String(index + 1).padStart(2)}. `
 	const name_and_meta = `${bold(name)}${meta_parts ? `  ${dim(meta_parts)}` : ''}`
@@ -114,6 +123,13 @@ const run_smart_search = (args, query, options) => catch_errors('Smart search fa
 		return
 	}
 
+	const has_strong_or_good = items.some(item =>
+		item.match_quality === 'strong' || item.match_quality === 'good'
+	)
+	const match_notice = !has_strong_or_good && items.length > 0
+		? 'No strong matches found. The results below are the closest available but may not match your intent.'
+		: null
+
 	if (args.flags.json) {
 		const mapped = items.map(item => ({
 			skill: `${item.workspace_slug}/${item.name}`,
@@ -126,17 +142,23 @@ const run_smart_search = (args, query, options) => catch_errors('Smart search fa
 			quality_score: item.quality_score != null ? item.quality_score : null,
 			quality_tier: get_quality_tier_name(item.quality_score),
 			relevance_score: item.relevance_score != null ? item.relevance_score : null,
+			match_quality: item.match_quality || null,
 			tags: item.tags || [],
 			download_count: item.download_count || 0,
 			created_at: item.created_at,
 			updated_at: item.updated_at,
 		}))
-		print_json({ data: { query, mode: 'smart', results: mapped, count: mapped.length } })
+		const data = { query, mode: 'smart', results: mapped, count: mapped.length }
+		if (match_notice) data.match_notice = match_notice
+		print_json({ data })
 		return
 	}
 
 	// Human-readable smart output
 	console.log(`\n${bold(`Skills for: "${query}"`)}\n`)
+	if (match_notice) {
+		console.log(`  ${yellow(match_notice)}\n`)
+	}
 	items.forEach((item, i) => {
 		console.log(format_smart_result(item, i))
 		if (i < items.length - 1) console.log('')