gunshi 0.35.3 → 0.37.0

package/README.md

@@ -17,7 +17,7 @@ Gunshi is a modern javascript command-line library
 
 <!-- eslint-enable markdown/no-missing-label-refs -->
 
-## ✨ Features
+## Features
 
 Gunshi is designed to simplify the creation of modern command-line interfaces:
 
@@ -26,9 +26,10 @@ Gunshi is designed to simplify the creation of modern command-line interfaces:
 - 🧩 **Composable & Lazy**: Create modular sub-commands with context sharing and lazy loading for better performance.
 - 🎨 **Flexible Rendering**: Customize usage generation, validation errors, and help messages with pluggable renderers.
 - 🌍 **Internationalization**: Built with global users in mind, featuring locale-aware design, resource management, and multi-language support.
+- 🤖 **Agent-aware**: Detect AI coding-agent environments through the stable [`gunshi/agent`](https://gunshi.dev/guide/advanced/ai-agent-detection) utility without changing CLI behavior automatically.
 - 🔌 **Pluggable**: Extensible plugin system with dependency management and lifecycle hooks for modular CLI development.
 
-## 💿 Installation
+## Installation
 
 ```sh
 # npm
@@ -47,7 +48,7 @@ deno add jsr:@gunshi/gunshi
 bun add gunshi
 ```
 
-## 🚀 Usage
+## Usage
 
 ```js
 import { cli } from 'gunshi'
@@ -94,7 +95,7 @@ await cli(process.argv.slice(2), command, {
 
 About more details and usage, see [documentations](https://gunshi.dev)
 
-## 💁‍♀️ Showcases
+## Showcases
 
 - [pnpmc](https://github.com/kazupon/pnpmc): PNPM Catalogs Tooling
 - [sourcemap-publisher](https://github.com/es-tooling/sourcemap-publisher): A tool to publish sourcemaps externally and rewrite sourcemap URLs at pre-publish time
@@ -103,11 +104,11 @@ About more details and usage, see [documentations](https://gunshi.dev)
 - [ccusage](https://github.com/ryoppippi/ccusage): A CLI tool for analyzing Claude Code usage from local JSONL files
 - [varlock](https://github.com/dmno-dev/varlock): Enhanced .env file loader, using @decorator style comments to add validation, type-safety, and more
 
-## 🙌 Contributing guidelines
+## Contributing guidelines
 
 If you are interested in contributing to `gunshi`, I highly recommend checking out [the contributing guidelines](/CONTRIBUTING.md) here. You'll find all the relevant information such as [how to make a PR](/CONTRIBUTING.md#pull-request-guidelines), [how to setup development](/CONTRIBUTING.md#development-setup)) etc., there.
 
-## 💖 Credits
+## Credits
 
 This project is inspired and powered by:
 
@@ -117,7 +118,7 @@ This project is inspired and powered by:
 
 Thank you!
 
-## 🤝 Sponsors
+## Sponsors
 
 The development of Gunshi is supported by my OSS sponsors!
 
@@ -127,7 +128,7 @@ The development of Gunshi is supported by my OSS sponsors!
   </a>
 </p>
 
-## ©️ License
+## License
 
 [MIT](http://opensource.org/licenses/MIT)
 

package/lib/agent.js

@@ -177,18 +177,17 @@ I()?.name;
 //#endregion
 //#region src/agent.ts
 /**
-* The entry point for AI agent detection utility.
+* The entry point for AI agent detection utilities.
+*
+* Detection is delegated to {@link https://github.com/unjs/std-env | std-env}.
+* The `gunshi/agent` API exposes a stable, minimal profile while the recognized
+* agent names and detection rules may evolve with the upstream detector.
 *
 * @example
 * ```js
 * import { getAgentProfile } from 'gunshi/agent'
 * ```
 *
-* @experimental
-* The `gunshi/agent` entry point is experimental. The agent detection rules
-* are delegated to {@link https://github.com/unjs/std-env | std-env} and may
-* change as the upstream detector list evolves.
-*
 * @author kazuya kawaguchi (a.k.a. kazupon)
 * @license MIT
 */

package/lib/{cli-DnXk5aCq.js → cli-C4_IDXMQ.js}

@@ -1,6 +1,6 @@
 import { r as hasPriorityValidationError } from "./error-xSnOOdnr.js";
 import { t as plugin } from "./plugin-DhJZVIbl.js";
-import { a as namespacedId, o as COMMON_ARGS, t as renderer } from "./src-DbfZvEe0.js";
+import { a as namespacedId, o as COMMON_ARGS, t as renderer } from "./src-DIz-QFuo.js";
 import { t as cliCore } from "./core-CbE1I4Jl.js";
 //#region ../plugin-global/src/types.ts
 /**

package/lib/generator.js

@@ -1,5 +1,5 @@
 import { create } from "./utils.js";
-import { t as cli } from "./cli-DnXk5aCq.js";
+import { t as cli } from "./cli-C4_IDXMQ.js";
 //#region src/generator.ts
 /**
 * The entry for usage generator.

package/lib/index.js

@@ -2,8 +2,8 @@ import { n as ANONYMOUS_COMMAND_NAME, t as createCommandContext } from "./contex
 import { a as parseArgs, i as resolveArgs, n as ArgsValidationErrorKeys, r as isArgsValidationError, t as ArgsValidationError } from "./resolver-UFOtObbe.js";
 import { i as isCommandNotFoundError, n as CommandNotFoundErrorKeys, r as hasPriorityValidationError, t as CommandNotFoundError } from "./error-xSnOOdnr.js";
 import { t as plugin } from "./plugin-DhJZVIbl.js";
-import { a as namespacedId } from "./src-DbfZvEe0.js";
-import { t as cli } from "./cli-DnXk5aCq.js";
+import { a as namespacedId } from "./src-DIz-QFuo.js";
+import { t as cli } from "./cli-C4_IDXMQ.js";
 import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
 //#region ../plugin-i18n/src/translation.ts
 /**

package/lib/renderer.js

@@ -1,4 +1,4 @@
-import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-DbfZvEe0.js";
+import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-DIz-QFuo.js";
 //#region src/renderer.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/{src-DbfZvEe0.js → src-DIz-QFuo.js}

@@ -29,7 +29,6 @@ const COMMON_ARGS = {
 };
 //#endregion
 //#region ../resources/locales/en-US.json
-var NEGATABLE = "Negatable of";
 var en_US_default = {
 	COMMAND: "COMMAND",
 	COMMANDS: "COMMANDS",
@@ -39,7 +38,7 @@ var en_US_default = {
 	OPTIONS: "OPTIONS",
 	EXAMPLES: "EXAMPLES",
 	FORMORE: "For more info, run any command with the `--help` flag",
-	NEGATABLE,
+	NEGATABLE: "Negatable of",
 	DEFAULT: "default",
 	CHOICES: "choices",
 	help: "Display this help message",
@@ -172,7 +171,7 @@ function localizable(ctx, cmd, translate) {
 			}
 			const schema = ctx.args[argKey];
 			if (!schema) return argKey;
-			return negatable && schema.type === "boolean" && schema.negatable ? `${NEGATABLE} ${makeShortLongOptionPair(schema, argKey, ctx.toKebab)}` : schema.description || "";
+			return negatable && schema.type === "boolean" && schema.negatable ? `${en_US_default["NEGATABLE"]} ${makeShortLongOptionPair(schema, argKey, ctx.toKebab)}` : schema.description || "";
 		}
 		if (key === resolveKey("description", ctx.name)) return "";
 		else if (key === resolveKey("examples", ctx.name)) return await resolveExamples$1(ctx, cmd.examples);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.35.3",
+  "version": "0.37.0",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -116,11 +116,11 @@
     "std-env": "^4.1.0",
     "tsdown": "0.21.0",
     "zod": "^4.4.3",
-    "@gunshi/plugin-global": "0.35.3",
-    "@gunshi/resources": "0.35.3",
-    "@gunshi/plugin-i18n": "0.35.3",
-    "@gunshi/plugin-renderer": "0.35.3",
-    "@gunshi/shared": "0.35.3"
+    "@gunshi/plugin-global": "0.37.0",
+    "@gunshi/resources": "0.37.0",
+    "@gunshi/plugin-i18n": "0.37.0",
+    "@gunshi/plugin-renderer": "0.37.0",
+    "@gunshi/shared": "0.37.0"
   },
   "scripts": {
     "build": "tsdown",