sherpa-skill 2.0.5 → 2.0.6

package/README.md

@@ -59,7 +59,9 @@ To remove:
 sherpa uninstall
 ```
 
-The npm wrapper commands are `install`, `migrate`, and `uninstall`. (The separate `sherpa` CLI installed by the release script below supports `update`, `doctor`, `audit`, `clean`, and `help`.)
+The npm `sherpa` launcher supports `install`, `migrate`, and `uninstall`, and forwards `update`, `doctor`, `audit`, `clean`, `help`, and `--version` to the bundled management CLI. Management commands require Python 3.
+
+Install with `--global` to call `sherpa` directly. For a local install, prefix commands with `npx sherpa-skill`, for example `npx sherpa-skill doctor`.
 
 Node.js is required to run the npm package. `package.json` does not declare an `engines` field, so no specific Node version is pinned — use a current LTS release.
 
@@ -118,7 +120,7 @@ Each operation maps to a real workflow in `workflows/` (e.g. `idea-intelligence.
 |---|---|---:|---|
 | Claude Code | `.claude/skills/` skill and command files | Yes | VERIFIED |
 | OpenCode | `.opencode/commands/` and package metadata | Yes | VERIFIED |
-| Kilo Code | `.kilo/commands/` | No | NOT VERIFIED |
+| Kilo Code | `kilo.jsonc`, `.kilo/rules/`, `.kilo/commands/`, `.kilo/skills/` | No | NOT VERIFIED |
 | Codex CLI, Qwen Code, Gemini CLI | No verified native adapter | No | Not supported |
 
 Details and evidence: [agent compatibility](AGENT-COMPATIBILITY.md).

package/distribution/cli/sherpa

@@ -9,6 +9,9 @@ Commands:
     sherpa update
     sherpa uninstall
     sherpa doctor
+    sherpa migrate
+    sherpa audit
+    sherpa clean [--dry-run | --yes]
     sherpa help
 
 The CLI never touches user project data or `.hackathon/` directories.
@@ -48,7 +51,7 @@ CLI_NAME = "sherpa"
 
 # Embedded fallback version. Overridden by a VERSION file next to this script
 # when one is shipped by the installer/release.
-DEFAULT_CLI_VERSION = "2.0.5"
+DEFAULT_CLI_VERSION = "2.0.6"
 
 # Default release manifest URL. Users publishing their own releases override
 # this with SHERPA_RELEASE_MANIFEST_URL.
@@ -155,7 +158,7 @@ def fetch_json(url: str, timeout: int = 30) -> dict:
         supported_major = int(latest.split(".", 1)[0]) >= 2
     except (AttributeError, ValueError):
         supported_major = False
-    if project != PROJECT or not supported_major:
+    if not isinstance(project, str) or project.casefold() != PROJECT.casefold() or not supported_major:
         raise sherpaError(f"release manifest is for {project!r} version {latest!r}, not Sherpa 2.0.0 or newer")
     return manifest
 
@@ -511,6 +514,8 @@ Usage:
     sherpa uninstall       Remove installed skills (preserves user data)
     sherpa doctor          Diagnose the installation environment
     sherpa migrate         Copy legacy .hackathon/ state into .sherpa/
+    sherpa audit           Report files in managed skill installations
+    sherpa clean           Report or remove generated debris in managed installations
     sherpa help            Show this help
 
 Environment variables:

package/distribution/npm/sherpa.mjs

@@ -10,17 +10,20 @@ const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '
 const args = process.argv.slice(2)
 
 function help() {
-  console.log(`sherpa skill installer
+  console.log(`sherpa package launcher
 
 Usage:
   sherpa install [--dry-run]
   sherpa install --no-cli
-  sherpa migrate [--project-root PATH] [--yes]
   sherpa install --uninstall
   sherpa uninstall
+  sherpa migrate [--project-root PATH] [--yes]
+  sherpa --version
+  sherpa update | doctor | audit | clean | help
 
 Install targets: Claude Code and OpenCode. Use --dry-run to print target paths
-without downloading or writing files. Uninstall removes managed global installs.`)
+without downloading or writing files. Management commands use the bundled
+Python CLI. Uninstall removes managed global installs.`)
 }
 
 function run(script, scriptArgs, env = process.env) {
@@ -63,17 +66,21 @@ if (args.includes('--help') || args.includes('-h') || args.length === 0) {
 }
 
 const command = args[0]
+const managementCommands = new Set(['update', 'doctor', 'audit', 'clean', 'help'])
+if (command === '--version' || managementCommands.has(command)) {
+  const script = path.join(packageRoot, 'distribution', 'cli', 'sherpa')
+  runPython(script, args)
+}
 if (command === 'migrate') {
   const script = path.join(packageRoot, 'distribution', 'cli', 'sherpa')
   runPython(script, ['migrate', ...args.slice(1)])
 }
-const dryRun = args.includes('--dry-run')
-const uninstall = command === 'uninstall' || args.includes('--uninstall')
 if (!['install', 'uninstall'].includes(command)) {
-  console.error(`Unknown command: ${command}`)
-  help()
-  process.exit(2)
+  const script = path.join(packageRoot, 'distribution', 'cli', 'sherpa')
+  runPython(script, args)
 }
+const dryRun = args.includes('--dry-run')
+const uninstall = command === 'uninstall' || args.includes('--uninstall')
 if (dryRun && uninstall) {
   console.error('--dry-run cannot be combined with --uninstall.')
   process.exit(2)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "sherpa-skill",
-    "version": "2.0.5",
+    "version": "2.0.6",
     "description": "Install the sherpa AI agent skill for Claude Code and OpenCode",
     "license": "MIT",
     "type": "module",