happyskills 0.28.0 → 0.29.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.29.0] - 2026-04-02
+
+### Added
+- Handle async archive processing for large skill publishes — when the server delegates to a background worker, the CLI polls for completion with a "Processing on server..." spinner
+
+## [0.28.1] - 2026-04-02
+
+### Fixed
+- Exclude macOS metadata files (`._*`, `.DS_Store`) from tar archive during `publish` to prevent server-side extraction failures
+
 ## [0.28.0] - 2026-04-02
 
 ### Added

package/package.json

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

@@ -47,6 +47,15 @@ const archive_push = (owner, repo, { version, message, files, visibility, base_c
 			const [complete_err, complete_data] = await complete_upload(owner, repo, complete_body)
 			if (complete_err) throw e('Upload completion failed', complete_err)
 
+			// Async processing (202) — poll for completion
+			if (complete_data.status === 'processing') {
+				if (on_progress) on_progress('polling')
+				const { poll_push_status } = require('./upload')
+				const [poll_err, result] = await poll_push_status(owner, repo, complete_data.upload_id)
+				if (poll_err) throw e('Async push processing failed', poll_err)
+				return result
+			}
+
 			return complete_data
 		} finally {
 			cleanup_archive(archive.path)

package/src/api/upload.js

@@ -45,4 +45,21 @@ const upload_files_parallel = (files_with_urls, on_progress) => catch_errors('Pa
 	}
 })
 
-module.exports = { initiate_upload, complete_upload, upload_file_to_s3, upload_files_parallel }
+const poll_push_status = (owner, repo, upload_id, { timeout_ms = 300000, interval_ms = 2000 } = {}) =>
+	catch_errors('Push status polling failed', async () => {
+		const start = Date.now()
+		while (Date.now() - start < timeout_ms) {
+			const [err, data] = await client.get(`/repos/${owner}/${repo}/push/status/${upload_id}`)
+			if (err) throw e('Failed to check push status', err)
+
+			if (data.status === 'completed') return data
+			if (data.status === 'failed') {
+				throw Object.assign(new Error(data.error || 'Push processing failed'), { code: data.code })
+			}
+
+			await new Promise(resolve => setTimeout(resolve, interval_ms))
+		}
+		throw new Error('Push processing timed out after 5 minutes')
+	})
+
+module.exports = { initiate_upload, complete_upload, upload_file_to_s3, upload_files_parallel, poll_push_status }

package/src/commands/publish.js

@@ -186,7 +186,11 @@ const run = (args) => catch_errors('Publish failed', async () => {
 
 	spinner.update(`Publishing ${workspace.slug}/${manifest.name}@${manifest.version}...`)
 	const on_progress = (completed, total) => {
-		spinner.update(`Uploading files (${completed}/${total})...`)
+		if (completed === 'polling') {
+			spinner.update('Processing on server...')
+		} else {
+			spinner.update(`Uploading files (${completed}/${total})...`)
+		}
 	}
 	const visibility = args.flags.public ? 'public' : 'private'
 	const push_options = {

package/src/utils/archive.js

@@ -11,7 +11,7 @@ const exec_file = promisify(execFile)
 const create_archive = (source_dir) =>
 	catch_errors('Failed to create archive', async () => {
 		const archive_path = path.join(os.tmpdir(), `happyskills-${crypto.randomUUID()}.tar.gz`)
-		await exec_file('tar', ['czf', archive_path, '-C', source_dir, '.'])
+		await exec_file('tar', ['czf', archive_path, '--exclude', '._*', '--exclude', '.DS_Store', '-C', source_dir, '.'])
 		const buffer = await fs.promises.readFile(archive_path)
 		const sha = crypto.createHash('sha256').update(buffer).digest('hex')
 		return { path: archive_path, buffer, sha, size: buffer.length }