happyskills 0.4.4 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-03-06
+
+### Added
+- Add `--public` flag to `publish` command to explicitly publish a skill as publicly discoverable in the catalog
+
+### Changed
+- Change `publish` default visibility from public to private — skills are now private by default; pass `--public` to make a skill visible in the catalog
+- Change `convert` to no longer auto-publish to the registry after converting; the skill is registered locally and the user is prompted to run `happyskills publish <skill-name>` as a separate step
+
+### Fixed
+- Fix `--version` flag collision where commands accepting `--version <value>` (e.g., `convert --version 1.0.0`) would incorrectly trigger the root `--version` output instead of passing the value to the command
+
+## [0.5.0] - 2026-03-05
+
+### Added
+- Add `--mine` flag to `search` command to browse skills across all user's workspaces
+- Add `--personal` flag to `search` command to browse skills in the user's personal workspace only
+- Add `-w` / `--workspace <slug>` flag to `search` command to search within specific workspace(s)
+- Add `--tags <tags>` flag to `search` command to filter results by tags
+- Add `scope` and `visibility` fields to `search` JSON output
+
+### Changed
+- Change `search` query argument from required to optional when `--mine`, `--personal`, or `--workspace` is provided (browse mode)
+
 ## [0.4.4] - 2026-03-05
 
 ### Fixed

package/package.json

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

package/src/api/push.js

@@ -12,13 +12,13 @@ const estimate_payload_size = (files) => {
 	return size
 }
 
-const smart_push = (owner, repo, { version, message, files }, on_progress) =>
+const smart_push = (owner, repo, { version, message, files, visibility }, on_progress) =>
 	catch_errors('Smart push failed', async () => {
 		const payload_size = estimate_payload_size(files)
 
 		if (payload_size < DIRECT_PUSH_THRESHOLD) {
 			// Small payload — use direct push
-			const [err, data] = await repos_api.push(owner, repo, { version, message, files })
+			const [err, data] = await repos_api.push(owner, repo, { version, message, files, visibility })
 			if (err) throw e('Direct push failed', err)
 			return data
 		}
@@ -28,7 +28,7 @@ const smart_push = (owner, repo, { version, message, files }, on_progress) =>
 
 		// Step 1: Initiate
 		const [init_err, init_data] = await initiate_upload(owner, repo, {
-			version, message, files: file_meta
+			version, message, files: file_meta, visibility
 		})
 		if (init_err) throw e('Upload initiation failed', init_err)
 

package/src/api/repos.js

@@ -2,10 +2,15 @@ const { error: { catch_errors } } = require('puffy-core')
 const client = require('./client')
 
 const search = (query, options = {}) => catch_errors('Search failed', async () => {
-	const params = new URLSearchParams({ q: query })
+	const params = new URLSearchParams()
+	if (query) params.set('q', query)
 	if (options.limit) params.set('limit', options.limit)
 	if (options.offset) params.set('offset', options.offset)
-	const [errors, data] = await client.get(`/repos/search?${params}`, { auth: false })
+	if (options.scope) params.set('scope', options.scope)
+	if (options.workspace) params.set('workspace', options.workspace)
+	if (options.tags) params.set('tags', options.tags)
+	const needs_auth = (options.scope && options.scope !== 'public') || options.workspace
+	const [errors, data] = await client.get(`/repos/search?${params}`, { auth: needs_auth || false })
 	if (errors) throw errors[errors.length - 1]
 	return data
 })

package/src/commands/convert.js

@@ -5,9 +5,7 @@ const { error: { catch_errors, wrap_errors: e } } = require('puffy-core')
 const { require_token } = require('../auth/token_store')
 const repos_api = require('../api/repos')
 const workspaces_api = require('../api/workspaces')
-const { smart_push } = require('../api/push')
 const { parse_frontmatter } = require('../utils/skill_scanner')
-const { collect_files } = require('../utils/file_collector')
 const { write_manifest } = require('../manifest/writer')
 const { read_lock } = require('../lock/reader')
 const { write_lock, update_lock_skills } = require('../lock/writer')
@@ -125,7 +123,7 @@ const run = (args) => catch_errors('Convert failed', async () => {
 		console.error(`  Description: ${description || '(none)'}`)
 		console.error(`  Keywords:    ${keywords.length ? keywords.join(', ') : '(none)'}`)
 		console.error('')
-		const answer = await confirm('Publish this skill to the registry? [y/N] ')
+		const answer = await confirm('Convert this skill to a managed package? [y/N] ')
 		if (answer !== 'y' && answer !== 'yes') {
 			print_info('Aborted.')
 			return process.exit(EXIT_CODES.SUCCESS)
@@ -138,21 +136,6 @@ const run = (args) => catch_errors('Convert failed', async () => {
 	const [manifest_err] = await write_manifest(skill_dir, manifest)
 	if (manifest_err) { pub_spinner.fail('Failed to write skill.json'); throw e('Failed to write skill.json', manifest_err) }
 
-	pub_spinner.update('Packaging skill...')
-	const [collect_err, skill_files] = await collect_files(skill_dir)
-	if (collect_err) { pub_spinner.fail('Failed to collect files'); throw e('File collection failed', collect_err) }
-
-	pub_spinner.update(`Publishing ${workspace.slug}/${skill_name}@${version}...`)
-	const on_progress = (completed, total) => {
-		pub_spinner.update(`Uploading files (${completed}/${total})...`)
-	}
-	const [push_err, push_data] = await smart_push(workspace.slug, skill_name, {
-		version,
-		message: `Release ${version}`,
-		files: skill_files
-	}, on_progress)
-	if (push_err) { pub_spinner.fail('Publish failed'); throw e('Push failed', push_err) }
-
 	pub_spinner.update('Updating lock file...')
 	const lock_dir = lock_root(is_global, project_root)
 	const [, lock_data] = await read_lock(lock_dir)
@@ -162,8 +145,8 @@ const run = (args) => catch_errors('Convert failed', async () => {
 	const updates = {
 		[full_name]: {
 			version,
-			ref: push_data?.ref || `refs/tags/v${version}`,
-			commit: push_data?.commit || null,
+			ref: null,
+			commit: null,
 			integrity: integrity || null,
 			requested_by: ['__root__'],
 			dependencies: {}
@@ -185,6 +168,9 @@ const run = (args) => catch_errors('Convert failed', async () => {
 		} })
 		return
 	}
+
+	console.error('')
+	print_info(`Next step: enrich metadata, then run \`happyskills publish ${skill_name}\` to publish.`)
 }).then(([errors]) => { if (errors) { exit_with_error(errors); return } })
 
 module.exports = { run }

package/src/commands/publish.js

@@ -24,6 +24,7 @@ Arguments:
 Options:
   --bump <type>          Auto-bump version before publishing (patch, minor, major)
   --workspace <slug>     Target workspace (overrides lock file owner)
+  --public               Publish as public (default is private)
 
 Aliases: pub
 
@@ -120,10 +121,12 @@ const run = (args) => catch_errors('Publish failed', async () => {
 	const on_progress = (completed, total) => {
 		spinner.update(`Uploading files (${completed}/${total})...`)
 	}
+	const visibility = args.flags.public ? 'public' : 'private'
 	const [push_err] = await smart_push(workspace.slug, manifest.name, {
 		version: manifest.version,
 		message: `Release ${manifest.version}`,
-		files: skill_files
+		files: skill_files,
+		visibility
 	}, on_progress)
 	if (push_err) { spinner.fail('Publish failed'); throw e('Push failed', push_err) }
 

package/src/commands/search.js

@@ -1,24 +1,31 @@
 const { error: { catch_errors, wrap_errors: e } } = require('puffy-core')
 const repos_api = require('../api/repos')
 const { print_help, print_table, print_json, print_info } = require('../ui/output')
-const { exit_with_error, UsageError } = require('../utils/errors')
+const { exit_with_error, UsageError, AuthError } = require('../utils/errors')
 const { EXIT_CODES } = require('../constants')
+const { load_token } = require('../auth/token_store')
 
-const HELP_TEXT = `Usage: happyskills search <query> [options]
+const HELP_TEXT = `Usage: happyskills search [query] [options]
 
 Search the skill registry.
 
 Arguments:
-  query             Search term
+  query               Search term (optional with --mine, --personal, or --workspace)
 
 Options:
-  --json            Output as JSON
+  -w, --workspace <slug>  Search within specific workspace(s) (comma-separated)
+  --mine                  Search across all your workspaces
+  --personal              Search only your personal workspace
+  --tags <tags>           Filter by tags (comma-separated)
+  --json                  Output as JSON
 
 Aliases: s
 
 Examples:
   happyskills search deploy
-  happyskills s aws --json`
+  happyskills search --mine
+  happyskills search deploy --workspace acme
+  happyskills s --personal --json`
 
 const run = (args) => catch_errors('Search failed', async () => {
 	if (args.flags._show_help) {
@@ -26,32 +33,52 @@ const run = (args) => catch_errors('Search failed', async () => {
 		return process.exit(EXIT_CODES.SUCCESS)
 	}
 
-	const query = args._.join(' ')
-	if (!query) {
-		throw new UsageError('Please provide a search query (e.g., happyskills search deploy).')
+	const query = args._.join(' ') || null
+	const { mine, personal, workspace, tags } = args.flags
+	const has_scope_flag = mine || personal || workspace
+
+	if (!query && !has_scope_flag && !tags) {
+		throw new UsageError('Please provide a search query or use --mine, --personal, or --workspace.')
+	}
+
+	const scope = mine ? 'mine' : personal ? 'personal' : undefined
+
+	if (has_scope_flag) {
+		const [, token_data] = await load_token()
+		if (!token_data) {
+			throw new AuthError('Authentication required. Run `happyskills login` first.')
+		}
 	}
 
-	const [errors, results] = await repos_api.search(query)
+	const options = {}
+	if (scope) options.scope = scope
+	if (workspace) options.workspace = workspace
+	if (tags) options.tags = tags
+
+	const [errors, results] = await repos_api.search(query, options)
 	if (errors) throw e('Search failed', errors)
 
 	const items = Array.isArray(results) ? results : (results?.repos || results?.items || [])
+	const effective_scope = scope || (has_scope_flag ? undefined : undefined)
 
 	if (items.length === 0) {
 		if (args.flags.json) {
-			print_json({ data: { query, results: [], count: 0 } })
+			print_json({ data: { query, scope: effective_scope || 'all', results: [], count: 0 } })
 			return
 		}
-		print_info(`No skills found for "${query}".`)
+		const context = query ? ` for "${query}"` : ''
+		print_info(`No skills found${context}.`)
 		return
 	}
 
 	if (args.flags.json) {
-		const results = items.map(item => ({
+		const mapped = items.map(item => ({
 			skill: `${item.owner || item.workspace_slug}/${item.name}`,
 			description: item.description || '',
-			version: item.latest_version || item.version || '-'
+			version: item.latest_version || item.version || '-',
+			visibility: item.visibility || 'public'
 		}))
-		print_json({ data: { query, results, count: results.length } })
+		print_json({ data: { query, scope: effective_scope || 'all', results: mapped, count: mapped.length } })
 		return
 	}
 

package/src/index.js

@@ -62,6 +62,7 @@ const parse_args = (argv) => {
 const SHORT_FLAGS = {
 	g: 'global',
 	y: 'yes',
+	w: 'workspace',
 }
 
 const normalize_flags = (flags) => {
@@ -114,7 +115,7 @@ const run = (argv) => {
 		set_json_mode()
 	}
 
-	if (args.flags.version) {
+	if (args.flags.version === true) {
 		show_version()
 		return process.exit(EXIT_CODES.SUCCESS)
 	}