harveyz-skill 0.29.0 → 0.29.1

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.29.1] - 2026-08-28
+
+### Added
+- `hskill version --check`：检查 npm registry 上的最新版本并与本地版本比对，只报告不安装。支持 `--json`；网络/registry 请求失败时非零退出
+
 ## [0.29.0] - 2026-08-28
 
 ### Added

package/bin/cli.js

@@ -53,6 +53,7 @@ function printHelp() {
     hskill update                  update hskill to the latest version
     hskill mcp                     start an MCP server (stdio) exposing hskill's tools to MCP-capable agent hosts
     hskill version                 show version
+    hskill version --check         compare local version against npm registry (no install)
     hskill --help                  show this help
 
   ${chalk.cyan('Examples:')}
@@ -156,6 +157,24 @@ if (args[0] === '--help' || args[0] === '-h') {
 }
 
 if (args[0] === '--version' || args[0] === '-v' || subcommand === 'version') {
+  if (subcommand === 'version' && args.includes('--check')) {
+    try {
+      const { checkNpmVersion } = await import('../lib/version-check.js')
+      const { current, latest, upToDate } = await checkNpmVersion('harveyz-skill', version)
+      if (jsonFlag) {
+        console.log(JSON.stringify({ current, latest, upToDate }, null, 2))
+      } else if (upToDate) {
+        console.log(chalk.green(`  ✔ hskill v${current} is up to date`))
+      } else {
+        console.log(chalk.yellow(`  ⚠ hskill v${current} → v${latest} available`))
+        console.log(chalk.dim('  Run: npm install -g harveyz-skill@latest'))
+      }
+    } catch (err) {
+      console.error(chalk.red(`  ✗ Could not check npm registry: ${err.message}`))
+      process.exit(1)
+    }
+    process.exit(0)
+  }
   console.log(version)
   process.exit(0)
 }

package/lib/version-check.js

@@ -0,0 +1,29 @@
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org'
+const REGISTRY_TIMEOUT_MS = 5000
+
+export function compareVersions(a, b) {
+  const pa = a.split('.').map(Number)
+  const pb = b.split('.').map(Number)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const diff = (pa[i] || 0) - (pb[i] || 0)
+    if (diff !== 0) return diff
+  }
+  return 0
+}
+
+export async function checkNpmVersion(pkgName, currentVersion) {
+  const registryUrl = process.env.HSKILL_NPM_REGISTRY || DEFAULT_REGISTRY
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), REGISTRY_TIMEOUT_MS)
+  let res
+  try {
+    res = await fetch(`${registryUrl}/${pkgName}/latest`, { signal: controller.signal })
+  } finally {
+    clearTimeout(timer)
+  }
+  if (!res.ok) {
+    throw new Error(`npm registry returned ${res.status} for ${pkgName}`)
+  }
+  const { version: latest } = await res.json()
+  return { current: currentVersion, latest, upToDate: compareVersions(currentVersion, latest) >= 0 }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "description": "Skill manager for Claude Code, Cursor, Codex, OpenClaw, Hermes, OpenCode, and Pi",
   "type": "module",
   "bin": {