@rrlab/cli 1.1.0 → 1.2.0

package/README.md

@@ -6,15 +6,6 @@ CLI toolbox to fullstack common scripts in [Variable Land](https://variable.land
 
 - Node.js >= 20.0.0
 
-## Toolbox
-
-- [biome](https://biomejs.dev)
-- [tsc](https://www.typescriptlang.org)
-- [rimraf](https://www.npmjs.com/package/rimraf)
-- [oxfmt](https://oxc.rs/docs/guide/usage/formatter.html)
-- [oxlint](https://oxc.rs/docs/guide/usage/linter.html)
-- [tsdown](https://tsdown.dev)
-
 ## Installation
 
 ```sh
@@ -37,7 +28,16 @@ See [`CLI.md`](./CLI.md) for the full reference (auto-generated per release).
 
 ## Plugins
 
-`rr` is a microkernel: every tool (Biome, TypeScript, tsdown, …) lives in its own `@rrlab/<tool>-plugin` package. Install one with:
+`rr` is a microkernel: every tool lives in its own `@rrlab/<tool>-plugin` package. The official plugins are:
+
+| Plugin   | Wraps                                                                                                          | Install                  |
+| -------- | -------------------------------------------------------------------------------------------------------------- | ------------------------ |
+| `biome`  | [Biome](https://biomejs.dev)                                                                                   | `rr plugins add biome`   |
+| `oxc`    | [oxlint](https://oxc.rs/docs/guide/usage/linter.html) + [oxfmt](https://oxc.rs/docs/guide/usage/formatter.html) | `rr plugins add oxc`     |
+| `ts`     | [tsc](https://www.typescriptlang.org)                                                                          | `rr plugins add ts`      |
+| `tsdown` | [tsdown](https://tsdown.dev)                                                                                   | `rr plugins add tsdown`  |
+
+Install one with:
 
 ```sh
 rr plugins add biome

package/bin

@@ -32,14 +32,12 @@ fi
 
 # `--usage` emits a KDL spec for downstream parsers (e.g. `usage generate
 # completion`). Force NO_COLOR so command summaries don't leak ANSI escapes
-# into the spec — colors are presentation, KDL is data. Also set
-# RR_USAGE_MODE so per-environment annotations (e.g. the active plugin
-# next to each command) are stripped from the spec — the KDL must be
-# stable across machines.
+# into the spec — colors are presentation, KDL is data. Command summaries are
+# static (no per-environment plugin annotations), so the spec is already stable
+# across machines.
 for arg in "$@"; do
   if [ "$arg" = "--usage" ]; then
     export NO_COLOR=1
-    export RR_USAGE_MODE=1
     break
   fi
 done

package/dist/cli.usage.kdl

@@ -1,18 +1,12 @@
 // @generated by @usage-spec/commander from Commander.js metadata
 name rr
 bin rr
-version "1.1.0"
-usage "<command...> [options...]"
+version "1.2.0"
+usage "[options] [command]"
+flag --about help="show credits & inspiration"
 flag --usage help="print KDL spec for this CLI (https://kdl.dev)"
-cmd completion help="print shell completion script (usage)" {
-	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"
-	arg <shell> help="target shell" {
-		choices bash zsh fish
-	}
-}
-cmd pack help="pack a ts library" {
-	long_help "Compiles TypeScript code into JavaScript and generates type declaration files, packaging the library for distribution."
-	cmd doctor help="check if the underlying tool is working correctly"
+cmd check help="run static checks" {
+	long_help "Runs `rr jsc` then `rr tsc` in-process, each as its own section. Aggregates their exit codes — non-zero when either subcommand fails."
 }
 cmd jsc help="check format and lint" {
 	alias jscheck
@@ -21,49 +15,56 @@ cmd jsc help="check format and lint" {
 	flag --fix-staged help="try to fix staged files only"
 	cmd doctor help="check if the underlying tool is working correctly"
 }
-cmd tsc help="check typescript errors" {
+cmd tsc help="check types errors" {
 	alias tscheck
-	long_help "Checks the TypeScript code for type errors, ensuring that the code adheres to the defined type constraints and helps catch potential issues before runtime."
+	long_help "Checks type errors, ensuring that the code adheres to the defined type constraints and helps catch potential issues before runtime."
 	cmd doctor help="check if the underlying tool is working correctly"
 }
-cmd lint help="check & fix lint errors" {
+cmd lint help="check & fix lint issues" {
 	long_help "Checks the code for linting issues and optionally fixes them, ensuring it adheres to the defined quality standards."
 	flag "-c --check" help="check if the code is valid" default=#true
 	flag --fix help="try to fix all the code"
 	cmd doctor help="check if the underlying tool is working correctly"
 }
-cmd format help="check & fix format errors" {
+cmd format help="check & fix format issues" {
 	long_help "Checks the code for formatting issues and optionally fixes them, ensuring it adheres to the defined style standards."
 	flag --fix help="format all the code"
 	cmd doctor help="check if the underlying tool is working correctly"
 }
-cmd check help="run static checks" {
-	long_help "Runs `rr jsc` then `rr tsc` in-process, each as its own section. Aggregates their exit codes — non-zero when either subcommand fails."
+cmd pack help="pack a ts library" {
+	long_help "Compiles TypeScript code into JavaScript and generates type declaration files, packaging the library for distribution."
+	cmd doctor help="check if the underlying tool is working correctly"
+}
+cmd clean help="delete dirty files" {
+	long_help "Deletes generated files and folders such as 'dist', 'node_modules', and lock files to ensure a clean state."
+	flag --only-dist help="delete 'dist' folders only"
+	flag --dry-run help="outputs the paths that would be deleted"
 }
 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"
+	arg <shell> help="target shell" {
+		choices bash zsh fish
+	}
+}
 cmd plugins subcommand_required=#true help="manage @rrlab plugins" {
 	cmd list help="list plugins configured in run-run.config.{ts,mts}"
 	cmd add help="install and configure an @rrlab plugin" {
 		flag --force help="re-run install even if the plugin is already configured"
 		flag --yes help="skip prompts and use defaults (non-interactive)"
 		flag --dry-run help="show what would happen, without applying changes"
-		arg <name> help="plugin alias (ts|eslint|biome|oxc|tsdown), optionally with @<spec> e.g. biome@pr-226"
+		arg <name> help="plugin alias (ts|biome|oxc|tsdown), optionally with @<spec> e.g. biome@pr-226"
 	}
 	cmd remove help="uninstall an @rrlab plugin and undo its config files + deps" {
 		flag --yes help="skip the confirmation prompt"
 		flag --dry-run help="print the plan without applying changes"
 		arg <name> help="plugin alias to remove" {
-			choices ts eslint biome oxc tsdown
+			choices ts biome oxc tsdown
 		}
 	}
 }
-cmd clean help="delete dirty files (rimraf)" {
-	long_help "Deletes generated files and folders such as 'dist', 'node_modules', and lock files to ensure a clean state."
-	flag --only-dist help="delete 'dist' folders only"
-	flag --dry-run help="outputs the paths that would be deleted"
-}
 cmd config help="display the current config" {
-	long_help "Displays the current configuration settings, including their source file path if available."
+	long_help "Displays the current configuration settings, including their source file path and the plugins it registers."
 }

package/dist/config.d.mts

@@ -1,4 +1,4 @@
-import { u as Plugin } from "./types-snfbujDH.mjs";
+import { c as Plugin } from "./types-Iu4IyWof.mjs";
 
 //#region src/types/config.d.ts
 type UserConfig = {