@rrlab/cli 1.3.4 → 1.3.5

package/README.md

@@ -79,19 +79,23 @@ _.path = ["{{config_root}}/node_modules/.bin"]
 PATH_add node_modules/.bin
 ```
 
-Then add a guarded eval to your shell rc — the guard makes it a no-op when you open a shell outside any project:
+Then add a guarded eval to your shell rc:
 
 ```sh
 # zsh — ~/.zshrc
-command -v rr >/dev/null 2>&1 && eval "$(rr completion zsh)"
+command -v rr >/dev/null 2>&1 && eval "$(rr completion zsh 2>/dev/null)"
 
 # bash — ~/.bashrc
-command -v rr >/dev/null 2>&1 && eval "$(rr completion bash)"
+command -v rr >/dev/null 2>&1 && eval "$(rr completion bash 2>/dev/null)"
 
 # fish — ~/.config/fish/config.fish
-command -v rr >/dev/null 2>&1; and rr completion fish | source
+command -v rr >/dev/null 2>&1; and rr completion fish 2>/dev/null | source
 ```
 
+The `command -v` guard skips the line when no `rr` is on `PATH`. A mise shim still passes it: recent versions of mise keep `~/.local/share/mise/shims` on `PATH` after `mise activate`, even outside any project (the `activate_shims` setting, on by default). Once mise has installed a tool that provides `rr`, such as `npm:@rrlab/cli` in some project's `mise.toml`, an `rr` shim exists in every directory, and where no version is active it fails with `mise ERROR No version is set for shim: rr` on stderr. The `2>/dev/null` discards that error, so the line stays silent outside a project.
+
+The line hides every error, so if completion doesn't load, run `rr completion zsh` by hand to see why.
+
 ### Option B — without a per-project PATH manager
 
 Cache the completion script once, then source the cached file from your shell rc. Run the generation step from inside a project that has `@rrlab/cli` installed:

package/dist/cli.usage.kdl

@@ -1,7 +1,7 @@
 // @generated by @usage-spec/commander from Commander.js metadata
 name rr
 bin rr
-version "1.3.4"
+version "1.3.5"
 usage "[options] [command]"
 flag --about help="show credits & inspiration"
 flag --usage help="print KDL spec for this CLI (https://kdl.dev)"
@@ -52,7 +52,7 @@ cmd doctor help="run all plugin doctors" {
 	long_help "Runs the `doctor()` of every configured plugin capability. Each plugin reports ok / not working. The exit code is non-zero if any reports not working."
 }
 cmd completion help="print shell completion script" {
-	long_help "Prints a shell completion script for rr. Add to your shell rc file:\n\n  bash: eval \"$(rr completion bash)\"\n  zsh:  eval \"$(rr completion zsh)\"\n  fish: rr completion fish | source"
+	long_help "Prints a shell completion script for rr. Add your shell's line to its rc file:\n\n    # bash — ~/.bashrc\n    command -v rr >/dev/null 2>&1 && eval \"$(rr completion bash 2>/dev/null)\"\n\n    # zsh — ~/.zshrc\n    command -v rr >/dev/null 2>&1 && eval \"$(rr completion zsh 2>/dev/null)\"\n\n    # fish — ~/.config/fish/config.fish\n    command -v rr >/dev/null 2>&1; and rr completion fish 2>/dev/null | source"
 	arg <shell> help="target shell" {
 		choices bash zsh fish
 	}

package/dist/plugin/__tests__/bin-probe.test.mjs

@@ -1,6 +1,6 @@
 import { ToolService } from "../tool-service.mjs";
 import { probeBins } from "../bin-probe.mjs";
-import { i as it, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-CipsEAq5.mjs";
+import { i as it, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-h0bAJWRJ.mjs";
 //#region src/lib/plugin/__tests__/bin-probe.test.ts
 const FROM = import.meta.url;
 var ResolvableService = class extends ToolService {

package/dist/plugin/__tests__/decide-scaffold.test.mjs

@@ -1,5 +1,5 @@
 import { decideScaffold } from "../decide-scaffold.mjs";
-import { i as it, n as vi, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-CipsEAq5.mjs";
+import { i as it, n as vi, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-h0bAJWRJ.mjs";
 //#region src/lib/plugin/__tests__/decide-scaffold.test.ts
 function makeCtx(overrides = {}) {
 	return {

package/dist/plugin/__tests__/define-plugin.test.mjs

@@ -1,6 +1,6 @@
 import { ToolService } from "../tool-service.mjs";
 import { definePlugin } from "../define-plugin.mjs";
-import { i as it, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-CipsEAq5.mjs";
+import { i as it, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-h0bAJWRJ.mjs";
 //#region src/lib/plugin/__tests__/define-plugin.test.ts
 function ctx() {
 	return {

package/dist/plugin/__tests__/pick-preset.test.mjs

@@ -1,5 +1,5 @@
 import { pickPreset } from "../pick-preset.mjs";
-import { i as it, n as vi, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-CipsEAq5.mjs";
+import { i as it, n as vi, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-h0bAJWRJ.mjs";
 //#region src/lib/plugin/__tests__/pick-preset.test.ts
 function makeCtx(overrides = {}) {
 	return {

package/dist/plugin/__tests__/registry.test.mjs

@@ -1,5 +1,5 @@
 import { t as PluginRegistry } from "../../registry-B-GhzVIO.mjs";
-import { i as it, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-CipsEAq5.mjs";
+import { i as it, r as describe, t as globalExpect } from "../../test.DNmyFkvJ-h0bAJWRJ.mjs";
 //#region src/lib/plugin/__tests__/registry.test.ts
 function plugin(name) {
 	return {

package/dist/run.mjs

@@ -622,11 +622,16 @@ const SHELLS = [
 ];
 const usageColor = colorize("#24C55E");
 function createCompletionCommand() {
-	return createCommand("completion").summary(`print shell completion script`).description(`Prints a shell completion script for rr. Add to your shell rc file:
+	return createCommand("completion").summary(`print shell completion script`).description(`Prints a shell completion script for rr. Add your shell's line to its rc file:
 
-  bash: eval "$(rr completion bash)"
-  zsh:  eval "$(rr completion zsh)"
-  fish: rr completion fish | source`).addArgument(new Argument("<shell>", `target shell`).choices(SHELLS)).addHelpText("afterAll", `\nUnder the hood, this command uses ${usageColor("usage")} (https://usage.jdx.dev).
+    # bash — ~/.bashrc
+    command -v rr >/dev/null 2>&1 && eval "$(rr completion bash 2>/dev/null)"
+
+    # zsh — ~/.zshrc
+    command -v rr >/dev/null 2>&1 && eval "$(rr completion zsh 2>/dev/null)"
+
+    # fish — ~/.config/fish/config.fish
+    command -v rr >/dev/null 2>&1; and rr completion fish 2>/dev/null | source`).configureHelp({ helpWidth: Number.POSITIVE_INFINITY }).addArgument(new Argument("<shell>", `target shell`).choices(SHELLS)).addHelpText("afterAll", `\nUnder the hood, this command uses ${usageColor("usage")} (https://usage.jdx.dev).
 Make sure to have it installed and available in your PATH.`);
 }
 //#endregion

package/dist/{test.DNmyFkvJ-CipsEAq5.mjs → test.DNmyFkvJ-h0bAJWRJ.mjs}

@@ -5092,7 +5092,7 @@ function manageArtifactAttachment(attachment) {
 	if (attachment.body != null) attachment.bodyEncoding ??= "base64";
 }
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@4.1.6_@types+node@25.9.1_vite@8.0.13_@types+node@25.9.1_yaml@2.8.4_/node_modules/vitest/dist/chunks/utils.BX5Fg8C4.js
+//#region ../../node_modules/.pnpm/vitest@4.1.6_@types+node@25.9.1_vite@8.0.13_@types+node@25.9.1_yaml@2.9.1_/node_modules/vitest/dist/chunks/utils.BX5Fg8C4.js
 const NAME_WORKER_STATE = "__vitest_worker__";
 function getWorkerState() {
 	const workerState = globalThis[NAME_WORKER_STATE];
@@ -9971,10 +9971,10 @@ function offsetToLineNumber(source, offset) {
 	return line + 1;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@4.1.6_@types+node@25.9.1_vite@8.0.13_@types+node@25.9.1_yaml@2.8.4_/node_modules/vitest/dist/chunks/_commonjsHelpers.D26ty3Ew.js
+//#region ../../node_modules/.pnpm/vitest@4.1.6_@types+node@25.9.1_vite@8.0.13_@types+node@25.9.1_yaml@2.9.1_/node_modules/vitest/dist/chunks/_commonjsHelpers.D26ty3Ew.js
 var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@4.1.6_@types+node@25.9.1_vite@8.0.13_@types+node@25.9.1_yaml@2.8.4_/node_modules/vitest/dist/chunks/rpc.MzXet3jl.js
+//#region ../../node_modules/.pnpm/vitest@4.1.6_@types+node@25.9.1_vite@8.0.13_@types+node@25.9.1_yaml@2.9.1_/node_modules/vitest/dist/chunks/rpc.MzXet3jl.js
 const RealDate = Date;
 let now = null;
 var MockDate = class MockDate extends RealDate {
@@ -10937,7 +10937,7 @@ function raceWith(promise, other) {
 	}))]);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@4.1.6_@types+node@25.9.1_vite@8.0.13_@types+node@25.9.1_yaml@2.8.4_/node_modules/vitest/dist/chunks/test.DNmyFkvJ.js
+//#region ../../node_modules/.pnpm/vitest@4.1.6_@types+node@25.9.1_vite@8.0.13_@types+node@25.9.1_yaml@2.9.1_/node_modules/vitest/dist/chunks/test.DNmyFkvJ.js
 var fakeTimersSrc = {};
 var global$1;
 var hasRequiredGlobal;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rrlab/cli",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "The CLI toolbox to fullstack common scripts in Variable Land",
   "homepage": "https://github.com/withvariablelab/dx/tree/main/run-run/cli#readme",
   "bugs": {
@@ -57,8 +57,8 @@
     "memoize": "10.2.0",
     "nypm": "0.6.0",
     "rimraf": "6.1.3",
-    "@variablelab/clibuddy": "0.7.4",
-    "@variablelab/loggy": "0.2.3"
+    "@variablelab/loggy": "0.2.3",
+    "@variablelab/clibuddy": "0.7.4"
   },
   "devDependencies": {
     "tsdown": "0.22.0",

package/src/program/commands/completion.ts

@@ -13,12 +13,21 @@ export function createCompletionCommand() {
   return createCommand("completion")
     .summary(`print shell completion script`)
     .description(
-      `Prints a shell completion script for rr. Add to your shell rc file:
+      `Prints a shell completion script for rr. Add your shell's line to its rc file:
 
-  bash: eval "$(rr completion bash)"
-  zsh:  eval "$(rr completion zsh)"
-  fish: rr completion fish | source`,
+    # bash — ~/.bashrc
+    command -v rr >/dev/null 2>&1 && eval "$(rr completion bash 2>/dev/null)"
+
+    # zsh — ~/.zshrc
+    command -v rr >/dev/null 2>&1 && eval "$(rr completion zsh 2>/dev/null)"
+
+    # fish — ~/.config/fish/config.fish
+    command -v rr >/dev/null 2>&1; and rr completion fish 2>/dev/null | source`,
     )
+    .configureHelp({
+      // Commander hard-wraps help at the terminal width; a wrapped rc line breaks when pasted.
+      helpWidth: Number.POSITIVE_INFINITY,
+    })
     .addArgument(new Argument("<shell>", `target shell`).choices(SHELLS))
     .addHelpText(
       "afterAll",