happyskills 0.41.0 → 0.42.0

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.42.0] - 2026-05-05
+
+### Added
+- Surface the new server-side cluster info from API v2.6.0 in `search` output. Human output gains a `+N similar` chip in the result meta line (alongside match quality, stars, and quality tier) when the row represents a duplicate cluster. JSON output gains two additive fields per result: `similar_count` (integer) and `similar_repos` (array of cluster members, each with a per-member `similarity` score). Internal refactor: extracted `to_smart_json()` so cluster members serialise with the same shape as top-level results.
+
 ## [0.41.0] - 2026-05-04
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happyskills",
-	"version": "0.41.0",
+	"version": "0.42.0",
 	"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

@@ -79,7 +79,8 @@ const format_smart_result = (item, index) => {
 	const star_str = `★ ${stars}`
 	const quality_str = tier ? tier.color(tier.label) : ''
 	const match_str = match ? match.color(match.label) : ''
-	const meta_parts = [match_str, star_str, quality_str].filter(Boolean).join(' · ')
+	const similar_str = item.similar_count ? `+${item.similar_count} similar` : ''
+	const meta_parts = [match_str, star_str, quality_str, similar_str].filter(Boolean).join(' · ')
 
 	const num = `  ${String(index + 1).padStart(2)}. `
 	const name_and_meta = `${bold(name)}${meta_parts ? `  ${dim(meta_parts)}` : ''}`
@@ -94,6 +95,24 @@ const format_smart_result = (item, index) => {
 	return lines.join('\n')
 }
 
+const to_smart_json = (item) => ({
+	skill: `${item.workspace_slug}/${item.name}`,
+	type: item.type || 'skill',
+	description: item.description || '',
+	version: item.latest_version || item.version || '-',
+	visibility: item.visibility || 'public',
+	workspace_slug: item.workspace_slug,
+	stars: item.star_count || 0,
+	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,
+})
+
 const run_smart_search = (args, query, options) => catch_errors('Smart search failed', async () => {
 	const limit = parseInt(args.flags.limit)
 	const capped_limit = Math.min(Math.max(limit, 1), 50)
@@ -132,21 +151,12 @@ const run_smart_search = (args, query, options) => catch_errors('Smart search fa
 
 	if (args.flags.json) {
 		const mapped = items.map(item => ({
-			skill: `${item.workspace_slug}/${item.name}`,
-			type: item.type || 'skill',
-			description: item.description || '',
-			version: item.latest_version || item.version || '-',
-			visibility: item.visibility || 'public',
-			workspace_slug: item.workspace_slug,
-			stars: item.star_count || 0,
-			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,
+			...to_smart_json(item),
+			similar_count: item.similar_count || 0,
+			similar_repos: (item.similar_repos || []).map(member => ({
+				...to_smart_json(member),
+				similarity: member.similarity != null ? member.similarity : null,
+			})),
 		}))
 		const data = { query, mode: 'smart', results: mapped, count: mapped.length }
 		if (match_notice) data.match_notice = match_notice