@pristine-ts/cli 2.0.16 → 2.0.18

package/dist/lib/cjs/types/command-parameter-choices-list.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command-parameter-choices-list.type.js.map

package/dist/lib/cjs/types/command-parameter-choices-list.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parameter-choices-list.type.js","sourceRoot":"","sources":["../../../../src/types/command-parameter-choices-list.type.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/types/command-parameter-choices-resolver.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command-parameter-choices-resolver.type.js.map

package/dist/lib/cjs/types/command-parameter-choices-resolver.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parameter-choices-resolver.type.js","sourceRoot":"","sources":["../../../../src/types/command-parameter-choices-resolver.type.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/types/command-parameter-choices.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command-parameter-choices.type.js.map

package/dist/lib/cjs/types/command-parameter-choices.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parameter-choices.type.js","sourceRoot":"","sources":["../../../../src/types/command-parameter-choices.type.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/types/types.js

@@ -16,5 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./command-event.type"), exports);
 __exportStar(require("./command-event-response.type"), exports);
+__exportStar(require("./command-parameter-choices-list.type"), exports);
+__exportStar(require("./command-parameter-choices-resolver.type"), exports);
+__exportStar(require("./command-parameter-choices.type"), exports);
 __exportStar(require("./start-repl-event-response.type"), exports);
 //# sourceMappingURL=types.js.map

package/dist/lib/cjs/types/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,gEAA8C;AAC9C,mEAAiD"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,gEAA8C;AAC9C,wEAAsD;AACtD,4EAA0D;AAC1D,mEAAiD;AACjD,mEAAiD"}

package/dist/lib/esm/cli.configuration-keys.js

@@ -17,5 +17,11 @@ export const CliConfigurationKeys = {
      * input is not an interactive terminal, regardless of this value.
      */
     InteractiveParameters: "pristine.cli.interactiveParameters",
+    /**
+     * Explicit program name shown in generated `Usage:` lines (e.g. `myapp`). Optional: when unset,
+     * the CLI derives the name from `argv[1]`, falling back to `pristine`. Set it for launch shapes
+     * where `argv[1]` isn't the friendly name (e.g. `node dist/bin/cli.cjs`).
+     */
+    BinName: "pristine.cli.binName",
 };
 //# sourceMappingURL=cli.configuration-keys.js.map

package/dist/lib/esm/cli.configuration-keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.configuration-keys.js","sourceRoot":"","sources":["../../../src/cli.configuration-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;;;;;OAKG;IACH,qBAAqB,EAAE,oCAAoC;CACnD,CAAC"}
+{"version":3,"file":"cli.configuration-keys.js","sourceRoot":"","sources":["../../../src/cli.configuration-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;;;;;OAKG;IACH,qBAAqB,EAAE,oCAAoC;IAE3D;;;;OAIG;IACH,OAAO,EAAE,sBAAsB;CACvB,CAAC"}

package/dist/lib/esm/cli.module.js

@@ -44,6 +44,19 @@ export const CliModule = {
                 new BooleanResolver(new EnvironmentVariableResolver("PRISTINE_CLI_INTERACTIVE_PARAMETERS")),
             ],
         },
+        /**
+         * Program name shown in generated `Usage:` lines. Defaults to empty so `ProgramNameResolver`
+         * falls back to `basename(argv[1])` (then `pristine`); set it (here, in `pristine.config.ts`,
+         * or via the env var) to force a name.
+         */
+        {
+            parameterName: CliConfigurationKeys.BinName,
+            isRequired: false,
+            defaultValue: "",
+            defaultResolvers: [
+                new EnvironmentVariableResolver("PRISTINE_CLI_BIN_NAME"),
+            ],
+        },
     ],
     importModules: [
         CoreModule,

package/dist/lib/esm/cli.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.module.js","sourceRoot":"","sources":["../../../src/cli.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAC,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAC,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAC,iBAAiB,EAAC,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAC,eAAe,EAAE,2BAA2B,EAAC,MAAM,4BAA4B,CAAC;AACxF,OAAO,EAAC,oBAAoB,EAAC,MAAM,0BAA0B,CAAC;AAE9D,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAE9B,yFAAyF;AACzF,yFAAyF;AACzF,mFAAmF;AACnF,oFAAoF;AACpF,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,OAAO,EAAE,gBAAgB;IACzB,wBAAwB,EAAE;QACxB;;;;;WAKG;QACH;YACE,aAAa,EAAE,oBAAoB,CAAC,qBAAqB;YACzD,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;YAClB,gBAAgB,EAAE;gBAChB,IAAI,eAAe,CAAC,IAAI,2BAA2B,CAAC,qCAAqC,CAAC,CAAC;aAC5F;SACF;KACF;IACD,aAAa,EAAE;QACb,UAAU;QACV,iBAAiB;QACjB,aAAa;QACb,qFAAqF;QACrF,iFAAiF;QACjF,mFAAmF;QACnF,qFAAqF;QACrF,0FAA0F;QAC1F,mBAAmB;QACnB,gBAAgB;KACjB;IACD;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,EAAE;QACd,CAAC,oBAAoB,GAAG,0BAA0B,CAAC,EAAE,cAAc,CAAC,MAAM;QAC1E,CAAC,oBAAoB,GAAG,gCAAgC,CAAC,EAAE,YAAY,CAAC,IAAI;KAC7E;CACF,CAAA"}
+{"version":3,"file":"cli.module.js","sourceRoot":"","sources":["../../../src/cli.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAC,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAC,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAC,iBAAiB,EAAC,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAC,eAAe,EAAE,2BAA2B,EAAC,MAAM,4BAA4B,CAAC;AACxF,OAAO,EAAC,oBAAoB,EAAC,MAAM,0BAA0B,CAAC;AAE9D,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAE9B,yFAAyF;AACzF,yFAAyF;AACzF,mFAAmF;AACnF,oFAAoF;AACpF,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,OAAO,EAAE,gBAAgB;IACzB,wBAAwB,EAAE;QACxB;;;;;WAKG;QACH;YACE,aAAa,EAAE,oBAAoB,CAAC,qBAAqB;YACzD,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;YAClB,gBAAgB,EAAE;gBAChB,IAAI,eAAe,CAAC,IAAI,2BAA2B,CAAC,qCAAqC,CAAC,CAAC;aAC5F;SACF;QACD;;;;WAIG;QACH;YACE,aAAa,EAAE,oBAAoB,CAAC,OAAO;YAC3C,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,EAAE;YAChB,gBAAgB,EAAE;gBAChB,IAAI,2BAA2B,CAAC,uBAAuB,CAAC;aACzD;SACF;KACF;IACD,aAAa,EAAE;QACb,UAAU;QACV,iBAAiB;QACjB,aAAa;QACb,qFAAqF;QACrF,iFAAiF;QACjF,mFAAmF;QACnF,qFAAqF;QACrF,0FAA0F;QAC1F,mBAAmB;QACnB,gBAAgB;KACjB;IACD;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,EAAE;QACd,CAAC,oBAAoB,GAAG,0BAA0B,CAAC,EAAE,cAAc,CAAC,MAAM;QAC1E,CAAC,oBAAoB,GAAG,gCAAgC,CAAC,EAAE,YAAY,CAAC,IAAI;KAC7E;CACF,CAAA"}

package/dist/lib/esm/errors/cli-error-code.enum.js

@@ -10,6 +10,16 @@ export var CliErrorCode;
     CliErrorCode["CommandNotFound"] = "COMMAND_NOT_FOUND";
     CliErrorCode["ArgumentMappingFailed"] = "ARGUMENT_MAPPING_FAILED";
     CliErrorCode["ArgumentValidationFailed"] = "ARGUMENT_VALIDATION_FAILED";
+    /**
+     * A required command-line argument was missing. Reported with the command's `Usage:` synopsis
+     * (exit 64). Distinct from a value supplied but invalid (`InvalidArgument`).
+     */
+    CliErrorCode["MissingRequiredArgument"] = "MISSING_REQUIRED_ARGUMENT";
+    /**
+     * A supplied command-line argument failed validation. Reported as a clean
+     * `Invalid <flag> '<value>'. …` line (exit 64).
+     */
+    CliErrorCode["InvalidArgument"] = "INVALID_ARGUMENT";
     /**
      * Two `@commandParameter` properties on the same options class resolve to the same flag.
      * A programming error in the command's options definition, not bad user input.

package/dist/lib/esm/errors/cli-error-code.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-error-code.enum.js","sourceRoot":"","sources":["../../../../src/errors/cli-error-code.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,YAgBX;AAhBD,WAAY,YAAY;IACtB,qDAA8C,CAAA;IAC9C,iEAAoD,CAAA;IACpD,uEAAuD,CAAA;IAEvD;;;OAGG;IACH,gFAAgE,CAAA;IAEhE;;;OAGG;IACH,oDAAoC,CAAA;AACtC,CAAC,EAhBW,YAAY,KAAZ,YAAY,QAgBvB"}
+{"version":3,"file":"cli-error-code.enum.js","sourceRoot":"","sources":["../../../../src/errors/cli-error-code.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,YA4BX;AA5BD,WAAY,YAAY;IACtB,qDAA8C,CAAA;IAC9C,iEAAoD,CAAA;IACpD,uEAAuD,CAAA;IAEvD;;;OAGG;IACH,qEAAqD,CAAA;IAErD;;;OAGG;IACH,oDAAoC,CAAA;IAEpC;;;OAGG;IACH,gFAAgE,CAAA;IAEhE;;;OAGG;IACH,oDAAoC,CAAA;AACtC,CAAC,EA5BW,YAAY,KAAZ,YAAY,QA4BvB"}

package/dist/lib/esm/interfaces/command-parameter-choice.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-parameter-choice.interface.js.map

package/dist/lib/esm/interfaces/command-parameter-choice.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parameter-choice.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/command-parameter-choice.interface.ts"],"names":[],"mappings":""}

package/dist/lib/esm/interfaces/command-parameter-choices-context.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-parameter-choices-context.interface.js.map

package/dist/lib/esm/interfaces/command-parameter-choices-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parameter-choices-context.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/command-parameter-choices-context.interface.ts"],"names":[],"mappings":""}

package/dist/lib/esm/interfaces/command-parameter-choices-provider.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-parameter-choices-provider.interface.js.map

package/dist/lib/esm/interfaces/command-parameter-choices-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parameter-choices-provider.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/command-parameter-choices-provider.interface.ts"],"names":[],"mappings":""}

package/dist/lib/esm/interfaces/interfaces.js

@@ -1,3 +1,6 @@
 export * from "./command.interface";
+export * from "./command-parameter-choice.interface";
+export * from "./command-parameter-choices-context.interface";
+export * from "./command-parameter-choices-provider.interface";
 export * from "./terminal-key.interface";
 //# sourceMappingURL=interfaces.js.map

package/dist/lib/esm/interfaces/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sCAAsC,CAAC;AACrD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,0BAA0B,CAAC"}

package/dist/lib/esm/reporters/cli-error.reporter.js

@@ -47,14 +47,22 @@ let CliErrorReporter = class CliErrorReporter {
      * `process.exit`. The bin script wraps `bootstrap().catch(err => process.exit(reporter.report(err)))`.
      */
     report(error) {
-        var _a, _b;
+        var _a, _b, _c;
         const e = PristineError.from(error);
         const isDev = this.environmentManager.getEnvironment() === PristineEnvironment.Development;
         const isUserError = e.options.kind !== PristineErrorKind.SystemError;
+        // Plain mode: the message is already a fully formatted, user-facing block (a command's
+        // `Usage:` synopsis, an `Invalid <flag> …` line). Print it verbatim — no `✗ CODE:` envelope,
+        // no `details` rendering — and return its exit code. Honored for user errors only; a
+        // SystemError is never surfaced verbatim in production.
+        if (e.options.plain === true && isUserError) {
+            this.write(`${e.message}\n`);
+            return (_a = e.options.exitCode) !== null && _a !== void 0 ? _a : ExitCode.Error;
+        }
         // Headline: in production, system errors get a generic message so we don't dump
         // internal-bug messages to the user. User errors always show their own message.
         const headline = isUserError || isDev ? e.message : "Internal Error";
-        const code = (_a = e.options.code) !== null && _a !== void 0 ? _a : "ERROR";
+        const code = (_b = e.options.code) !== null && _b !== void 0 ? _b : "ERROR";
         this.write(`✗ ${code}: ${headline}\n`);
         // Details: per-error-class structured fields. Surfaced for user errors always, for
         // system errors only in dev (helps debugging without leaking in prod CI logs).
@@ -81,7 +89,7 @@ let CliErrorReporter = class CliErrorReporter {
         }
         // Exit code fallback: ExitCode.Error (1) for user errors, ExitCode.Software (70)
         // for system errors. Both follow sysexits.h conventions.
-        return (_b = e.options.exitCode) !== null && _b !== void 0 ? _b : (isUserError ? ExitCode.Error : ExitCode.Software);
+        return (_c = e.options.exitCode) !== null && _c !== void 0 ? _c : (isUserError ? ExitCode.Error : ExitCode.Software);
     }
     /**
      * Wraps `process.stderr.write` so a broken stderr (closed pipe, etc.) doesn't itself

package/dist/lib/esm/reporters/cli-error.reporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-error.reporter.js","sourceRoot":"","sources":["../../../../src/reporters/cli-error.reporter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-error.reporter.js","sourceRoot":"","sources":["../../../../src/reporters/cli-error.reporter.ts"],"names":[],"mappings":"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"}

package/dist/lib/esm/services/command-argument-error-formatter.js

@@ -0,0 +1,143 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var CommandArgumentErrorFormatter_1;
+import { injectable } from "tsyringe";
+import { moduleScoped, UsageError } from "@pristine-ts/common";
+import { PropertyMetadata } from "@pristine-ts/metadata";
+import { CliModuleKeyname } from "../cli.module.keyname";
+import { CliDecoratorMetadataKeynameEnum } from "../enums/cli-decorator-metadata-keyname.enum";
+import { CliErrorCode } from "../errors/cli-error-code.enum";
+import { CommandUsageRenderer } from "./command-usage-renderer";
+/**
+ * Turns `@pristine-ts/class-validator`'s raw per-property validation output into a single,
+ * clean, user-facing `UsageError` (exit 64, rendered verbatim via `options.plain`) instead of
+ * a `[CONSTRAINT_KEY]`-prefixed dump:
+ *
+ *   - if any *required* parameter is missing → the command's `Usage:` synopsis, so the user
+ *     sees what to pass (and not a wall of "is not a string" noise for an absent value);
+ *   - otherwise (values present but invalid) → one line per offending value: the parameter's
+ *     `errorMessage` (verbatim, `%value%`/`%flag%` filled), or a generated
+ *     `Invalid <flag> '<value>'. <validator message>` with the constraint-key prefix and
+ *     definedness noise stripped.
+ *
+ * Returns the error rather than throwing it, so the resolver keeps the `throw` (clean control
+ * flow) and tests can assert on the built error directly.
+ */
+let CommandArgumentErrorFormatter = CommandArgumentErrorFormatter_1 = class CommandArgumentErrorFormatter {
+    constructor(usageRenderer) {
+        this.usageRenderer = usageRenderer;
+    }
+    /**
+     * Builds the `UsageError` for a set of validation errors. `mapped` is the (failed) options
+     * instance — read to get each property's effective value and to tell "missing" (undefined /
+     * empty) from "present but invalid".
+     */
+    buildValidationError(optionsType, mapped, validationErrors, context) {
+        const missing = validationErrors.filter((error) => this.isMissing(mapped[error.property]));
+        if (missing.length > 0) {
+            return new UsageError(this.usageRenderer.render(optionsType, context.commandName, context.binName), {
+                code: CliErrorCode.MissingRequiredArgument,
+                plain: true,
+                details: { missing: missing.map((error) => this.flagFor(optionsType, error.property)).join(", ") },
+            });
+        }
+        const lines = validationErrors.map((error) => this.invalidLine(optionsType, mapped, error));
+        return new UsageError(lines.join("\n"), {
+            code: CliErrorCode.InvalidArgument,
+            plain: true,
+        });
+    }
+    /** A value counts as "missing" when it never arrived — undefined/null or an empty string. */
+    isMissing(value) {
+        return value === undefined || value === null || value === "";
+    }
+    /**
+     * One line for an offending value. A parameter's `errorMessage` is the *entire* line, used
+     * verbatim (with `%value%`/`%flag%` filled); otherwise we generate
+     * `Invalid <flag> '<value>'. <validator message>`. Sensitive parameters never echo the value
+     * (it is `<hidden>`, even inside a custom template).
+     * @private
+     */
+    invalidLine(optionsType, mapped, error) {
+        var _a;
+        const options = this.optionsFor(optionsType, error.property);
+        const flag = (_a = options === null || options === void 0 ? void 0 : options.flag) !== null && _a !== void 0 ? _a : error.property;
+        const sensitive = (options === null || options === void 0 ? void 0 : options.sensitive) === true;
+        const value = sensitive ? "<hidden>" : String(mapped[error.property]);
+        if (options === null || options === void 0 ? void 0 : options.errorMessage) {
+            return options.errorMessage.replace(/%value%/g, value).replace(/%flag%/g, flag);
+        }
+        const reason = this.validatorMessage(error);
+        return sensitive ? `Invalid ${flag}. ${reason}` : `Invalid ${flag} '${value}'. ${reason}`;
+    }
+    /**
+     * The validator's own message for a present-but-invalid value: the first *semantic* constraint
+     * message (definedness noise dropped), falling back to the first message present.
+     * @private
+     */
+    validatorMessage(error) {
+        var _a, _b;
+        const messages = this.constraintMessages(error);
+        return (_b = (_a = messages.semantic) !== null && _a !== void 0 ? _a : messages.fallback) !== null && _b !== void 0 ? _b : "Invalid value.";
+    }
+    /**
+     * Splits an error's constraint messages into the first *semantic* one (not a definedness
+     * constraint) and a plain first-seen fallback. Reads `@pristine-ts/class-validator`'s
+     * `{keyname, message}` constraint objects defensively.
+     * @private
+     */
+    constraintMessages(error) {
+        let semantic;
+        let fallback;
+        for (const keyname in error.constraints) {
+            const message = this.extractMessage(error.constraints[keyname]);
+            if (message === undefined) {
+                continue;
+            }
+            if (fallback === undefined) {
+                fallback = message;
+            }
+            if (semantic === undefined && CommandArgumentErrorFormatter_1.DefinednessConstraints.has(keyname.toUpperCase()) === false) {
+                semantic = message;
+            }
+        }
+        return { semantic, fallback };
+    }
+    /** Pulls the human message out of a `{keyname, message}` constraint (or a bare string). */
+    extractMessage(constraint) {
+        if (typeof constraint === "string") {
+            return constraint;
+        }
+        if (constraint && typeof constraint === "object" && typeof constraint.message === "string") {
+            return constraint.message;
+        }
+        return undefined;
+    }
+    optionsFor(optionsType, propertyKey) {
+        return PropertyMetadata.getMetadata(optionsType.prototype, propertyKey, CliDecoratorMetadataKeynameEnum.CommandParameter);
+    }
+    flagFor(optionsType, propertyKey) {
+        var _a, _b;
+        return (_b = (_a = this.optionsFor(optionsType, propertyKey)) === null || _a === void 0 ? void 0 : _a.flag) !== null && _b !== void 0 ? _b : propertyKey;
+    }
+};
+/**
+ * Constraint keynames that only trip because a value is *absent*. For a present-but-invalid
+ * value these never fire, so we drop them and surface the semantic constraint (e.g.
+ * `MATCHES`) the user actually needs — never "is not a string" for a value they gave.
+ */
+CommandArgumentErrorFormatter.DefinednessConstraints = new Set(["IS_DEFINED", "IS_NOT_EMPTY", "IS_STRING"]);
+CommandArgumentErrorFormatter = CommandArgumentErrorFormatter_1 = __decorate([
+    injectable(),
+    moduleScoped(CliModuleKeyname),
+    __metadata("design:paramtypes", [CommandUsageRenderer])
+], CommandArgumentErrorFormatter);
+export { CommandArgumentErrorFormatter };
+//# sourceMappingURL=command-argument-error-formatter.js.map

package/dist/lib/esm/services/command-argument-error-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-argument-error-formatter.js","sourceRoot":"","sources":["../../../../src/services/command-argument-error-formatter.ts"],"names":[],"mappings":"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"}

package/dist/lib/esm/services/command-argument-resolver.js

@@ -46,7 +46,7 @@ let CommandArgumentResolver = class CommandArgumentResolver {
             if (command.optionsType === null) {
                 return rawArgs;
             }
-            return this.commandOptionsResolver.resolve(command.optionsType, rawArgs);
+            return this.commandOptionsResolver.resolve(command.optionsType, rawArgs, { commandName: command.name });
         });
     }
 };

package/dist/lib/esm/services/command-argument-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-argument-resolver.js","sourceRoot":"","sources":["../../../../src/services/command-argument-resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AAElE;;;;;;;;;;GAUG;AAGI,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAClC,YACmB,sBAA8C;QAA9C,2BAAsB,GAAtB,sBAAsB,CAAwB;IAEjE,CAAC;IAED;;;;;OAKG;IACG,OAAO,CAAC,OAA8B,EAAE,OAAY;;YACxD,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBACjC,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC3E,CAAC;KAAA;CACF,CAAA;AAlBY,uBAAuB;IAFnC,UAAU,EAAE;IACZ,YAAY,CAAC,gBAAgB,CAAC;qCAGc,sBAAsB;GAFtD,uBAAuB,CAkBnC"}
+{"version":3,"file":"command-argument-resolver.js","sourceRoot":"","sources":["../../../../src/services/command-argument-resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AAElE;;;;;;;;;;GAUG;AAGI,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAClC,YACmB,sBAA8C;QAA9C,2BAAsB,GAAtB,sBAAsB,CAAwB;IAEjE,CAAC;IAED;;;;;OAKG;IACG,OAAO,CAAC,OAA8B,EAAE,OAAY;;YACxD,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBACjC,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,EAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAC,CAAC,CAAC;QACxG,CAAC;KAAA;CACF,CAAA;AAlBY,uBAAuB;IAFnC,UAAU,EAAE;IACZ,YAAY,CAAC,gBAAgB,CAAC;qCAGc,sBAAsB;GAFtD,uBAAuB,CAkBnC"}

package/dist/lib/esm/services/command-options-resolver.js

@@ -17,21 +17,23 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { injectable } from "tsyringe";
-import { moduleScoped, UsageError, ValidationError } from "@pristine-ts/common";
+import { moduleScoped, UsageError } from "@pristine-ts/common";
 import { Validator } from "@pristine-ts/class-validator";
 import { AutoDataMappingBuilderOptions, DataMapper } from "@pristine-ts/data-mapping";
 import { CliModuleKeyname } from "../cli.module.keyname";
 import { CliErrorCode } from "../errors/cli-error-code.enum";
 import { CommandParameterPrompter } from "./command-parameter-prompter";
+import { CommandArgumentErrorFormatter } from "./command-argument-error-formatter";
+import { ProgramNameResolver } from "./program-name-resolver";
 /**
  * Resolves a typed, validated options instance from raw arguments: it fills any missing
- * `@commandParameter` values by prompting, maps the result onto a real `optionsType`
- * instance (prototype + decorator metadata intact, so `class-validator` finds its rules),
- * and validates it.
+ * `@commandParameter` values by prompting, maps the result onto a real `optionsType` instance
+ * (prototype + decorator metadata intact, so `class-validator` finds its rules), and validates
+ * it.
  *
- * This is the reusable core behind command dispatch — `CommandArgumentResolver` delegates
- * here — exposed so commands and dynamic flows can fill an options class from prompts on
- * demand, including ones not tied to a registered command:
+ * This is the reusable core behind command dispatch — `CommandArgumentResolver` delegates here
+ * — exposed so commands and dynamic flows can fill an options class from prompts on demand,
+ * including ones not tied to a registered command:
  *
  * ```ts
  * constructor(private readonly optionsResolver: CommandOptionsResolver) {}
@@ -39,22 +41,29 @@ import { CommandParameterPrompter } from "./command-parameter-prompter";
  * const options = await this.optionsResolver.resolve(MyOptions, {region: "us"});
  * ```
  *
- * Throws `UsageError` for mapping failures and `ValidationError` for validation failures —
- * both carry structured `details` for `CliErrorReporter`.
+ * Argument problems throw a `UsageError` (exit 64): mapping failures directly, and validation
+ * failures via `CommandArgumentErrorFormatter`, which renders a clean `Usage:` synopsis (for a
+ * missing required value) or `Invalid <flag> '<value>'. …` lines (for a supplied-but-invalid
+ * value) rather than a raw constraint dump.
  */
 let CommandOptionsResolver = class CommandOptionsResolver {
-    constructor(validator, dataMapper, commandParameterPrompter) {
+    constructor(validator, dataMapper, commandParameterPrompter, argumentErrorFormatter, programNameResolver) {
         this.validator = validator;
         this.dataMapper = dataMapper;
         this.commandParameterPrompter = commandParameterPrompter;
+        this.argumentErrorFormatter = argumentErrorFormatter;
+        this.programNameResolver = programNameResolver;
     }
     /**
-     * Prompts for any missing parameters declared on `optionsType`, then maps `rawArgs` (plus
-     * the prompted answers) onto a real instance and validates it. `rawArgs` seeds the values
-     * already known — anything absent that carries a `question` is asked for interactively.
+     * Prompts for any missing parameters declared on `optionsType`, then maps `rawArgs` (plus the
+     * prompted answers) onto a real instance and validates it. `rawArgs` seeds the values already
+     * known — anything absent that carries a `question` is asked for interactively.
+     * `context.commandName` is woven into the `Usage:` line shown when a required value is missing
+     * (defaults to a neutral placeholder for direct, command-less callers).
      */
     resolve(optionsType_1) {
-        return __awaiter(this, arguments, void 0, function* (optionsType, rawArgs = {}) {
+        return __awaiter(this, arguments, void 0, function* (optionsType, rawArgs = {}, context = {}) {
+            var _a;
             const preparedArgs = yield this.commandParameterPrompter.fillMissingParameters(optionsType, rawArgs);
             let mapped;
             try {
@@ -73,29 +82,11 @@ let CommandOptionsResolver = class CommandOptionsResolver {
             if (validationErrors.length === 0) {
                 return mapped;
             }
-            // Reshape the class-validator output into structured `details` the reporter can render
-            // line-by-line. Keeps the throw single-pass and the reporter format-agnostic.
-            const failures = {};
-            for (const error of validationErrors) {
-                const messages = [];
-                for (const constraintKey in error.constraints) {
-                    // `@pristine-ts/class-validator` stores constraints as `{keyname, message}` objects
-                    // rather than the plain strings vanilla class-validator uses. Extract the message
-                    // when present, falling back to JSON for unknown shapes so we never print
-                    // `[object Object]`.
-                    const constraint = error.constraints[constraintKey];
-                    const message = typeof constraint === "string"
-                        ? constraint
-                        : (constraint && typeof constraint === "object" && typeof constraint.message === "string")
-                            ? constraint.message
-                            : JSON.stringify(constraint);
-                    messages.push(`[${constraintKey}] ${message}`);
-                }
-                failures[error.property] = messages;
-            }
-            throw new ValidationError("Argument validation failed", {
-                code: CliErrorCode.ArgumentValidationFailed,
-                details: failures,
+            // Hand the raw class-validator output to the formatter, which classifies missing vs invalid
+            // and produces a clean, plain-rendered `UsageError` (exit 64).
+            throw this.argumentErrorFormatter.buildValidationError(optionsType, mapped, validationErrors, {
+                commandName: (_a = context.commandName) !== null && _a !== void 0 ? _a : "<command>",
+                binName: this.programNameResolver.resolve(),
             });
         });
     }
@@ -105,7 +96,9 @@ CommandOptionsResolver = __decorate([
     moduleScoped(CliModuleKeyname),
     __metadata("design:paramtypes", [Validator,
         DataMapper,
-        CommandParameterPrompter])
+        CommandParameterPrompter,
+        CommandArgumentErrorFormatter,
+        ProgramNameResolver])
 ], CommandOptionsResolver);
 export { CommandOptionsResolver };
 //# sourceMappingURL=command-options-resolver.js.map

package/dist/lib/esm/services/command-options-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-options-resolver.js","sourceRoot":"","sources":["../../../../src/services/command-options-resolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-options-resolver.js","sourceRoot":"","sources":["../../../../src/services/command-options-resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAEpC,OAAO,EAAC,YAAY,EAAE,UAAU,EAAC,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAC,SAAS,EAAC,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAC,6BAA6B,EAAE,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,YAAY,EAAC,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAC,wBAAwB,EAAC,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAC,6BAA6B,EAAC,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAC,mBAAmB,EAAC,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;GAoBG;AAGI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YACmB,SAAoB,EACpB,UAAsB,EACtB,wBAAkD,EAClD,sBAAqD,EACrD,mBAAwC;QAJxC,cAAS,GAAT,SAAS,CAAW;QACpB,eAAU,GAAV,UAAU,CAAY;QACtB,6BAAwB,GAAxB,wBAAwB,CAA0B;QAClD,2BAAsB,GAAtB,sBAAsB,CAA+B;QACrD,wBAAmB,GAAnB,mBAAmB,CAAqB;IAE3D,CAAC;IAED;;;;;;OAMG;IACG,OAAO;6DAAI,WAAgC,EAAE,UAA+B,EAAE,EAAE,UAAkC,EAAE;;YACxH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,qBAAqB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAErG,IAAI,MAAS,CAAC;YACd,IAAI,CAAC;gBACH,mFAAmF;gBACnF,mFAAmF;gBACnF,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,6BAA6B,CAAC,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC;YAC9H,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,UAAU,CAClB,+BAA+B,WAAW,CAAC,IAAI,MAAO,KAAe,CAAC,OAAO,EAAE,EAC/E;oBACE,IAAI,EAAE,YAAY,CAAC,qBAAqB;oBACxC,KAAK,EAAE,KAAc;oBACrB,OAAO,EAAE,EAAC,UAAU,EAAE,WAAW,CAAC,IAAI,EAAC;iBACxC,CACF,CAAC;YACJ,CAAC;YAED,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,4FAA4F;YAC5F,+DAA+D;YAC/D,MAAM,IAAI,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,WAAW,EAAE,MAA6B,EAAE,gBAAgB,EAAE;gBACnH,WAAW,EAAE,MAAA,OAAO,CAAC,WAAW,mCAAI,WAAW;gBAC/C,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE;aAC5C,CAAC,CAAC;QACL,CAAC;KAAA;CACF,CAAA;AAhDY,sBAAsB;IAFlC,UAAU,EAAE;IACZ,YAAY,CAAC,gBAAgB,CAAC;qCAGC,SAAS;QACR,UAAU;QACI,wBAAwB;QAC1B,6BAA6B;QAChC,mBAAmB;GANhD,sBAAsB,CAgDlC"}