@vlandoss/run-run 0.3.0 → 0.3.1-git-f19fe37.0

package/README.md

@@ -18,19 +18,42 @@ CLI toolbox to fullstack common scripts in Variable Land 👊
 pnpm add @vlandoss/run-run
 ```
 
-It will adds the `rr` and `run-run` command to your project
+It adds the `rr` command to your project.
 
 ## Usage
 
-> [!NOTE]
-> The documentation is WIP
-
 Run the help command:
 
 ```sh
 rr help
 ```
 
+See [`CLI.md`](./CLI.md) for the full reference (auto-generated per release).
+
+## Shell completion
+
+`rr` ships a `completion` subcommand that prints a shell-specific script. Add it to your shell rc file:
+
+```sh
+# zsh — ~/.zshrc
+eval "$(rr completion zsh)"
+
+# bash — ~/.bashrc
+eval "$(rr completion bash)"
+
+# fish — ~/.config/fish/config.fish
+rr completion fish | source
+```
+
+**Prerequisite:** the [`usage`](https://usage.jdx.dev) CLI must be on your `PATH` (it powers completion at runtime). Install via one of:
+
+```sh
+mise use -g usage
+brew install usage
+```
+
+When you upgrade `@vlandoss/run-run`, the next shell session will pick up new commands automatically — no need to re-run anything.
+
 ## Troubleshooting
 
 To enable debug mode, set the `DEBUG` environment variable to `run-run:*` before running *any* command.

package/bin

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+set -e
+
+SOURCE="${BASH_SOURCE[0]}"
+while [ -L "$SOURCE" ]; do
+  TARGET="$(readlink "$SOURCE")"
+  case "$TARGET" in
+    /*) SOURCE="$TARGET" ;;
+    *) SOURCE="$(dirname "$SOURCE")/$TARGET" ;;
+  esac
+done
+DIR="$(cd "$(dirname "$SOURCE")" && pwd)"
+
+if [ "$1" = "completion" ]; then
+  case "$2" in
+    bash | zsh | fish)
+      kdl="$DIR/dist/cli.usage.kdl"
+      if [ ! -f "$kdl" ]; then
+        echo "rr completion: missing $kdl. Reinstall @vlandoss/run-run or run \`pnpm build\`." >&2
+        exit 1
+      fi
+      if ! command -v usage >/dev/null 2>&1; then
+        echo "rr completion: 'usage' CLI not found in PATH." >&2
+        echo "Install via: mise use -g usage  |  brew install usage" >&2
+        exit 1
+      fi
+      exec usage generate completion "$2" rr --file "$kdl"
+      ;;
+  esac
+  # Unknown shell or `--help`: fall through to Node so Commander prints help/errors.
+fi
+
+# In the source repo (tsdown.config.ts present, NOT shipped in the npm tarball),
+# always run from src/ so live edits show up. In a published install, use the
+# bundled dist/run.mjs.
+if [ -f "$DIR/tsdown.config.ts" ]; then
+  exec node "$DIR/src/run.ts" "$@"
+else
+  exec node "$DIR/dist/run.mjs" "$@"
+fi

package/dist/cli.usage.kdl

@@ -0,0 +1,71 @@
+// @generated by @usage-spec/commander from Commander.js metadata
+name rr
+bin rr
+version "0.3.1-git-f19fe37.0"
+usage "[options] <command...>"
+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 build:lib help="build a ts library 🏗️ (tsdown)" {
+	long_help "Compiles TypeScript code into JavaScript and generates type declaration files, making it ready for distribution."
+	cmd doctor help="check if the underlying tool is working correctly"
+}
+cmd jsc help="check format and lint 🔍 (biome)" {
+	alias jscheck check
+	long_help "Checks the code for formatting and linting issues, ensuring it adheres to the defined style and quality standards."
+	flag --fix help="try to fix issues automatically"
+	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 🧩 (tsc)" {
+	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."
+	cmd doctor help="check if the underlying tool is working correctly"
+}
+cmd lint help="check & fix lint errors 🔍 (biome)" {
+	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 🎨 (biome)" {
+	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 test:static help="run static tests 🔬 (run-run)" {
+	long_help "Runs static tests, including linting, formatting checks, and TypeScript type checking, to ensure code quality and correctness without executing the code."
+}
+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 pkgs help="list affected packages 📦" {
+	long_help "Given a list of files, returns the list of affected packages. Useful to run commands only on affected packages."
+	flag --files help="list of files to check" var=#true {
+		arg <FILES>
+	}
+	flag --decorator help="type of decorator to use" {
+		arg <DECORATOR> {
+			choices turbo
+		}
+	}
+}
+cmd x help="run multiple rr subcommands concurrently" {
+	long_help "Run multiple rr subcommands concurrently (e.g. `rr x jsc tsc`)."
+	arg <cmds>… help="rr subcommands to execute concurrently" var=#true
+}
+cmd config help="display the current config 🛠️" {
+	long_help "Displays the current configuration settings, including their source file path if available."
+}
+cmd tools hide=#true subcommand_required=#true help="expose the internal tools 🛠️" {
+	cmd biome
+	cmd oxfmt
+	cmd oxlint
+	cmd tsdown
+}

package/dist/run.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 import path from "node:path";
 import { colorIsSupported, colorize, createPkgService, createShellService, cwd, dirnameOf, getVersion, palette, run } from "@vlandoss/clibuddy";
-import { Option, createCommand } from "commander";
+import { Argument, Option, createCommand } from "commander";
 import fs from "node:fs";
 import os from "node:os";
 import { lilconfig } from "lilconfig";
@@ -10,6 +10,7 @@ import memoize from "memoize";
 import { glob } from "glob";
 import { rimraf } from "rimraf";
 import isCI from "is-ci";
+import { generateToStdout } from "@usage-spec/commander";
 //#region \0rolldown/runtime.js
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
@@ -95,6 +96,7 @@ const oxfmtColor = colorize("#32F3E9");
 const tscColor = colorize("#3178C6");
 const rimrafColor = colorize("#7C7270");
 const runRunColor = colorize("FC7A1E");
+const usageColor = colorize("#24C55E");
 const TOOL_LABELS = {
 	TSDOWN: tsdownColor("tsdown"),
 	BIOME: biomeColor("biome"),
@@ -102,7 +104,8 @@ const TOOL_LABELS = {
 	OXFMT: oxfmtColor("oxfmt"),
 	TSC: tscColor("tsc"),
 	RIMRAF: rimrafColor("rimraf"),
-	RUN_RUN: runRunColor("run-run")
+	RUN_RUN: runRunColor("run-run"),
+	USAGE: usageColor("usage")
 };
 function getBannerText(version) {
 	const uiLogo = `🦊 ${palette.bold("R")} ${palette.bold("U")} ${palette.bold("N")} - ${palette.bold("R")} ${palette.bold("U")} ${palette.bold("N")}`;
@@ -342,6 +345,21 @@ function createCleanCommand() {
 	}).addHelpText("afterAll", `\nUnder the hood, this command uses ${TOOL_LABELS.RIMRAF} to delete dirty folders or files.`);
 }
 //#endregion
+//#region src/program/commands/completion.ts
+const SHELLS = [
+	"bash",
+	"zsh",
+	"fish"
+];
+function createCompletionCommand() {
+	return createCommand("completion").summary(`print shell completion script 🐚 (${TOOL_LABELS.USAGE})`).description(`Prints a shell completion script for rr. Add to your shell 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 ${TOOL_LABELS.USAGE} (https://usage.jdx.dev).
+Make sure to have it installed and available in your PATH.`);
+}
+//#endregion
 //#region src/program/commands/config.ts
 function createConfigCommand(ctx) {
 	return createCommand("config").summary("display the current config 🛠️").description("Displays the current configuration settings, including their source file path if available.").action(async function configAction() {
@@ -489,19 +507,10 @@ function createPkgsCommand(ctx) {
 	});
 }
 //#endregion
-//#region src/program/commands/run.ts
-function createRunCommand(ctx) {
-	return createCommand("run").argument("<cmds...>", "commands to execute concurrently (e.g. 'check tsc')").action(async function runRunAction(cmds) {
-		const { $ } = ctx.shell;
-		const commands = cmds.map((cmd) => $`rr ${cmd}`);
-		await Promise.all(commands);
-	});
-}
-//#endregion
 //#region src/program/commands/test-static.ts
 function createTestStaticCommand(ctx) {
 	return createCommand("test:static").summary(`run static tests 🔬 (${TOOL_LABELS.RUN_RUN})`).description("Runs static tests, including linting, formatting checks, and TypeScript type checking, to ensure code quality and correctness without executing the code.").action(async function testStaticAction() {
-		await ctx.shell.$`rr jscheck tscheck`;
+		await ctx.shell.$`rr x jscheck tscheck`;
 	});
 }
 //#endregion
@@ -603,35 +612,37 @@ function createTsCheckCommand(ctx) {
 	});
 }
 //#endregion
+//#region src/program/commands/usage.ts
+function addUsage(program) {
+	return program.addOption(new Option("--usage", "print KDL spec for this CLI (https://kdl.dev)")).on("option:usage", () => {
+		generateToStdout(program);
+		process.exit(0);
+	});
+}
+//#endregion
+//#region src/program/commands/x.ts
+function createXCommand(ctx) {
+	return createCommand("x").summary("run multiple rr subcommands concurrently").description("Run multiple rr subcommands concurrently (e.g. `rr x jsc tsc`).").argument("<cmds...>", "rr subcommands to execute concurrently").action(async function runXAction(cmds) {
+		const { $ } = ctx.shell;
+		if ((await Promise.allSettled(cmds.map((cmd) => $`rr ${cmd}`))).some((r) => r.status === "rejected")) process.exitCode = 1;
+	});
+}
+//#endregion
 //#region src/program/index.ts
 async function createProgram(options) {
 	const ctx = await createContext(options.binDir);
 	const version = getVersion(ctx.binPkg);
 	return {
-		program: createCommand("rr").alias("run-run").usage("[options] <command...>").helpCommand(false).version(version, "-v, --version").addHelpText("before", getBannerText(version)).addHelpText("after", CREDITS_TEXT).addCommand(createBuildLibCommand(ctx)).addCommand(createJsCheckCommand(ctx)).addCommand(createTsCheckCommand(ctx)).addCommand(createLintCommand(ctx)).addCommand(createFormatCommand(ctx)).addCommand(createTestStaticCommand(ctx)).addCommand(createCleanCommand()).addCommand(createPkgsCommand(ctx)).addCommand(createConfigCommand(ctx)).addCommand(createRunCommand(ctx), { hidden: true }).addCommand(createToolsCommand(ctx), { hidden: true }),
+		program: addUsage(createCommand("rr").usage("[options] <command...>").version(version, "-v, --version").addHelpText("before", getBannerText(version)).addHelpText("after", CREDITS_TEXT).addCommand(createCompletionCommand()).addCommand(createBuildLibCommand(ctx)).addCommand(createJsCheckCommand(ctx)).addCommand(createTsCheckCommand(ctx)).addCommand(createLintCommand(ctx)).addCommand(createFormatCommand(ctx)).addCommand(createTestStaticCommand(ctx)).addCommand(createCleanCommand()).addCommand(createPkgsCommand(ctx)).addCommand(createXCommand(ctx)).addCommand(createConfigCommand(ctx)).addCommand(createToolsCommand(ctx), { hidden: true })),
 		ctx
 	};
 }
 //#endregion
-//#region src/program/parse-args.ts
-const debug = logger.subdebug("parseArgs");
-function parseArgs(argv = process.argv) {
-	const args = argv.slice(2);
-	const lastArg = args[args.length - 1];
-	const allArgsAreValidCommands = args.every((arg) => !arg.startsWith("-")) && args.length > 1 && args[0] !== "tools" && lastArg !== "doctor";
-	debug("args %O", args);
-	if (allArgsAreValidCommands) {
-		debug("multiple commands detected, adding 'run' command");
-		return ["run", ...args];
-	}
-	return args;
-}
-//#endregion
 //#region src/run.ts
 const BIN_DIR = path.dirname(dirnameOf(import.meta));
 await run(async () => {
 	const { program } = await createProgram({ binDir: BIN_DIR });
-	await program.parseAsync(parseArgs(), { from: "user" });
+	await program.parseAsync(process.argv, { from: "node" });
 }, logger);
 //#endregion
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vlandoss/run-run",
-  "version": "0.3.0",
+  "version": "0.3.1-git-f19fe37.0",
   "description": "The CLI toolbox to fullstack common scripts in Variable Land",
   "homepage": "https://github.com/variableland/dx/tree/main/packages/run-run#readme",
   "bugs": {
@@ -29,15 +29,14 @@
     }
   },
   "bin": {
-    "rr": "./bin.mjs",
-    "run-run": "./bin.mjs",
+    "rr": "./bin",
     "biome": "./tools/biome",
     "oxfmt": "./tools/oxfmt",
     "oxlint": "./tools/oxlint",
     "tsdown": "./tools/tsdown"
   },
   "files": [
-    "bin.mjs",
+    "bin",
     "dist",
     "src",
     "!src/**/__tests__",
@@ -45,8 +44,15 @@
     "tools",
     "tsconfig.json"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "dependencies": {
     "@biomejs/biome": "2.4.4",
+    "@usage-spec/commander": "1.1.0",
     "commander": "14.0.3",
     "glob": "13.0.6",
     "is-ci": "4.1.0",
@@ -61,17 +67,12 @@
     "@vlandoss/clibuddy": "0.3.0",
     "@vlandoss/loggy": "0.2.0"
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
   "devDependencies": {
     "@vlandoss/tsdown-config": "^0.0.1"
   },
   "scripts": {
-    "build": "tsdown",
+    "build": "tsdown && pnpm build:kdl",
+    "build:kdl": "./bin --usage > dist/cli.usage.kdl",
     "test": "vitest run",
     "test:unit": "vitest run --project unit",
     "test:integration": "vitest run --project integration",

package/src/program/commands/completion.ts

@@ -0,0 +1,26 @@
+import { Argument, createCommand } from "commander";
+import { TOOL_LABELS } from "../ui.ts";
+
+const SHELLS = ["bash", "zsh", "fish"] as const;
+
+// Ghost command: registered with Commander purely for discoverability — it surfaces
+// in `rr --help` and is baked into dist/cli.usage.kdl so the completion itself can
+// suggest "completion" after `rr <TAB>`. The actual handler lives in the bash bin
+// dispatcher, which intercepts `rr completion <shell>` before reaching Node.
+export function createCompletionCommand() {
+  return createCommand("completion")
+    .summary(`print shell completion script 🐚 (${TOOL_LABELS.USAGE})`)
+    .description(
+      `Prints a shell completion script for rr. Add to your shell 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 ${TOOL_LABELS.USAGE} (https://usage.jdx.dev).
+Make sure to have it installed and available in your PATH.`,
+    );
+}

package/src/program/commands/test-static.ts

@@ -9,6 +9,6 @@ export function createTestStaticCommand(ctx: Context) {
       "Runs static tests, including linting, formatting checks, and TypeScript type checking, to ensure code quality and correctness without executing the code.",
     )
     .action(async function testStaticAction() {
-      await ctx.shell.$`rr jscheck tscheck`;
+      await ctx.shell.$`rr x jscheck tscheck`;
     });
 }

package/src/program/commands/usage.ts

@@ -0,0 +1,9 @@
+import { generateToStdout } from "@usage-spec/commander";
+import { type Command, Option } from "commander";
+
+export function addUsage(program: Command) {
+  return program.addOption(new Option("--usage", "print KDL spec for this CLI (https://kdl.dev)")).on("option:usage", () => {
+    generateToStdout(program);
+    process.exit(0);
+  });
+}

package/src/program/commands/x.ts

@@ -0,0 +1,16 @@
+import { createCommand } from "commander";
+import type { Context } from "#src/services/ctx.ts";
+
+export function createXCommand(ctx: Context) {
+  return createCommand("x")
+    .summary("run multiple rr subcommands concurrently")
+    .description("Run multiple rr subcommands concurrently (e.g. `rr x jsc tsc`).")
+    .argument("<cmds...>", "rr subcommands to execute concurrently")
+    .action(async function runXAction(cmds: string[]) {
+      const { $ } = ctx.shell;
+      const results = await Promise.allSettled(cmds.map((cmd) => $`rr ${cmd}`));
+      if (results.some((r) => r.status === "rejected")) {
+        process.exitCode = 1;
+      }
+    });
+}

package/src/program/index.ts

@@ -3,15 +3,17 @@ import { createCommand } from "commander";
 import { createContext } from "#src/services/ctx.ts";
 import { createBuildLibCommand } from "./commands/build-lib.ts";
 import { createCleanCommand } from "./commands/clean.ts";
+import { createCompletionCommand } from "./commands/completion.ts";
 import { createConfigCommand } from "./commands/config.ts";
 import { createFormatCommand } from "./commands/format.ts";
 import { createJsCheckCommand } from "./commands/jscheck.ts";
 import { createLintCommand } from "./commands/lint.ts";
 import { createPkgsCommand } from "./commands/pkgs.ts";
-import { createRunCommand } from "./commands/run.ts";
 import { createTestStaticCommand } from "./commands/test-static.ts";
 import { createToolsCommand } from "./commands/tools.ts";
 import { createTsCheckCommand } from "./commands/tscheck.ts";
+import { addUsage } from "./commands/usage.ts";
+import { createXCommand } from "./commands/x.ts";
 import { CREDITS_TEXT, getBannerText } from "./ui.ts";
 
 export type Options = {
@@ -22,30 +24,32 @@ export async function createProgram(options: Options) {
   const ctx = await createContext(options.binDir);
   const version = getVersion(ctx.binPkg);
 
-  const program = createCommand("rr")
-    .alias("run-run")
-    .usage("[options] <command...>")
-    .helpCommand(false)
-    .version(version, "-v, --version")
-    .addHelpText("before", getBannerText(version))
-    .addHelpText("after", CREDITS_TEXT)
-    // build
-    .addCommand(createBuildLibCommand(ctx))
-    // check
-    .addCommand(createJsCheckCommand(ctx))
-    .addCommand(createTsCheckCommand(ctx))
-    .addCommand(createLintCommand(ctx))
-    .addCommand(createFormatCommand(ctx))
-    // test
-    .addCommand(createTestStaticCommand(ctx))
-    // misc
-    .addCommand(createCleanCommand())
-    .addCommand(createPkgsCommand(ctx))
-    // config
-    .addCommand(createConfigCommand(ctx))
-    // hidden
-    .addCommand(createRunCommand(ctx), { hidden: true })
-    .addCommand(createToolsCommand(ctx), { hidden: true });
+  const program = addUsage(
+    createCommand("rr")
+      .usage("[options] <command...>")
+      .version(version, "-v, --version")
+      .addHelpText("before", getBannerText(version))
+      .addHelpText("after", CREDITS_TEXT)
+      // completion
+      .addCommand(createCompletionCommand())
+      // build
+      .addCommand(createBuildLibCommand(ctx))
+      // check
+      .addCommand(createJsCheckCommand(ctx))
+      .addCommand(createTsCheckCommand(ctx))
+      .addCommand(createLintCommand(ctx))
+      .addCommand(createFormatCommand(ctx))
+      // test
+      .addCommand(createTestStaticCommand(ctx))
+      // misc
+      .addCommand(createCleanCommand())
+      .addCommand(createPkgsCommand(ctx))
+      .addCommand(createXCommand(ctx))
+      // config
+      .addCommand(createConfigCommand(ctx))
+      // hidden
+      .addCommand(createToolsCommand(ctx), { hidden: true }),
+  );
 
   return { program, ctx };
 }

package/src/program/ui.ts

@@ -14,6 +14,7 @@ const oxfmtColor = colorize("#32F3E9");
 const tscColor = colorize("#3178C6");
 const rimrafColor = colorize("#7C7270");
 const runRunColor = colorize("FC7A1E");
+const usageColor = colorize("#24C55E");
 
 export const TOOL_LABELS = {
   TSDOWN: tsdownColor("tsdown"),
@@ -23,6 +24,7 @@ export const TOOL_LABELS = {
   TSC: tscColor("tsc"),
   RIMRAF: rimrafColor("rimraf"),
   RUN_RUN: runRunColor("run-run"),
+  USAGE: usageColor("usage"),
 };
 
 export function getBannerText(version: string) {

package/src/run.ts

@@ -1,12 +1,11 @@
 import path from "node:path";
 import { dirnameOf, run } from "@vlandoss/clibuddy";
 import { createProgram } from "./program/index.ts";
-import { parseArgs } from "./program/parse-args.ts";
 import { logger } from "./services/logger.ts";
 
 const BIN_DIR = path.dirname(dirnameOf(import.meta));
 
 await run(async () => {
   const { program } = await createProgram({ binDir: BIN_DIR });
-  await program.parseAsync(parseArgs(), { from: "user" });
+  await program.parseAsync(process.argv, { from: "node" });
 }, logger);

package/bin.mjs

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import "./dist/run.mjs";

package/src/program/commands/run.ts

@@ -1,12 +0,0 @@
-import { createCommand } from "commander";
-import type { Context } from "#src/services/ctx.ts";
-
-export function createRunCommand(ctx: Context) {
-  return createCommand("run")
-    .argument("<cmds...>", "commands to execute concurrently (e.g. 'check tsc')")
-    .action(async function runRunAction(cmds: string[]) {
-      const { $ } = ctx.shell;
-      const commands = cmds.map((cmd) => $`rr ${cmd}`);
-      await Promise.all(commands);
-    });
-}

package/src/program/parse-args.ts

@@ -1,19 +0,0 @@
-import { logger } from "../services/logger.ts";
-
-const debug = logger.subdebug("parseArgs");
-
-export function parseArgs(argv = process.argv) {
-  const args = argv.slice(2);
-  const lastArg = args[args.length - 1];
-  const allArgsAreValidCommands =
-    args.every((arg) => !arg.startsWith("-")) && args.length > 1 && args[0] !== "tools" && lastArg !== "doctor";
-
-  debug("args %O", args);
-
-  if (allArgsAreValidCommands) {
-    debug("multiple commands detected, adding 'run' command");
-    return ["run", ...args];
-  }
-
-  return args;
-}