feat: migrate to gunsmith, lazy-load commands, modernize dependencies

Changes:
- switch CLI framework to gunsmith 0.6.0: short aliases (-a), shell completions, -h/-v, json feature disabled, color handled end-to-end
- defer repository resolution, loader child spawn, and script imports into command handlers so bare/help/version invocations run instantly
- adopt gunsmith soft exit: serve() exit code via process.exitCode, child exit mirrored without process.exit, run errors use exitCode idiom
- await script.run and REPL lifetime in handlers; widen Script.run return type to void | Promise<void>
- migrate globals and examples/shell.ts to execa 9 (verbose "short", pipe API); REPL history via getGlobalCachePath (env-paths 4 rejects scoped names)
- repair examples/tsconfig.json (stale absolute paths, missing target/moduleResolution) and switch root tsconfig to moduleResolution bundler
- upgrade deps: glob 13, @inquirer/prompts 8, ava 8, TypeScript 6, husky 9 (new hook format, pnpm in pre-commit), commitlint 21, lint-staged 17, sinon 22, semantic-release 25, pkgroll 2.27; audit 13 vulns -> 0
- raise engines to node >=22 and build target to node22

Author: 3rd

.husky/commit-msg

@@ -1,4 +1 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
 NODE_OPTIONS='--import=tsx --no-warnings' npx --no-install commitlint --edit "$1"

.husky/pre-commit

@@ -1,5 +1,2 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-yarn test
+pnpm test
 npx lint-staged

examples/shell.ts

@@ -1,28 +1,27 @@
 import "auto";
-import { ExecaChildProcess } from "execa";
 
 export default auto({
   id: "shell",
   title: "Shell-like usage",
   run: async ({ project }) => {
     cd(project.rootDirectory);
 
-    console.log((await execa("cat", ["package.json"]).pipeStdout?.(execa("grep", ["license"])))?.stdout);
+    console.log((await execa("cat", ["package.json"]).pipe("grep", ["license"])).stdout);
 
     const whoami = await $`whoami`;
-    await $`echo "Hello, ${whoami}"`.pipeStdout?.(process.stdout);
+    await $({ stdout: ["pipe", "inherit"] })`echo "Hello, ${whoami}"`;
 
     console.log(
       (
         await Promise.all(
           [
             async () => {
               await sleep(100);
-              return $`echo "1"`.pipeStdout?.(process.stdout);
+              return $({ stdout: ["pipe", "inherit"] })`echo "1"`;
             },
             async () => {
               await sleep(200);
-              return $`echo "2"`.pipeStdout?.(process.stdout);
+              return $({ stdout: ["pipe", "inherit"] })`echo "2"`;
             },
           ].map((f) => f())
         )

examples/tsconfig.json

@@ -1,17 +1,15 @@
-/* This file should be auto-generated, don't copy-paste this. */
 {
   "compilerOptions": {
     "strict": true,
-    "lib": [],
+    "target": "es2022",
+    "lib": ["es2022"],
+    "module": "esnext",
+    "moduleResolution": "bundler",
     "jsx": "react-jsx",
-    "baseUrl": ".",
-    "typeRoots": [
-      "/home/user/.npm/.../globals" /* auto-generated */
-    ],
+    "types": ["node"],
     "paths": {
-      "auto": [
-      "/home/user/.npm/.../globals" /* auto-generated */
-      ]
+      "auto": ["../dist/globals/index.d.ts"]
     }
-  }
+  },
+  "exclude": ["generate-react-component"]
 }

package.json

@@ -34,32 +34,31 @@
     "auto": "./dist/main.js"
   },
   "engines": {
-    "node": ">= 18.0.0"
+    "node": ">=22"
   },
   "scripts": {
     "dev": "pnpm test:watch",
     "build:watch": "pkgroll --watch",
-    "build": "pnpm run clean && pkgroll --target=node18",
+    "build": "pnpm run clean && pkgroll --target=node22",
     "test": "NODE_OPTIONS='--import=tsx --no-warnings' ava",
     "test:watch": "NODE_OPTIONS='--import=tsx --no-warnings' ava --watch",
     "e2e": "docker run --rm -it $(docker build -f src/e2e/Dockerfile -q .)",
     "tsc": "tsc",
-    "prepare": "husky install",
+    "prepare": "husky",
     "prepublishOnly": "pnpm run build && pnpm run tsc && pnpm run test",
     "clean": "rm -rf dist"
   },
   "ava": {
-    "extensions": {
-      "ts": "commonjs"
-    }
+    "extensions": [
+      "ts"
+    ]
   },
   "lint-staged": {
     "*": "prettier --ignore-unknown --write"
   },
   "prettier": {
     "arrowParens": "always",
     "bracketSpacing": true,
-    "jsxBracketSameLine": false,
     "printWidth": 120,
     "quoteProps": "as-needed",
     "semi": true,
@@ -69,37 +68,38 @@
     "useTabs": false
   },
   "devDependencies": {
-    "@commitlint/cli": "^18.4.4",
-    "@commitlint/config-conventional": "^18.4.4",
+    "@commitlint/cli": "^21.2.0",
+    "@commitlint/config-conventional": "^21.2.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "@types/node": "^20.11.5",
-    "@types/sinon": "^17.0.3",
-    "ava": "^6.0.1",
-    "husky": "^8.0.3",
-    "lint-staged": "^15.2.0",
-    "pkgroll": "^2.0.1",
-    "prettier": "^3.2.4",
-    "semantic-release": "^23.0.0",
-    "sinon": "^17.0.1",
-    "typescript": "^5.3.3"
+    "@types/node": "^22.20.0",
+    "@types/sinon": "^22.0.0",
+    "ava": "^8.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.8",
+    "pkgroll": "^2.27.1",
+    "prettier": "^3.9.4",
+    "semantic-release": "^25.0.5",
+    "sinon": "^22.0.0",
+    "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@inquirer/prompts": "^3.3.0",
+    "@inquirer/prompts": "^8.5.2",
     "@types/cross-spawn": "^6.0.6",
     "@types/fs-extra": "^11.0.4",
-    "@types/lodash": "^4.14.202",
-    "@types/which": "^3.0.3",
-    "chalk": "^5.3.0",
-    "cleye": "^1.3.2",
-    "cross-spawn": "^7.0.3",
-    "env-paths": "^3.0.0",
-    "execa": "^8.0.1",
-    "find-up": "^7.0.0",
-    "fs-extra": "^11.2.0",
-    "glob": "^10.3.10",
-    "lodash": "^4.17.21",
-    "tsx": "^4.7.0",
-    "which": "^4.0.0"
+    "@types/lodash": "^4.17.24",
+    "@types/which": "^3.0.4",
+    "chalk": "^5.6.2",
+    "cross-spawn": "^7.0.6",
+    "env-paths": "^4.0.0",
+    "execa": "^9.6.1",
+    "find-up": "^8.0.0",
+    "fs-extra": "^11.3.6",
+    "glob": "^13.0.6",
+    "gunsmith": "^0.6.0",
+    "lodash": "^4.18.1",
+    "tsx": "^4.23.0",
+    "which": "^4.0.0",
+    "zod": "^4.4.3"
   }
 }