happyskills 0.33.1 → 0.34.0

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.34.0] - 2026-04-09
+
+### Changed
+- Make smart search (semantic + quality ranking) the default when a query is provided — `search "query"` now uses hybrid vector + full-text matching instead of keyword-only
+
+### Added
+- Add `--exact` flag to `search` command to opt out of smart search and use keyword-only matching
+- Add `hint` field to `--exact --json` responses nudging users toward smart search for better results
+
 ## [0.33.1] - 2026-04-08
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happyskills",
-	"version": "0.33.1",
+	"version": "0.34.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

@@ -10,6 +10,9 @@ const HELP_TEXT = `Usage: happyskills search [query] [options]
 
 Search the skill registry.
 
+When a query is provided, smart search (semantic + quality ranking) is used by
+default. Use --exact to fall back to keyword-only matching.
+
 Arguments:
   query               Search term (optional with --mine, --personal, or --workspace)
 
@@ -19,21 +22,22 @@ Options:
   --personal              Search only your personal workspace
   --tags <tags>           Filter by tags (comma-separated)
   --type <type>           Filter by type (skill, kit)
-  --smart, -S             Use semantic search (vector + text + quality ranking)
-  --limit <n>             Max results (default: 10, max: 50) — used with --smart
-  --min-quality <n>       Minimum quality score 0-100 — used with --smart
+  --exact                 Use keyword-only matching instead of smart search
+  --limit <n>             Max results (default: 10, max: 50)
+  --min-quality <n>       Minimum quality score 0-100
   --json                  Output as JSON
 
 Aliases: s
 
 Examples:
   happyskills search deploy
+  happyskills search "REST API with Node.js"
   happyskills search --mine
-  happyskills search "REST API with Node.js" --smart
   happyskills search deploy --workspace acme
   happyskills search --type kit
   happyskills s --personal --json
-  happyskills search "deploy to AWS" -S --limit 5`
+  happyskills search "deploy to AWS" --limit 5
+  happyskills search deploy --exact`
 
 const QUALITY_TIERS = [
 	{ min: 80, label: 'High quality', color: cyan },
@@ -140,7 +144,7 @@ const run_smart_search = (args, query, options) => catch_errors('Smart search fa
 	console.log(`\n${gray(`Showing ${items.length} result${items.length === 1 ? '' : 's'}. Install with: happyskills install <owner>/<name>`)}\n`)
 })
 
-const run_keyword_search = (args, query, options) => catch_errors('Keyword search failed', async () => {
+const run_keyword_search = (args, query, options, { is_exact } = {}) => catch_errors('Keyword search failed', async () => {
 	const [errors, results] = await repos_api.search(query, options)
 	if (errors) throw e('Search failed', errors)
 
@@ -149,7 +153,9 @@ const run_keyword_search = (args, query, options) => catch_errors('Keyword searc
 
 	if (items.length === 0) {
 		if (args.flags.json) {
-			print_json({ data: { query, scope: effective_scope, results: [], count: 0 } })
+			const data = { query, scope: effective_scope, results: [], count: 0 }
+			if (is_exact) data.hint = 'Smart search (default) uses semantic matching for better results. Remove --exact to use it.'
+			print_json({ data })
 			return
 		}
 		const context = query ? ` for "${query}"` : ''
@@ -165,7 +171,9 @@ const run_keyword_search = (args, query, options) => catch_errors('Keyword searc
 			version: item.latest_version || item.version || '-',
 			visibility: item.visibility || 'public'
 		}))
-		print_json({ data: { query, scope: effective_scope, results: mapped, count: mapped.length } })
+		const data = { query, scope: effective_scope, results: mapped, count: mapped.length }
+		if (is_exact) data.hint = 'Smart search (default) uses semantic matching for better results. Remove --exact to use it.'
+		print_json({ data })
 		return
 	}
 
@@ -191,13 +199,11 @@ const run = (args) => catch_errors('Search failed', async () => {
 
 	const query = args._.join(' ') || null
 	const { mine, personal, workspace, tags, type } = args.flags
-	const is_smart = !!(args.flags.smart || args.flags.S)
+	const is_exact = !!args.flags.exact
+	// --smart / -S accepted for backward compat (now the default when a query is provided)
+	const use_smart = query && !is_exact
 	const has_scope_flag = mine || personal || workspace
 
-	if (is_smart && !query) {
-		throw new UsageError('--smart requires a search query.')
-	}
-
 	if (!query && !has_scope_flag && !tags && !type) {
 		throw new UsageError('Please provide a search query or use --mine, --personal, or --workspace.')
 	}
@@ -221,7 +227,7 @@ const run = (args) => catch_errors('Search failed', async () => {
 	if (tags) options.tags = tags
 	if (type) options.type = type
 
-	if (is_smart) {
+	if (use_smart) {
 		const [errors] = await run_smart_search(args, query, options)
 		if (errors) throw e('Smart search failed', errors)
 	} else {
@@ -231,7 +237,7 @@ const run = (args) => catch_errors('Search failed', async () => {
 			kw_options.workspace = options.workspace_slug
 			delete kw_options.workspace_slug
 		}
-		const [errors] = await run_keyword_search(args, query, kw_options)
+		const [errors] = await run_keyword_search(args, query, kw_options, { is_exact })
 		if (errors) throw e('Search failed', errors)
 	}
 }).then(([errors]) => { if (errors) { exit_with_error(errors); return } })