agent-skills-standard 2.4.2 → 2.4.4

package/README.md

@@ -5,11 +5,15 @@
 
 **Sync 242 AI coding standards to any project in one command.** Works with Cursor, Claude Code, GitHub Copilot, Gemini, Windsurf, Trae, Kiro, and Roo.
 
+**Current release:** `v2.4.4` — packaged `ags -V` now matches the published CLI version.
+
 ```bash
 npx agent-skills-standard@latest init   # detect your stack
 npx agent-skills-standard@latest sync   # install skills
 ```
 
+If `ags -V` still shows an old version after reinstalling, check your PATH order. `~/Library/pnpm` must come before `~/Library/pnpm/bin`, then run `hash -r` and verify with `ags -V` again.
+
 ---
 
 ## What It Does
@@ -32,14 +36,14 @@ The result: your AI agent reads `AGENTS.md`, follows the router to the right cat
 
 ## Commands
 
-| Command    | What it does                                                                                   |
-| :--------- | :--------------------------------------------------------------------------------------------- |
-| `init`     | Detects your tech stack (Flutter, React, Go, etc.) and creates a `.skillsrc` config            |
-| `sync`     | Fetches skills from the registry, writes to agent folders, generates `_INDEX.md` + `AGENTS.md` |
+| Command    | What it does                                                                                                                                                                                       |
+| :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `init`     | Detects your tech stack (Flutter, React, Go, etc.) and creates a `.skillsrc` config                                                                                                                |
+| `sync`     | Fetches skills from the registry, writes to agent folders, generates `_INDEX.md` + `AGENTS.md`                                                                                                     |
 | `mcp`      | Manage the optional MCP server integration (status / enable / disable / scope / install / uninstall / snippets) — see [Optional: MCP Runtime Enforcement](#optional-mcp-runtime-enforcement) below |
-| `validate` | Checks your custom skills against format and token standards                                   |
-| `feedback` | Submits improvement suggestions to the registry                                                |
-| `upgrade`  | Updates the CLI to the latest version                                                          |
+| `validate` | Checks your custom skills against format and token standards                                                                                                                                       |
+| `feedback` | Submits improvement suggestions to the registry                                                                                                                                                    |
+| `upgrade`  | Updates the CLI to the latest version                                                                                                                                                              |
 
 ---
 
@@ -120,16 +124,16 @@ The CLI **never** modifies user-home files (`~/.cursor/mcp.json`, `~/.gemini/set
 
 ### 📜 Benchmark History
 
-| Version | Date | Skills | Avg Tokens | Savings (%) | Report |
-| --- | --- | --- | --- | --- | --- |
-| v2.4.2 | 2026-05-19 | 247 | 540 | 85% | [Report](benchmarks/archive/v2.4.2.md) |
-| v2.4.1 | 2026-05-18 | 247 | 540 | 85% | [Report](benchmarks/archive/v2.4.1.md) |
-| v2.4.0 | 2026-05-14 | 246 | 540 | 85% | [Report](benchmarks/archive/v2.4.0.md) |
-| v2.3.0 | 2026-05-13 | 246 | 540 | 85% | [Report](benchmarks/archive/v2.3.0.md) |
-| v2.2.2 | 2026-05-09 | 249 | 539 | 85% | [Report](benchmarks/archive/v2.2.2.md) |
-| v2.2.0 | 2026-04-22 | 242 | 538 | 85% | [Report](benchmarks/archive/v2.2.0.md) |
-| v2.1.2 | 2026-04-11 | 237 | 516 | 86% | [Report](benchmarks/archive/v2.1.2.md) |
-| v2.1.1 | 2026-04-11 | 237 | 516 | 86% | [Report](benchmarks/archive/v2.1.1.md) |
-| v2.1.0 | 2026-04-04 | 237 | 526 | 86% | [Report](benchmarks/archive/v2.1.0.md) |
-| v2.0.1 | 2026-03-30 | 238 | 527 | 86% | [Report](benchmarks/archive/v2.0.1.md) |
-| v2.0.0 | 2026-03-25 | 235 | 523 | 86% | [Report](benchmarks/archive/v2.0.0.md) |
+| Version | Date       | Skills | Avg Tokens | Savings (%) | Report                                 |
+| ------- | ---------- | ------ | ---------- | ----------- | -------------------------------------- |
+| v2.4.2  | 2026-05-19 | 247    | 540        | 85%         | [Report](benchmarks/archive/v2.4.2.md) |
+| v2.4.1  | 2026-05-18 | 247    | 540        | 85%         | [Report](benchmarks/archive/v2.4.1.md) |
+| v2.4.0  | 2026-05-14 | 246    | 540        | 85%         | [Report](benchmarks/archive/v2.4.0.md) |
+| v2.3.0  | 2026-05-13 | 246    | 540        | 85%         | [Report](benchmarks/archive/v2.3.0.md) |
+| v2.2.2  | 2026-05-09 | 249    | 539        | 85%         | [Report](benchmarks/archive/v2.2.2.md) |
+| v2.2.0  | 2026-04-22 | 242    | 538        | 85%         | [Report](benchmarks/archive/v2.2.0.md) |
+| v2.1.2  | 2026-04-11 | 237    | 516        | 86%         | [Report](benchmarks/archive/v2.1.2.md) |
+| v2.1.1  | 2026-04-11 | 237    | 516        | 86%         | [Report](benchmarks/archive/v2.1.1.md) |
+| v2.1.0  | 2026-04-04 | 237    | 526        | 86%         | [Report](benchmarks/archive/v2.1.0.md) |
+| v2.0.1  | 2026-03-30 | 238    | 527        | 86%         | [Report](benchmarks/archive/v2.0.1.md) |
+| v2.0.0  | 2026-03-25 | 235    | 523        | 86%         | [Report](benchmarks/archive/v2.0.0.md) |

package/dist/index.js

@@ -4487,7 +4487,7 @@ var SyncCommand = class {
 };
 var package_default = {
 	name: "agent-skills-standard",
-	version: "2.4.2",
+	version: "2.4.4",
 	description: "A CLI to manage and sync AI agent skills standard for Cursor, Claude, Copilot, Windsurf, and more.",
 	main: "dist/index.js",
 	bin: {
@@ -4588,7 +4588,31 @@ var UpgradeCommand = class {
 				console.log(picocolors.default.yellow(`⚠️  Failed to install v${latestVersion}. Retrying with @latest...`));
 				(0, child_process.execSync)(this.getUpgradeCommand(pm, "latest"), { stdio: "inherit" });
 			}
-			try {
+			if (pm === "pnpm") {
+				const installedVersion = this.getInstalledVersionFromPnpm(latestVersion);
+				if (installedVersion !== latestVersion) {
+					console.log("\n" + picocolors.default.red(`❌ pnpm install completed, but the installed package still reports v${installedVersion ?? "unknown"}.`));
+					console.log(picocolors.default.gray("   This means the global install itself is stale or incomplete, not just the shell shim."));
+					this.printShellMismatchHint();
+					return;
+				}
+				try {
+					const lines = (0, child_process.execSync)("ags -V", {
+						encoding: "utf8",
+						stdio: "pipe"
+					}).trim().split("\n");
+					const shellVersion = lines[lines.length - 1].trim();
+					if (shellVersion.includes(latestVersion)) console.log(picocolors.default.green(`✅ Successfully upgraded to v${latestVersion}!`));
+					else {
+						console.log("\n" + picocolors.default.yellow(`⚠️  pnpm installed v${latestVersion}, but 'ags -V' still reports v${shellVersion}.`));
+						console.log(picocolors.default.gray("   Your shell is still resolving a stale shim or PATH entry."));
+						this.printShellMismatchHint();
+					}
+				} catch {
+					console.log(picocolors.default.green("\n✅ Upgrade command finished."));
+					console.log(picocolors.default.gray("   (Installed version verified via pnpm; please check the shell command with 'ags -V')"));
+				}
+			} else try {
 				const lines = (0, child_process.execSync)("ags -V", {
 					encoding: "utf8",
 					stdio: "pipe"
@@ -4596,9 +4620,14 @@ var UpgradeCommand = class {
 				const installedVersion = lines[lines.length - 1].trim();
 				if (installedVersion.includes(latestVersion)) console.log(picocolors.default.green(`✅ Successfully upgraded to v${latestVersion}!`));
 				else {
+					const resolvedBinary = (0, child_process.execSync)("type -a ags", {
+						encoding: "utf8",
+						stdio: "pipe"
+					}).trim();
 					console.log("\n" + picocolors.default.yellow(`⚠️  Installation complete, but 'ags -V' still reports v${installedVersion}.`));
-					console.log(picocolors.default.gray("   This is common if multiple versions are installed or your shell needs a restart."));
-					console.log(picocolors.default.cyan(`👉 Recommendation: Restart your terminal or run: ${picocolors.default.bold(this.getUpgradeCommand(pm, latestVersion) + " --force")}`));
+					console.log(picocolors.default.gray("   This usually means your shell is still resolving a stale shim or PATH entry."));
+					console.log(picocolors.default.gray(`   Resolved binary:\n${resolvedBinary}`));
+					console.log(picocolors.default.cyan(`👉 Recommendation: make sure ${picocolors.default.bold("~/Library/pnpm")} comes before ${picocolors.default.bold("~/Library/pnpm/bin")} in PATH, then run ${picocolors.default.bold("hash -r")} and recheck with 'ags -V'.`));
 				}
 			} catch {
 				console.log(picocolors.default.green("\n✅ Upgrade command finished."));
@@ -4628,6 +4657,29 @@ var UpgradeCommand = class {
 			default: return `npm install -g agent-skills-standard@${version}`;
 		}
 	}
+	getInstalledVersionFromPnpm(version) {
+		try {
+			const globalRoot = (0, child_process.execSync)("pnpm root -g", {
+				encoding: "utf8",
+				stdio: "pipe"
+			}).trim();
+			const packageJsonPath = path.default.join(globalRoot, ".pnpm", `agent-skills-standard@${version}`, "node_modules", "agent-skills-standard", "package.json");
+			return (0, child_process.execSync)(`node -p "require(${JSON.stringify(packageJsonPath)}).version"`, {
+				encoding: "utf8",
+				stdio: "pipe"
+			}).trim() || null;
+		} catch {
+			return null;
+		}
+	}
+	printShellMismatchHint() {
+		const resolvedBinary = (0, child_process.execSync)("type -a ags", {
+			encoding: "utf8",
+			stdio: "pipe"
+		}).trim();
+		console.log(picocolors.default.gray(`   Resolved binary:\n${resolvedBinary}`));
+		console.log(picocolors.default.cyan(`👉 Recommendation: make sure ${picocolors.default.bold("~/Library/pnpm")} comes before ${picocolors.default.bold("~/Library/pnpm/bin")} in PATH, then run ${picocolors.default.bold("hash -r")} and recheck with 'ags -V'.`));
+	}
 	printManualInstructions(pm, version) {
 		const sudoPrefix = process.platform === "win32" ? "" : "sudo ";
 		console.log(picocolors.default.yellow("Possible reasons:"));
@@ -4973,7 +5025,7 @@ var ValidateCommand = class {
 //#region src/index.ts
 dotenv.default.config();
 var program = new commander.Command();
-program.name("agent-skills-standard").description("A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.").version("2.4.2");
+program.name("agent-skills-standard").description("A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.").version("2.4.4");
 program.command("init").description("Initialize a .skillsrc configuration file interactively").action(async () => {
 	await new InitCommand().run();
 });