@futdevpro/nts-dynamo 1.15.304 → 1.15.307

package/build/_collections/global-settings.const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.const.d.ts","sourceRoot":"","sources":["../../src/_collections/global-settings.const.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAIxF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAiInC,CAAC"}
+{"version":3,"file":"global-settings.const.d.ts","sourceRoot":"","sources":["../../src/_collections/global-settings.const.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAIxF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAmInC,CAAC"}

package/build/_collections/global-settings.const.js

@@ -58,6 +58,7 @@ exports.DyNTS_global_settings = {
     },
     bot_settings: null,
     mcp_settings: null,
+    cli_settings: null,
     openAi_settings: null,
     dias_settings: null,
     assistant_settings: null,

package/build/_collections/global-settings.const.js.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.const.js","sourceRoot":"","sources":["../../src/_collections/global-settings.const.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"global-settings.const.js","sourceRoot":"","sources":["../../src/_collections/global-settings.const.ts"],"names":[],"mappings":"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"}

package/build/_models/interfaces/global-settings.interface.d.ts

@@ -4,6 +4,7 @@ import { DyNTS_AppVersionHeader_Settings } from './app-version-header-settings.i
 import { DyNTS_Environment_Settings } from './environment-settings.interface';
 import { DyNTS_GlobalLog_Settings } from './global-log-settings.interface';
 import { DyNTS_SecurityHeaders_Settings } from './security-headers-settings.interface';
+import type { DyCLI_Settings } from '../../_modules/cli/_models/interfaces/cli-settings.interface';
 import type { DyNTS_Mcp_Settings } from '../../_modules/mcp/_models/interfaces/mcp-settings.interface';
 /**
  *
@@ -118,6 +119,11 @@ export interface DyNTS_Global_Settings {
      * `null` (default) = every field takes its documented default ({@link DyNTS_Mcp_Settings}).
      */
     mcp_settings: DyNTS_Mcp_Settings | null;
+    /**
+     * CLI-wide defaults (HP-DOPL MP-4.2): the default output and the exit-code overrides of the `/cli` commands.
+     * `null` (default) = every field takes its documented default ({@link DyCLI_Settings}).
+     */
+    cli_settings: DyCLI_Settings | null;
     /**
      * this setting will set the openai settings
      * (this will be set in the {@link DyNTS_OAI_LLMChat_ServiceBase} constructor)

package/build/_models/interfaces/global-settings.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/global-settings.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"global-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/global-settings.interface.ts"],"names":[],"mappings":"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"}

package/build/_modules/cli/_collections/cli-commander.util.d.ts

@@ -0,0 +1,25 @@
+import type * as Commander from 'commander';
+/** The supported `commander` range — kept in sync with `peerDependencies` (measured fleet: 12.1 – 14.x). */
+export declare const DyCLI_commanderRange: string;
+/**
+ * Lazy access to `commander` (HP-DOPL MP-4.1, D-5): `commander` is an OPTIONAL peer of `@futdevpro/nts-dynamo`, so
+ * it is never required in a module body — a server that only imports the root package must not need it. The `/cli`
+ * subpath loads it here, at the place of use; a missing package becomes the coded `DyNTS-OPT-MIS` error that says
+ * what to install.
+ *
+ * @example
+ * ```ts
+ * const commander: typeof Commander = await DyCLI_Commander_Util.load();
+ * const program: Commander.Command = new commander.Command('organizer');
+ * ```
+ */
+export declare class DyCLI_Commander_Util {
+    /**
+     * Loads `commander`.
+     * @throws 501 `DyNTS-OPT-MIS` (not installed) · `DyNTS-OPT-LDF` (installed, but failed to load)
+     */
+    static load(): Promise<typeof Commander>;
+    /** Imports `commander` — a static seam, so a spec can simulate a missing package. */
+    private static importCommander;
+}
+//# sourceMappingURL=cli-commander.util.d.ts.map

package/build/_modules/cli/_collections/cli-commander.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-commander.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/cli/_collections/cli-commander.util.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,SAAS,MAAM,WAAW,CAAC;AAK5C,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,EAAE,MAAuB,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAC/B;;;OAGG;WACU,IAAI,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC;IAO9C,qFAAqF;IACrF,OAAO,CAAC,MAAM,CAAC,eAAe,CAEyB;CACxD"}

package/build/_modules/cli/_collections/cli-commander.util.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_Commander_Util = exports.DyCLI_commanderRange = void 0;
+const optional_peer_util_1 = require("../../../_collections/optional-peer.util");
+/** The supported `commander` range — kept in sync with `peerDependencies` (measured fleet: 12.1 – 14.x). */
+exports.DyCLI_commanderRange = '>=12.1.0 <15';
+/**
+ * Lazy access to `commander` (HP-DOPL MP-4.1, D-5): `commander` is an OPTIONAL peer of `@futdevpro/nts-dynamo`, so
+ * it is never required in a module body — a server that only imports the root package must not need it. The `/cli`
+ * subpath loads it here, at the place of use; a missing package becomes the coded `DyNTS-OPT-MIS` error that says
+ * what to install.
+ *
+ * @example
+ * ```ts
+ * const commander: typeof Commander = await DyCLI_Commander_Util.load();
+ * const program: Commander.Command = new commander.Command('organizer');
+ * ```
+ */
+class DyCLI_Commander_Util {
+    /**
+     * Loads `commander`.
+     * @throws 501 `DyNTS-OPT-MIS` (not installed) · `DyNTS-OPT-LDF` (installed, but failed to load)
+     */
+    static async load() {
+        return optional_peer_util_1.DyNTS_OptionalPeer_Util.load({
+            packageName: 'commander', range: exports.DyCLI_commanderRange, feature: 'the Dynamo CLI',
+            importer: DyCLI_Commander_Util.importCommander,
+        });
+    }
+    /** Imports `commander` — a static seam, so a spec can simulate a missing package. */
+    static importCommander = 
+    // eslint-disable-next-line @futdevpro/dynamo/no-dynamic-imports
+    () => Promise.resolve().then(() => __importStar(require('commander')));
+}
+exports.DyCLI_Commander_Util = DyCLI_Commander_Util;
+//# sourceMappingURL=cli-commander.util.js.map

package/build/_modules/cli/_collections/cli-commander.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-commander.util.js","sourceRoot":"","sources":["../../../../src/_modules/cli/_collections/cli-commander.util.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,iFAAmF;AAGnF,4GAA4G;AAC/F,QAAA,oBAAoB,GAAW,cAAc,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAa,oBAAoB;IAC/B;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI;QACf,OAAO,4CAAuB,CAAC,IAAI,CAAC;YAClC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,4BAAoB,EAAE,OAAO,EAAE,gBAAgB;YAChF,QAAQ,EAAE,oBAAoB,CAAC,eAAe;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,qFAAqF;IAC7E,MAAM,CAAC,eAAe;IAC5B,gEAAgE;IAChE,GAA8B,EAAE,mDAAQ,WAAW,GAAC,CAAC;;AAfzD,oDAgBC"}

package/build/_modules/cli/_collections/cli-flag.util.d.ts

@@ -0,0 +1,37 @@
+import { DyFM_Error, DyFM_Operation_Settings } from '@futdevpro/fsm-dynamo';
+import { DyCLI_Flag, DyCLI_Flag_Settings } from '../_models/interfaces/cli-flag.interface';
+/** Flags every command has from commander itself — a command flag can not take them. */
+export declare const DyCLI_reservedFlags: string[];
+/**
+ * The flags of a CLI command (HP-DOPL MP-4.2): generation from the operation input schema, name validation and the
+ * conversion of the command-line text to typed values. Used by `DyCLI_Command_Params`.
+ */
+export declare class DyCLI_Flag_Util {
+    /**
+     * Converts the raw text of a flag to its value.
+     * @param flag - the flag
+     * @param raw - the text from the command line
+     * @throws 400 `DyNTS-CLP-VAL` when the text is not a valid value of the flag
+     */
+    static convert(flag: DyCLI_Flag, raw: string): unknown;
+    /** The commander attribute of a long flag (commander's own camel-casing: `note-id` → `noteId`). */
+    static attributeOf(flag: string): string;
+    /**
+     * The flags of a command: generated from the operation schema, overridden and extended by `flags`.
+     * @param operation - the operation (absent for a local command)
+     * @param overrides - the per-parameter flag settings
+     * @param invalid - builds the construction error of the calling command
+     */
+    static resolveFlags(operation: DyFM_Operation_Settings<unknown, unknown[], unknown> | undefined, overrides: {
+        [param: string]: DyCLI_Flag_Settings;
+    }, invalid: (code: string, reason: string) => DyFM_Error): DyCLI_Flag[];
+    /** Validates the long and short flag names: format, reserved names, duplicates. */
+    private static checkFlagNames;
+    /** The flag value kind of a schema property. */
+    private static typeOf;
+    /** `noteId` → `note-id`. */
+    private static kebabOf;
+    /** Sets only the defined optional fields, so the resolved flag carries no `undefined` keys. */
+    private static assign;
+}
+//# sourceMappingURL=cli-flag.util.d.ts.map

package/build/_modules/cli/_collections/cli-flag.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flag.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/cli/_collections/cli-flag.util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAA6B,uBAAuB,EAC/D,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAQ3F,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,EAAE,MAAM,EAA0B,CAAC;AAEnE;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IA0CtD,mGAAmG;IACnG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIxC;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CACjB,SAAS,EAAE,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3E,SAAS,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAA;KAAE,EACnD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,UAAU,GACpD,UAAU,EAAE;IAyDf,mFAAmF;IACnF,OAAO,CAAC,MAAM,CAAC,cAAc;IAsC7B,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,MAAM;IAerB,4BAA4B;IAC5B,OAAO,CAAC,MAAM,CAAC,OAAO;IAItB,+FAA+F;IAC/F,OAAO,CAAC,MAAM,CAAC,MAAM;CAMtB"}

package/build/_modules/cli/_collections/cli-flag.util.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_Flag_Util = exports.DyCLI_reservedFlags = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const cli_flag_value_type_enum_1 = require("../_enums/cli-flag-value.type-enum");
+/** Long flag names: kebab-case. */
+const DyCLI_flagName = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+/** A finite decimal number — the same notations the REST adapter accepts. */
+const DyCLI_decimal = /^[-+]?(\d+\.?\d*|\.\d+)([eE][-+]?\d+)?$/;
+/** Flags every command has from commander itself — a command flag can not take them. */
+exports.DyCLI_reservedFlags = ['help', 'version'];
+/**
+ * The flags of a CLI command (HP-DOPL MP-4.2): generation from the operation input schema, name validation and the
+ * conversion of the command-line text to typed values. Used by `DyCLI_Command_Params`.
+ */
+class DyCLI_Flag_Util {
+    /**
+     * Converts the raw text of a flag to its value.
+     * @param flag - the flag
+     * @param raw - the text from the command line
+     * @throws 400 `DyNTS-CLP-VAL` when the text is not a valid value of the flag
+     */
+    static convert(flag, raw) {
+        const refuse = (expected) => new fsm_dynamo_1.DyFM_Error({
+            status: 400,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-CLP-VAL`,
+            message: `--${flag.flag} must be ${expected} (got: ${JSON.stringify(raw)})`,
+            userMessage: `--${flag.flag} must be ${expected} (got: ${JSON.stringify(raw)})`,
+            additionalContent: { flag: flag.flag },
+        });
+        let value = raw;
+        if (flag.parse) {
+            value = flag.parse(raw);
+        }
+        else if (flag.type === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.number ||
+            (flag.type === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.list && flag.itemType === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.number)) {
+            if (!DyCLI_decimal.test(raw.trim()) || !Number.isFinite(Number(raw))) {
+                throw refuse('a finite decimal number');
+            }
+            value = Number(raw);
+        }
+        else if (flag.type === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.date) {
+            if (Number.isNaN(new Date(raw).getTime())) {
+                throw refuse('an ISO date-time');
+            }
+        }
+        else if (flag.type === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.json) {
+            try {
+                value = JSON.parse(raw);
+            }
+            catch {
+                throw refuse('JSON');
+            }
+            if (value === null || typeof value !== 'object') {
+                throw refuse('a JSON object or array');
+            }
+        }
+        if (flag.enum && !flag.enum.includes(value)) {
+            throw refuse(`one of ${flag.enum.join(', ')}`);
+        }
+        return value;
+    }
+    /** The commander attribute of a long flag (commander's own camel-casing: `note-id` → `noteId`). */
+    static attributeOf(flag) {
+        return flag.split('-').reduce((name, word) => name + word[0].toUpperCase() + word.slice(1));
+    }
+    /**
+     * The flags of a command: generated from the operation schema, overridden and extended by `flags`.
+     * @param operation - the operation (absent for a local command)
+     * @param overrides - the per-parameter flag settings
+     * @param invalid - builds the construction error of the calling command
+     */
+    static resolveFlags(operation, overrides, invalid) {
+        const schema = operation ?
+            fsm_dynamo_1.DyFM_OperationSchema_Util.inputSchema(operation) : { type: 'object', properties: {} };
+        const required = schema.required ?? [];
+        const params = [...Object.keys(schema.properties ?? {})];
+        Object.keys(overrides).filter((param) => !params.includes(param))
+            .forEach((param) => {
+            params.push(param);
+        });
+        const flags = params.map((param) => {
+            const property = schema.properties?.[param];
+            const override = overrides[param] ?? {};
+            const type = override.type ?? DyCLI_Flag_Util.typeOf(property);
+            if (!Object.values(cli_flag_value_type_enum_1.DyCLI_FlagValue_Type).includes(type)) {
+                throw invalid('DyNTS-CLP-TYP', `flag of "${param}" needs a known type (an extra flag must declare it)`);
+            }
+            ['parse'].forEach((name) => {
+                if (override[name] !== undefined && typeof override[name] !== 'function') {
+                    throw invalid('DyNTS-CLP-HOK', `flags.${param}.${name} must be a function`);
+                }
+            });
+            const enumValues = override.enum ?? property?.enum;
+            if (enumValues !== undefined && !Array.isArray(enumValues)) {
+                throw invalid('DyNTS-CLP-ENM', `flags.${param}.enum must be an array`);
+            }
+            const flag = {
+                param: param,
+                flag: override.flag ?? DyCLI_Flag_Util.kebabOf(param),
+                description: override.description ?? property?.description ?? param,
+                type: type,
+                required: override.required ?? required.includes(param),
+            };
+            DyCLI_Flag_Util.assign(flag, {
+                short: override.short,
+                itemType: type === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.list ?
+                    (property?.items?.type === 'number' ? cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.number : cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.string) : undefined,
+                enum: enumValues ? [...enumValues] : undefined,
+                default: override.default ?? property?.default,
+                parse: override.parse,
+            });
+            return flag;
+        });
+        DyCLI_Flag_Util.checkFlagNames(flags, invalid);
+        return flags;
+    }
+    /** Validates the long and short flag names: format, reserved names, duplicates. */
+    static checkFlagNames(flags, invalid) {
+        const longs = new Set();
+        const shorts = new Set();
+        flags.forEach((flag) => {
+            if (typeof flag.flag !== 'string' || !DyCLI_flagName.test(flag.flag)) {
+                throw invalid('DyNTS-CLP-FLG', `flag of "${flag.param}" must be kebab-case (got: ${JSON.stringify(flag.flag)})`);
+            }
+            if (exports.DyCLI_reservedFlags.includes(flag.flag)) {
+                throw invalid('DyNTS-CLP-RSV', `--${flag.flag} is reserved; set flags.${flag.param}.flag to another name`);
+            }
+            // `--x` and its negated `--no-x` share one attribute, so they collide as well
+            const attribute = DyCLI_Flag_Util.attributeOf(flag.flag.replace(/^no-/, ''));
+            if (longs.has(attribute)) {
+                throw invalid('DyNTS-CLP-DUP', `two flags use --${flag.flag}`);
+            }
+            longs.add(attribute);
+            if (flag.short === undefined) {
+                return;
+            }
+            if (typeof flag.short !== 'string' || !/^[A-Za-z]$/.test(flag.short) || flag.short === 'h' || flag.short === 'V') {
+                throw invalid('DyNTS-CLP-SHT', `short flag of "${flag.param}" must be one letter, not -h or -V`);
+            }
+            if (shorts.has(flag.short)) {
+                throw invalid('DyNTS-CLP-DUP', `two flags use -${flag.short}`);
+            }
+            shorts.add(flag.short);
+        });
+    }
+    /** The flag value kind of a schema property. */
+    static typeOf(property) {
+        if (!property) {
+            return undefined;
+        }
+        if (property.format === 'date-time') {
+            return cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.date;
+        }
+        return {
+            string: cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.string, number: cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.number, integer: cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.number,
+            boolean: cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.boolean, array: cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.list,
+        }[property.type] ?? cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.json;
+    }
+    /** `noteId` → `note-id`. */
+    static kebabOf(param) {
+        return param.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/_/g, '-').toLowerCase();
+    }
+    /** Sets only the defined optional fields, so the resolved flag carries no `undefined` keys. */
+    static assign(flag, optional) {
+        Object.entries(optional).filter(([, value]) => value !== undefined)
+            .forEach(([key, value]) => {
+            flag[key] = value;
+        });
+    }
+}
+exports.DyCLI_Flag_Util = DyCLI_Flag_Util;
+//# sourceMappingURL=cli-flag.util.js.map

package/build/_modules/cli/_collections/cli-flag.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flag.util.js","sourceRoot":"","sources":["../../../../src/_modules/cli/_collections/cli-flag.util.ts"],"names":[],"mappings":"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"}

package/build/_modules/cli/_enums/cli-exit-code.type-enum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Process exit codes of a Dynamo CLI command (HP-DOPL MP-4.2). The values follow the organizer `fo` CLI, the pattern the
+ * fleet CLIs copy (`ok 0 · operation error 1 · usage 2 · auth 10 · network 11 · remote 12`); a command may override
+ * them with `DyCLI_Command_Params.exitCodes`.
+ */
+export declare enum DyCLI_ExitCode_Type {
+    /** Success. */
+    ok = 0,
+    /** The command failed without an HTTP-like status (a local error). */
+    operationError = 1,
+    /** Invalid arguments: a parse error, or a 400/404/422 answer. */
+    usage = 2,
+    /** Not authenticated or not allowed: a 401/403 answer. */
+    auth = 10,
+    /** The server could not be reached. */
+    network = 11,
+    /** The server answered with any other error status. */
+    remote = 12
+}
+//# sourceMappingURL=cli-exit-code.type-enum.d.ts.map

package/build/_modules/cli/_enums/cli-exit-code.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-exit-code.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/cli/_enums/cli-exit-code.type-enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,mBAAmB;IAC7B,eAAe;IACf,EAAE,IAAI;IACN,sEAAsE;IACtE,cAAc,IAAI;IAClB,iEAAiE;IACjE,KAAK,IAAI;IACT,0DAA0D;IAC1D,IAAI,KAAK;IACT,uCAAuC;IACvC,OAAO,KAAK;IACZ,uDAAuD;IACvD,MAAM,KAAK;CACZ"}

package/build/_modules/cli/_enums/cli-exit-code.type-enum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_ExitCode_Type = void 0;
+/**
+ * Process exit codes of a Dynamo CLI command (HP-DOPL MP-4.2). The values follow the organizer `fo` CLI, the pattern the
+ * fleet CLIs copy (`ok 0 · operation error 1 · usage 2 · auth 10 · network 11 · remote 12`); a command may override
+ * them with `DyCLI_Command_Params.exitCodes`.
+ */
+var DyCLI_ExitCode_Type;
+(function (DyCLI_ExitCode_Type) {
+    /** Success. */
+    DyCLI_ExitCode_Type[DyCLI_ExitCode_Type["ok"] = 0] = "ok";
+    /** The command failed without an HTTP-like status (a local error). */
+    DyCLI_ExitCode_Type[DyCLI_ExitCode_Type["operationError"] = 1] = "operationError";
+    /** Invalid arguments: a parse error, or a 400/404/422 answer. */
+    DyCLI_ExitCode_Type[DyCLI_ExitCode_Type["usage"] = 2] = "usage";
+    /** Not authenticated or not allowed: a 401/403 answer. */
+    DyCLI_ExitCode_Type[DyCLI_ExitCode_Type["auth"] = 10] = "auth";
+    /** The server could not be reached. */
+    DyCLI_ExitCode_Type[DyCLI_ExitCode_Type["network"] = 11] = "network";
+    /** The server answered with any other error status. */
+    DyCLI_ExitCode_Type[DyCLI_ExitCode_Type["remote"] = 12] = "remote";
+})(DyCLI_ExitCode_Type || (exports.DyCLI_ExitCode_Type = DyCLI_ExitCode_Type = {}));
+//# sourceMappingURL=cli-exit-code.type-enum.js.map

package/build/_modules/cli/_enums/cli-exit-code.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-exit-code.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/cli/_enums/cli-exit-code.type-enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,mBAaX;AAbD,WAAY,mBAAmB;IAC7B,eAAe;IACf,yDAAM,CAAA;IACN,sEAAsE;IACtE,iFAAkB,CAAA;IAClB,iEAAiE;IACjE,+DAAS,CAAA;IACT,0DAA0D;IAC1D,8DAAS,CAAA;IACT,uCAAuC;IACvC,oEAAY,CAAA;IACZ,uDAAuD;IACvD,kEAAW,CAAA;AACb,CAAC,EAbW,mBAAmB,mCAAnB,mBAAmB,QAa9B"}

package/build/_modules/cli/_enums/cli-flag-value.type-enum.d.ts

@@ -0,0 +1,16 @@
+/** The value kind of a CLI flag — decides how the text from the command line is converted (HP-DOPL MP-4.2). */
+export declare enum DyCLI_FlagValue_Type {
+    /** Any text. */
+    string = "string",
+    /** A finite decimal number (`12`, `-2.5`, `1e3`); `Infinity`, hex and binary notations are refused. */
+    number = "number",
+    /** A switch without a value (`--done`); a flag whose default is `true` is negated (`--no-done`). */
+    boolean = "boolean",
+    /** An ISO date-time text, kept as text (the same value an MCP call sends). */
+    date = "date",
+    /** A repeatable flag collecting its values into an array (`--tag a --tag b`). */
+    list = "list",
+    /** A JSON object or array (`--location '{"city":"Pécs"}'`). */
+    json = "json"
+}
+//# sourceMappingURL=cli-flag-value.type-enum.d.ts.map

package/build/_modules/cli/_enums/cli-flag-value.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flag-value.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/cli/_enums/cli-flag-value.type-enum.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,oBAAY,oBAAoB;IAC9B,gBAAgB;IAChB,MAAM,WAAW;IACjB,uGAAuG;IACvG,MAAM,WAAW;IACjB,oGAAoG;IACpG,OAAO,YAAY;IACnB,8EAA8E;IAC9E,IAAI,SAAS;IACb,iFAAiF;IACjF,IAAI,SAAS;IACb,+DAA+D;IAC/D,IAAI,SAAS;CACd"}

package/build/_modules/cli/_enums/cli-flag-value.type-enum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_FlagValue_Type = void 0;
+/** The value kind of a CLI flag — decides how the text from the command line is converted (HP-DOPL MP-4.2). */
+var DyCLI_FlagValue_Type;
+(function (DyCLI_FlagValue_Type) {
+    /** Any text. */
+    DyCLI_FlagValue_Type["string"] = "string";
+    /** A finite decimal number (`12`, `-2.5`, `1e3`); `Infinity`, hex and binary notations are refused. */
+    DyCLI_FlagValue_Type["number"] = "number";
+    /** A switch without a value (`--done`); a flag whose default is `true` is negated (`--no-done`). */
+    DyCLI_FlagValue_Type["boolean"] = "boolean";
+    /** An ISO date-time text, kept as text (the same value an MCP call sends). */
+    DyCLI_FlagValue_Type["date"] = "date";
+    /** A repeatable flag collecting its values into an array (`--tag a --tag b`). */
+    DyCLI_FlagValue_Type["list"] = "list";
+    /** A JSON object or array (`--location '{"city":"Pécs"}'`). */
+    DyCLI_FlagValue_Type["json"] = "json";
+})(DyCLI_FlagValue_Type || (exports.DyCLI_FlagValue_Type = DyCLI_FlagValue_Type = {}));
+//# sourceMappingURL=cli-flag-value.type-enum.js.map

package/build/_modules/cli/_enums/cli-flag-value.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flag-value.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/cli/_enums/cli-flag-value.type-enum.ts"],"names":[],"mappings":";;;AAAA,+GAA+G;AAC/G,IAAY,oBAaX;AAbD,WAAY,oBAAoB;IAC9B,gBAAgB;IAChB,yCAAiB,CAAA;IACjB,uGAAuG;IACvG,yCAAiB,CAAA;IACjB,oGAAoG;IACpG,2CAAmB,CAAA;IACnB,8EAA8E;IAC9E,qCAAa,CAAA;IACb,iFAAiF;IACjF,qCAAa,CAAA;IACb,+DAA+D;IAC/D,qCAAa,CAAA;AACf,CAAC,EAbW,oBAAoB,oCAApB,oBAAoB,QAa/B"}

package/build/_modules/cli/_enums/cli-output.type-enum.d.ts

@@ -0,0 +1,8 @@
+/** How a Dynamo CLI command prints its result (HP-DOPL MP-4.2). */
+export declare enum DyCLI_Output_Type {
+    /** The JSON result envelope — for scripts and agents (default). */
+    json = "json",
+    /** Human-readable text, through the command's `formatHuman`. */
+    human = "human"
+}
+//# sourceMappingURL=cli-output.type-enum.d.ts.map

package/build/_modules/cli/_enums/cli-output.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/cli/_enums/cli-output.type-enum.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,oBAAY,iBAAiB;IAC3B,mEAAmE;IACnE,IAAI,SAAS;IACb,gEAAgE;IAChE,KAAK,UAAU;CAChB"}

package/build/_modules/cli/_enums/cli-output.type-enum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_Output_Type = void 0;
+/** How a Dynamo CLI command prints its result (HP-DOPL MP-4.2). */
+var DyCLI_Output_Type;
+(function (DyCLI_Output_Type) {
+    /** The JSON result envelope — for scripts and agents (default). */
+    DyCLI_Output_Type["json"] = "json";
+    /** Human-readable text, through the command's `formatHuman`. */
+    DyCLI_Output_Type["human"] = "human";
+})(DyCLI_Output_Type || (exports.DyCLI_Output_Type = DyCLI_Output_Type = {}));
+//# sourceMappingURL=cli-output.type-enum.js.map

package/build/_modules/cli/_enums/cli-output.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/cli/_enums/cli-output.type-enum.ts"],"names":[],"mappings":";;;AAAA,mEAAmE;AACnE,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,mEAAmE;IACnE,kCAAa,CAAA;IACb,gEAAgE;IAChE,oCAAe,CAAA;AACjB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}

package/build/_modules/cli/_models/control-models/cli-command-params.control-model.d.ts

@@ -0,0 +1,115 @@
+import type * as Commander from 'commander';
+import { DyFM_Operation_Settings } from '@futdevpro/fsm-dynamo';
+import { DyCLI_Output_Type } from '../../_enums/cli-output.type-enum';
+import { DyCLI_Flag, DyCLI_Flag_Settings } from '../interfaces/cli-flag.interface';
+import { DyCLI_ExitCodes, DyCLI_Settings } from '../interfaces/cli-settings.interface';
+/** The values of a command call, keyed by parameter name — the same object an MCP `tools/call` sends as arguments. */
+export type DyCLI_CommandValues = {
+    [param: string]: unknown;
+};
+/**
+ * One CLI command (HP-DOPL MP-4.2, decision D-4): ONE class for hand-written local commands and for commands
+ * generated from a server operation. With an `operation`, the flags come from the operation's input schema
+ * (`DyFM_OperationSchema_Util.inputSchema` — inputs, body properties, guardrail arguments), so the collected values are
+ * exactly the arguments of the MCP tool of the same operation. Without an operation (a local command of `dc`, `fdp` or
+ * `ma`), `action` runs the command.
+ *
+ * Custom options (D-4): per-parameter flag overrides and extra flags (`flags`), an own `action`, a `formatHuman` text
+ * formatter, `before` / `after` hooks, `output` and `exitCodes`. Defaults come from `DyNTS_global_settings.cli_settings`.
+ *
+ * `commander` is never loaded here: `buildCommand` receives the module loaded by `DyCLI_Commander_Util.load()`.
+ *
+ * @example
+ * ```ts
+ * const listTasks: DyCLI_Command_Params = new DyCLI_Command_Params({
+ *   operation: listTasksOperation,                         // command: 'tasks.list'
+ *   flags: { limit: { short: 'l' } },
+ *   formatHuman: (tasks: Task[]): string => tasks.map((task: Task): string => task.title).join('\n'),
+ * });
+ * const commander: typeof Commander = await DyCLI_Commander_Util.load();
+ *
+ * program.addCommand(listTasks.buildCommand(commander, async (values: DyCLI_CommandValues): Promise<void> => {
+ *   await runner.run(listTasks, values);                     // `--project-id p-1 -l 5` → { projectId: 'p-1', limit: 5 }
+ * }));
+ * ```
+ */
+export declare class DyCLI_Command_Params {
+    /** The command name; default: the operation name (`<domain>.<action>`). */
+    readonly command: string;
+    /** The help description; default: the operation description. */
+    readonly description: string;
+    /** Alternative command names. */
+    readonly aliases: string[];
+    /** Extra help text shown after the options (examples). */
+    readonly helpText?: string;
+    /** The server operation the command calls; absent for a local command. */
+    readonly operation?: DyFM_Operation_Settings<unknown, unknown[], unknown>;
+    /** The resolved flags, in schema order, then the extra flags. */
+    readonly flags: DyCLI_Flag[];
+    /** The output of this command; absent = `cli_settings.output`, then `json`. */
+    readonly output?: DyCLI_Output_Type;
+    /** Exit-code overrides of this command. */
+    readonly exitCodes: Partial<DyCLI_ExitCodes>;
+    /** Where the params were constructed (for error diagnostics). */
+    readonly stackLocation: string;
+    /** Runs the command instead of calling the operation (required without an operation). */
+    action?(values: DyCLI_CommandValues, params: DyCLI_Command_Params): Promise<unknown>;
+    /** The human-readable text of a result (output `human`). */
+    formatHuman?(result: unknown): string;
+    /** Runs before the command, e.g. to ensure a local server runs. */
+    before?(values: DyCLI_CommandValues, params: DyCLI_Command_Params): Promise<void>;
+    /** Runs after a successful command. */
+    after?(result: unknown, values: DyCLI_CommandValues, params: DyCLI_Command_Params): Promise<void>;
+    /**
+     * @param set - the command settings; throws a coded `DyFM_Error` (500 `DyNTS-CLP-*`) when invalid
+     */
+    constructor(set: {
+        operation?: DyFM_Operation_Settings<unknown, unknown[], unknown>;
+        command?: string;
+        description?: string;
+        aliases?: string[];
+        helpText?: string;
+        flags?: {
+            [param: string]: DyCLI_Flag_Settings;
+        };
+        output?: DyCLI_Output_Type;
+        exitCodes?: Partial<DyCLI_ExitCodes>;
+        action?(values: DyCLI_CommandValues, params: DyCLI_Command_Params): Promise<unknown>;
+        formatHuman?(result: unknown): string;
+        before?(values: DyCLI_CommandValues, params: DyCLI_Command_Params): Promise<void>;
+        after?(result: unknown, values: DyCLI_CommandValues, params: DyCLI_Command_Params): Promise<void>;
+        stackLocation?: string;
+    });
+    /**
+     * Builds the commander command: name, description, aliases, help text and one option per flag; the action collects
+     * the typed values and hands them to `onAction`. A value that does not convert is a commander usage error.
+     * @param commander - the module from `DyCLI_Commander_Util.load()`
+     * @param onAction - receives the collected values
+     */
+    buildCommand(commander: typeof Commander, onAction: (values: DyCLI_CommandValues) => Promise<void>): Commander.Command;
+    /**
+     * The values of a call from the parsed commander options: keyed by parameter name, defaults applied, absent flags
+     * left out.
+     * @param options - the parsed options (`command.opts()`)
+     */
+    readValues(options: {
+        [attribute: string]: unknown;
+    }): DyCLI_CommandValues;
+    /** The output of this command: its own, then `cli_settings.output`, then `json`. */
+    getOutput(settings?: DyCLI_Settings | null): DyCLI_Output_Type;
+    /**
+     * The process exit code of a failure: a commander parse error or 400/404/422 → usage · 401/403 → auth · an
+     * unreachable server → network · any other status → remote · no status → operation error. The command's
+     * `exitCodes` win over `cli_settings.exitCodes`, which win over `DyCLI_ExitCode_Type`.
+     * @param error - the failure
+     * @param settings - the CLI settings (default: `DyNTS_global_settings.cli_settings`)
+     */
+    exitCodeOf(error: unknown, settings?: DyCLI_Settings | null): number;
+    /** Builds the commander option of a flag. */
+    private static optionOf;
+    /** Validates the exit-code overrides: integers between 1 and 255 of known outcomes. */
+    private static checkExitCodes;
+    /** Builds the construction error with a stable error code and the construction location. */
+    private static invalid;
+}
+//# sourceMappingURL=cli-command-params.control-model.d.ts.map

package/build/_modules/cli/_models/control-models/cli-command-params.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-params.control-model.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/cli/_models/control-models/cli-command-params.control-model.ts"],"names":[],"mappings":"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"}

package/build/_modules/cli/_models/control-models/cli-command-params.control-model.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_Command_Params = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../../_collections/global-settings.const");
+const cli_flag_util_1 = require("../../_collections/cli-flag.util");
+const cli_exit_code_type_enum_1 = require("../../_enums/cli-exit-code.type-enum");
+const cli_flag_value_type_enum_1 = require("../../_enums/cli-flag-value.type-enum");
+const cli_output_type_enum_1 = require("../../_enums/cli-output.type-enum");
+/** Command names: letters, digits, `.`, `_`, `-` (an operation name `<domain>.<action>` fits), max 64 characters. */
+const DyCLI_commandName = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+/** Error codes of a server that can not be reached. */
+const DyCLI_networkCodes = [
+    'ECONNREFUSED', 'ECONNRESET', 'ENOTFOUND', 'ETIMEDOUT', 'EAI_AGAIN', 'UND_ERR_CONNECT_TIMEOUT', 'UND_ERR_SOCKET',
+];
+/**
+ * One CLI command (HP-DOPL MP-4.2, decision D-4): ONE class for hand-written local commands and for commands
+ * generated from a server operation. With an `operation`, the flags come from the operation's input schema
+ * (`DyFM_OperationSchema_Util.inputSchema` — inputs, body properties, guardrail arguments), so the collected values are
+ * exactly the arguments of the MCP tool of the same operation. Without an operation (a local command of `dc`, `fdp` or
+ * `ma`), `action` runs the command.
+ *
+ * Custom options (D-4): per-parameter flag overrides and extra flags (`flags`), an own `action`, a `formatHuman` text
+ * formatter, `before` / `after` hooks, `output` and `exitCodes`. Defaults come from `DyNTS_global_settings.cli_settings`.
+ *
+ * `commander` is never loaded here: `buildCommand` receives the module loaded by `DyCLI_Commander_Util.load()`.
+ *
+ * @example
+ * ```ts
+ * const listTasks: DyCLI_Command_Params = new DyCLI_Command_Params({
+ *   operation: listTasksOperation,                         // command: 'tasks.list'
+ *   flags: { limit: { short: 'l' } },
+ *   formatHuman: (tasks: Task[]): string => tasks.map((task: Task): string => task.title).join('\n'),
+ * });
+ * const commander: typeof Commander = await DyCLI_Commander_Util.load();
+ *
+ * program.addCommand(listTasks.buildCommand(commander, async (values: DyCLI_CommandValues): Promise<void> => {
+ *   await runner.run(listTasks, values);                     // `--project-id p-1 -l 5` → { projectId: 'p-1', limit: 5 }
+ * }));
+ * ```
+ */
+class DyCLI_Command_Params {
+    /** The command name; default: the operation name (`<domain>.<action>`). */
+    command;
+    /** The help description; default: the operation description. */
+    description;
+    /** Alternative command names. */
+    aliases;
+    /** Extra help text shown after the options (examples). */
+    helpText;
+    /** The server operation the command calls; absent for a local command. */
+    operation;
+    /** The resolved flags, in schema order, then the extra flags. */
+    flags;
+    /** The output of this command; absent = `cli_settings.output`, then `json`. */
+    output;
+    /** Exit-code overrides of this command. */
+    exitCodes;
+    /** Where the params were constructed (for error diagnostics). */
+    stackLocation;
+    /**
+     * @param set - the command settings; throws a coded `DyFM_Error` (500 `DyNTS-CLP-*`) when invalid
+     */
+    constructor(set) {
+        const stackLocation = set?.stackLocation ?? (0, fsm_dynamo_1.DyFM_getConstructionStackLocation)();
+        const invalid = (code, reason) => DyCLI_Command_Params.invalid(code, `${reason} (command "${set?.command ?? set?.operation?.name}")`, stackLocation);
+        const operation = set?.operation;
+        // a plain object would skip the construction-time validation of the operation
+        if (operation !== undefined && (typeof operation?.name !== 'string' || !operation?.expose)) {
+            throw invalid('DyNTS-CLP-OPR', 'operation must be a constructed DyFM_Operation_Settings');
+        }
+        if (operation?.expose.cli === false) {
+            throw invalid('DyNTS-CLP-EXP', `operation "${operation.name}" is not exposed on the CLI (expose.cli: false)`);
+        }
+        ['action', 'formatHuman', 'before', 'after'].forEach((name) => {
+            if (set?.[name] !== undefined && typeof set[name] !== 'function') {
+                throw invalid('DyNTS-CLP-HOK', `${name} must be a function`);
+            }
+        });
+        if (!operation && !set?.action) {
+            throw invalid('DyNTS-CLP-ACT', 'a command needs an operation to call or an own action');
+        }
+        const command = set.command ?? operation?.name;
+        if (typeof command !== 'string' || !DyCLI_commandName.test(command)) {
+            throw invalid('DyNTS-CLP-CMD', `command name must be 1-64 letters, digits, ".", "_" or "-" (got: ${JSON.stringify(command)})`);
+        }
+        const description = set.description ?? operation?.description;
+        if (typeof description !== 'string' || !description.trim()) {
+            throw invalid('DyNTS-CLP-DSC', 'a command needs a description');
+        }
+        const aliases = set.aliases ?? [];
+        if (!Array.isArray(aliases) || aliases.some((alias) => typeof alias !== 'string' || !DyCLI_commandName.test(alias) || alias === command)) {
+            throw invalid('DyNTS-CLP-ALS', 'aliases must be valid command names, different from the command');
+        }
+        if (set.output !== undefined && !Object.values(cli_output_type_enum_1.DyCLI_Output_Type).includes(set.output)) {
+            throw invalid('DyNTS-CLP-OUT', `unknown output ${JSON.stringify(set.output)}`);
+        }
+        DyCLI_Command_Params.checkExitCodes(set.exitCodes, invalid);
+        this.command = command;
+        this.description = description;
+        this.aliases = [...aliases];
+        this.helpText = set.helpText;
+        this.operation = operation;
+        this.flags = cli_flag_util_1.DyCLI_Flag_Util.resolveFlags(operation, set.flags ?? {}, invalid);
+        this.output = set.output;
+        this.exitCodes = { ...set.exitCodes };
+        this.stackLocation = stackLocation;
+        if (set.action) {
+            this.action = set.action;
+        }
+        if (set.formatHuman) {
+            this.formatHuman = set.formatHuman;
+        }
+        if (set.before) {
+            this.before = set.before;
+        }
+        if (set.after) {
+            this.after = set.after;
+        }
+    }
+    /**
+     * Builds the commander command: name, description, aliases, help text and one option per flag; the action collects
+     * the typed values and hands them to `onAction`. A value that does not convert is a commander usage error.
+     * @param commander - the module from `DyCLI_Commander_Util.load()`
+     * @param onAction - receives the collected values
+     */
+    buildCommand(commander, onAction) {
+        const command = new commander.Command(this.command).description(this.description);
+        this.aliases.forEach((alias) => {
+            command.alias(alias);
+        });
+        if (this.helpText) {
+            command.addHelpText('after', this.helpText);
+        }
+        this.flags.forEach((flag) => {
+            command.addOption(DyCLI_Command_Params.optionOf(commander, flag));
+        });
+        command.action(async (options) => {
+            await onAction(this.readValues(options));
+        });
+        return command;
+    }
+    /**
+     * The values of a call from the parsed commander options: keyed by parameter name, defaults applied, absent flags
+     * left out.
+     * @param options - the parsed options (`command.opts()`)
+     */
+    readValues(options) {
+        const values = {};
+        this.flags.forEach((flag) => {
+            const value = options?.[cli_flag_util_1.DyCLI_Flag_Util.attributeOf(flag.flag)] ?? flag.default;
+            if (value !== undefined) {
+                values[flag.param] = value;
+            }
+        });
+        return values;
+    }
+    /** The output of this command: its own, then `cli_settings.output`, then `json`. */
+    getOutput(settings = global_settings_const_1.DyNTS_global_settings.cli_settings) {
+        return this.output ?? settings?.output ?? cli_output_type_enum_1.DyCLI_Output_Type.json;
+    }
+    /**
+     * The process exit code of a failure: a commander parse error or 400/404/422 → usage · 401/403 → auth · an
+     * unreachable server → network · any other status → remote · no status → operation error. The command's
+     * `exitCodes` win over `cli_settings.exitCodes`, which win over `DyCLI_ExitCode_Type`.
+     * @param error - the failure
+     * @param settings - the CLI settings (default: `DyNTS_global_settings.cli_settings`)
+     */
+    exitCodeOf(error, settings = global_settings_const_1.DyNTS_global_settings.cli_settings) {
+        const codes = {
+            operationError: cli_exit_code_type_enum_1.DyCLI_ExitCode_Type.operationError, usage: cli_exit_code_type_enum_1.DyCLI_ExitCode_Type.usage,
+            auth: cli_exit_code_type_enum_1.DyCLI_ExitCode_Type.auth, network: cli_exit_code_type_enum_1.DyCLI_ExitCode_Type.network, remote: cli_exit_code_type_enum_1.DyCLI_ExitCode_Type.remote,
+            ...settings?.exitCodes, ...this.exitCodes,
+        };
+        const failure = (error ?? {});
+        const status = failure.___status ?? failure.status;
+        if (typeof failure.code === 'string' && failure.code.startsWith('commander.')) {
+            return codes.usage;
+        }
+        if (DyCLI_networkCodes.includes(String(failure.code)) || DyCLI_networkCodes.includes(String(failure.cause?.code))) {
+            return codes.network;
+        }
+        if (typeof status !== 'number') {
+            return codes.operationError;
+        }
+        if (status === 401 || status === 403) {
+            return codes.auth;
+        }
+        if (status === 400 || status === 404 || status === 422) {
+            return codes.usage;
+        }
+        return status >= 400 ? codes.remote : codes.operationError;
+    }
+    /** Builds the commander option of a flag. */
+    static optionOf(commander, flag) {
+        const isSwitch = flag.type === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.boolean;
+        const long = isSwitch && flag.default === true ? `--no-${flag.flag}` : `--${flag.flag}`;
+        const value = isSwitch ? '' : ` <${flag.type === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.list ? 'item' : 'value'}>`;
+        const option = new commander.Option(`${flag.short ? `-${flag.short}, ` : ''}${long}${value}`, flag.description);
+        if (!isSwitch) {
+            option.argParser((raw, previous) => {
+                try {
+                    const converted = cli_flag_util_1.DyCLI_Flag_Util.convert(flag, raw);
+                    return flag.type === cli_flag_value_type_enum_1.DyCLI_FlagValue_Type.list ?
+                        [...(Array.isArray(previous) ? previous : []), converted] : converted;
+                }
+                catch (error) {
+                    throw new commander.InvalidArgumentError(error.__userMessage ?? error.message);
+                }
+            });
+        }
+        if (flag.required && !isSwitch) {
+            option.makeOptionMandatory(true);
+        }
+        return option;
+    }
+    /** Validates the exit-code overrides: integers between 1 and 255 of known outcomes. */
+    static checkExitCodes(exitCodes, invalid) {
+        const outcomes = ['operationError', 'usage', 'auth', 'network', 'remote'];
+        Object.entries(exitCodes ?? {}).forEach(([outcome, code]) => {
+            if (!outcomes.includes(outcome) || !Number.isInteger(code) || code < 1 || code > 255) {
+                throw invalid('DyNTS-CLP-EXC', `exitCodes.${outcome} must be a known outcome with an integer 1-255`);
+            }
+        });
+    }
+    /** Builds the construction error with a stable error code and the construction location. */
+    static invalid(code, reason, stackLocation) {
+        return new fsm_dynamo_1.DyFM_Error({
+            status: 500,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|${code}`,
+            message: `DyCLI_Command_Params construction failed: ${reason}`,
+            additionalContent: { stackLocation: stackLocation },
+        });
+    }
+}
+exports.DyCLI_Command_Params = DyCLI_Command_Params;
+//# sourceMappingURL=cli-command-params.control-model.js.map

package/build/_modules/cli/_models/control-models/cli-command-params.control-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-params.control-model.js","sourceRoot":"","sources":["../../../../../src/_modules/cli/_models/control-models/cli-command-params.control-model.ts"],"names":[],"mappings":";;;AAIA,sDAA+G;AAE/G,0FAAuF;AACvF,oEAAmE;AACnE,kFAA2E;AAC3E,oFAA6E;AAC7E,4EAAsE;AAKtE,qHAAqH;AACrH,MAAM,iBAAiB,GAAW,mCAAmC,CAAC;AACtE,uDAAuD;AACvD,MAAM,kBAAkB,GAAa;IACnC,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,yBAAyB,EAAE,gBAAgB;CACjH,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,oBAAoB;IAC/B,2EAA2E;IAClE,OAAO,CAAS;IACzB,gEAAgE;IACvD,WAAW,CAAS;IAC7B,iCAAiC;IACxB,OAAO,CAAW;IAC3B,0DAA0D;IACjD,QAAQ,CAAU;IAC3B,0EAA0E;IACjE,SAAS,CAAwD;IAC1E,iEAAiE;IACxD,KAAK,CAAe;IAC7B,+EAA+E;IACtE,MAAM,CAAqB;IACpC,2CAA2C;IAClC,SAAS,CAA2B;IAC7C,iEAAiE;IACxD,aAAa,CAAS;IAW/B;;OAEG;IACH,YAAY,GAcX;QACC,MAAM,aAAa,GAAW,GAAG,EAAE,aAAa,IAAI,IAAA,8CAAiC,GAAE,CAAC;QACxF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,MAAc,EAAc,EAAE,CAC3D,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,MAAM,cAAc,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,aAAa,CAAC,CAAC;QACrH,MAAM,SAAS,GAAqE,GAAG,EAAE,SAAS,CAAC;QAEnG,8EAA8E;QAC9E,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,OAAO,SAAS,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;YAC3F,MAAM,OAAO,CAAC,eAAe,EAAE,yDAAyD,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,SAAS,EAAE,MAAM,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;YACpC,MAAM,OAAO,CAAC,eAAe,EAAE,cAAc,SAAS,CAAC,IAAI,iDAAiD,CAAC,CAAC;QAChH,CAAC;QAEA,CAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAY,CAAC,OAAO,CAAC,CAAC,IAAY,EAAQ,EAAE;YACvF,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;gBACjE,MAAM,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,qBAAqB,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;YAC/B,MAAM,OAAO,CAAC,eAAe,EAAE,uDAAuD,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,IAAI,SAAS,EAAE,IAAI,CAAC;QAEvD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,MAAM,OAAO,CAAC,eAAe,EAAE,oEAAoE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjI,CAAC;QAED,MAAM,WAAW,GAAW,GAAG,CAAC,WAAW,IAAI,SAAS,EAAE,WAAW,CAAC;QAEtE,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3D,MAAM,OAAO,CAAC,eAAe,EAAE,+BAA+B,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,OAAO,GAAa,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAE5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAa,EAAW,EAAE,CACrE,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,OAAO,CAAC,EAAE,CAAC;YACpF,MAAM,OAAO,CAAC,eAAe,EAAE,iEAAiE,CAAC,CAAC;QACpG,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,wCAAiB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvF,MAAM,OAAO,CAAC,eAAe,EAAE,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC;QAED,oBAAoB,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,CAAE,GAAG,OAAO,CAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,+BAAe,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/E,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QAEnC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC3B,CAAC;QAED,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;QACrC,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC3B,CAAC;QAED,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,YAAY,CACV,SAA2B,EAC3B,QAAwD;QAExD,MAAM,OAAO,GAAsB,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAErG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAa,EAAQ,EAAE;YAC3C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAgB,EAAQ,EAAE;YAC5C,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAyC,EAAiB,EAAE;YAChF,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAyC;QAClD,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAgB,EAAQ,EAAE;YAC5C,MAAM,KAAK,GAAY,OAAO,EAAE,CAAC,+BAAe,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC;YAEzF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,oFAAoF;IACpF,SAAS,CAAC,WAAkC,6CAAqB,CAAC,YAAY;QAC5E,OAAO,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,MAAM,IAAI,wCAAiB,CAAC,IAAI,CAAC;IACnE,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,KAAc,EAAE,WAAkC,6CAAqB,CAAC,YAAY;QAC7F,MAAM,KAAK,GAAoB;YAC7B,cAAc,EAAE,6CAAmB,CAAC,cAAc,EAAE,KAAK,EAAE,6CAAmB,CAAC,KAAK;YACpF,IAAI,EAAE,6CAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,6CAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,6CAAmB,CAAC,MAAM;YACxG,GAAG,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS;SAC1C,CAAC;QACF,MAAM,OAAO,GACX,CAAC,KAAK,IAAI,EAAE,CAA0F,CAAC;QACzG,MAAM,MAAM,GAAY,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;QAE5D,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9E,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YAClH,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,cAAc,CAAC;QAC9B,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,OAAO,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAC7D,CAAC;IAED,6CAA6C;IACrC,MAAM,CAAC,QAAQ,CAAC,SAA2B,EAAE,IAAgB;QACnE,MAAM,QAAQ,GAAY,IAAI,CAAC,IAAI,KAAK,+CAAoB,CAAC,OAAO,CAAC;QACrE,MAAM,IAAI,GAAW,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QAChG,MAAM,KAAK,GAAW,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,+CAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC;QACzG,MAAM,MAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CACnD,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAC3E,CAAC;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,SAAS,CAAC,CAAC,GAAW,EAAE,QAAiB,EAAW,EAAE;gBAC3D,IAAI,CAAC;oBACH,MAAM,SAAS,GAAY,+BAAe,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oBAE9D,OAAO,IAAI,CAAC,IAAI,KAAK,+CAAoB,CAAC,IAAI,CAAC,CAAC;wBAC9C,CAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC5E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,SAAS,CAAC,oBAAoB,CAAE,KAAoB,CAAC,aAAa,IAAK,KAAe,CAAC,OAAO,CAAC,CAAC;gBAC5G,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uFAAuF;IAC/E,MAAM,CAAC,cAAc,CAC3B,SAA+C,EAC/C,OAAqD;QAErD,MAAM,QAAQ,GAAa,CAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAE,CAAC;QAEtF,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,OAAO,EAAE,IAAI,CAAqB,EAAQ,EAAE;YACrF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAK,IAAe,GAAG,CAAC,IAAK,IAAe,GAAG,GAAG,EAAE,CAAC;gBAC7G,MAAM,OAAO,CAAC,eAAe,EAAE,aAAa,OAAO,gDAAgD,CAAC,CAAC;YACvG,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4FAA4F;IACpF,MAAM,CAAC,OAAO,CAAC,IAAY,EAAE,MAAc,EAAE,aAAqB;QACxE,OAAO,IAAI,uBAAU,CAAC;YACpB,MAAM,EAAE,GAAG;YACX,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,IAAI,IAAI,EAAE;YACjE,OAAO,EAAE,6CAA6C,MAAM,EAAE;YAC9D,iBAAiB,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE;SACpD,CAAC,CAAC;IACL,CAAC;CACF;AA9QD,oDA8QC"}

package/build/_modules/cli/_models/interfaces/cli-flag.interface.d.ts

@@ -0,0 +1,47 @@
+import { DyCLI_FlagValue_Type } from '../../_enums/cli-flag-value.type-enum';
+/**
+ * The per-parameter flag settings of a command (HP-DOPL MP-4.2): an override of a flag generated from the operation's
+ * input schema, or an extra flag the operation does not have. Every field is optional for an override.
+ */
+export interface DyCLI_Flag_Settings {
+    /** The long flag without dashes (kebab-case); default: the parameter name in kebab-case (`noteId` → `note-id`). */
+    flag?: string;
+    /** A one-letter short flag (`l` → `-l`). */
+    short?: string;
+    /** The help text; default: the schema description. */
+    description?: string;
+    /** The value kind; default: from the schema type (required for an extra flag). */
+    type?: DyCLI_FlagValue_Type;
+    /** Allowed values. */
+    enum?: (string | number)[];
+    /** Whether the flag must be given. */
+    required?: boolean;
+    /** The value when the flag is not given. */
+    default?: unknown;
+    /** A custom converter of the raw text; runs instead of the built-in conversion of `type`. */
+    parse?(raw: string): unknown;
+}
+/** A resolved flag of a command — what `DyCLI_Command_Params.flags` holds (HP-DOPL MP-4.2). */
+export interface DyCLI_Flag {
+    /** The value name (the operation input / body property / guardrail argument name, e.g. `noteId`). */
+    param: string;
+    /** The long flag without dashes (e.g. `note-id`). */
+    flag: string;
+    /** The one-letter short flag. */
+    short?: string;
+    /** The help text. */
+    description: string;
+    /** The value kind. */
+    type: DyCLI_FlagValue_Type;
+    /** The kind of one item of a `list` flag (`string` or `number`). */
+    itemType?: DyCLI_FlagValue_Type;
+    /** Allowed values. */
+    enum?: (string | number)[];
+    /** Whether the flag must be given. */
+    required: boolean;
+    /** The value when the flag is not given. */
+    default?: unknown;
+    /** A custom converter of the raw text. */
+    parse?(raw: string): unknown;
+}
+//# sourceMappingURL=cli-flag.interface.d.ts.map

package/build/_modules/cli/_models/interfaces/cli-flag.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flag.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/cli/_models/interfaces/cli-flag.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAG7E;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,mHAAmH;IACnH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,sBAAsB;IACtB,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6FAA6F;IAC7F,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AAED,+FAA+F;AAC/F,MAAM,WAAW,UAAU;IACzB,qGAAqG;IACrG,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,sBAAsB;IACtB,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B"}

package/build/_modules/cli/_models/interfaces/cli-flag.interface.js

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

package/build/_modules/cli/_models/interfaces/cli-flag.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flag.interface.js","sourceRoot":"","sources":["../../../../../src/_modules/cli/_models/interfaces/cli-flag.interface.ts"],"names":[],"mappings":""}

package/build/_modules/cli/_models/interfaces/cli-settings.interface.d.ts

@@ -0,0 +1,25 @@
+import { DyCLI_Output_Type } from '../../_enums/cli-output.type-enum';
+/** The exit codes of the command outcomes (HP-DOPL MP-4.2); every value is an integer between 1 and 255. */
+export interface DyCLI_ExitCodes {
+    /** A local error without a status (default `1`). */
+    operationError: number;
+    /** Invalid arguments (default `2`). */
+    usage: number;
+    /** 401/403 (default `10`). */
+    auth: number;
+    /** The server could not be reached (default `11`). */
+    network: number;
+    /** Any other error status (default `12`). */
+    remote: number;
+}
+/**
+ * CLI-wide defaults (`DyNTS_global_settings.cli_settings`, HP-DOPL MP-4.2). `null` (the default) means every field below
+ * takes its documented default; a command's own settings win.
+ */
+export interface DyCLI_Settings {
+    /** The default output of the commands; default: `json`. */
+    output?: DyCLI_Output_Type;
+    /** Exit-code overrides; default: `DyCLI_ExitCode_Type`. */
+    exitCodes?: Partial<DyCLI_ExitCodes>;
+}
+//# sourceMappingURL=cli-settings.interface.d.ts.map

package/build/_modules/cli/_models/interfaces/cli-settings.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-settings.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/cli/_models/interfaces/cli-settings.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,4GAA4G;AAC5G,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACtC"}

package/build/_modules/cli/_models/interfaces/cli-settings.interface.js

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

package/build/_modules/cli/_models/interfaces/cli-settings.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-settings.interface.js","sourceRoot":"","sources":["../../../../../src/_modules/cli/_models/interfaces/cli-settings.interface.ts"],"names":[],"mappings":""}

package/build/_modules/cli/index.d.ts

@@ -0,0 +1,9 @@
+export * from './_enums/cli-exit-code.type-enum';
+export * from './_enums/cli-flag-value.type-enum';
+export * from './_enums/cli-output.type-enum';
+export * from './_models/interfaces/cli-flag.interface';
+export * from './_models/interfaces/cli-settings.interface';
+export * from './_models/control-models/cli-command-params.control-model';
+export * from './_collections/cli-commander.util';
+export * from './_collections/cli-flag.util';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":"AAOA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,6CAA6C,CAAC;AAG5D,cAAc,2DAA2D,CAAC;AAG1E,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC"}

package/build/_modules/cli/index.js

@@ -0,0 +1,19 @@
+"use strict";
+// CLI MODULE (HP-DOPL MP-4, D-4/D-5) — `@futdevpro/nts-dynamo/cli`: CLI commands from the same operation settings as
+// the REST endpoints and the MCP tools. `commander` is an OPTIONAL peer, loaded lazily; the root `index.ts` does NOT
+// re-export this module, so a server never needs `commander`.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// ENUMS
+tslib_1.__exportStar(require("./_enums/cli-exit-code.type-enum"), exports);
+tslib_1.__exportStar(require("./_enums/cli-flag-value.type-enum"), exports);
+tslib_1.__exportStar(require("./_enums/cli-output.type-enum"), exports);
+// INTERFACES
+tslib_1.__exportStar(require("./_models/interfaces/cli-flag.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/cli-settings.interface"), exports);
+// CONTROL MODELS
+tslib_1.__exportStar(require("./_models/control-models/cli-command-params.control-model"), exports);
+// COLLECTIONS
+tslib_1.__exportStar(require("./_collections/cli-commander.util"), exports);
+tslib_1.__exportStar(require("./_collections/cli-flag.util"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":";AAEA,qHAAqH;AACrH,qHAAqH;AACrH,8DAA8D;;;AAE9D,QAAQ;AACR,2EAAiD;AACjD,4EAAkD;AAClD,wEAA8C;AAE9C,aAAa;AACb,kFAAwD;AACxD,sFAA4D;AAE5D,iBAAiB;AACjB,oGAA0E;AAE1E,cAAc;AACd,4EAAkD;AAClD,uEAA6C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.304",
+  "version": "01.15.307",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -203,6 +203,12 @@
       "types": "./build/_modules/mcp/index.d.ts",
       "typings": "./build/_modules/mcp/index.d.ts"
     },
+    "./cli": {
+      "default": "./build/_modules/cli/index.js",
+      "module": "./build/_modules/cli/index.js",
+      "types": "./build/_modules/cli/index.d.ts",
+      "typings": "./build/_modules/cli/index.d.ts"
+    },
     "./admin-auth": {
       "default": "./build/_modules/admin-auth/index.js",
       "module": "./build/_modules/admin-auth/index.js",
@@ -378,6 +384,9 @@
       "mcp": [
         "build/_modules/mcp/index.d.ts"
       ],
+      "cli": [
+        "build/_modules/cli/index.d.ts"
+      ],
       "admin-auth": [
         "build/_modules/admin-auth/index.d.ts"
       ],
@@ -452,6 +461,7 @@
     "@anthropic-ai/sdk": "~0.39.0",
     "@modelcontextprotocol/sdk": "~1.29.0",
     "better-sqlite3": "~12.4.1",
+    "commander": ">=12.1.0 <15",
     "@futdevpro/fsm-dynamo": ">=1.20.64 <2",
     "@types/express": "4.17.21",
     "@types/geoip-lite": "~1.4.4",
@@ -479,6 +489,9 @@
     "better-sqlite3": {
       "optional": true
     },
+    "commander": {
+      "optional": true
+    },
     "discord.js": {
       "optional": true
     },
@@ -510,9 +523,11 @@
     "@modelcontextprotocol/sdk": "~1.29.0",
     "@types/better-sqlite3": "~7.6.13",
     "better-sqlite3": "~12.4.1",
+    "commander": "~14.0.3",
     "decimal.js": "10.6.0",
     "discord.js": "~14.24.2",
     "eslint": "~9.39.5",
+    "express": "~4.22.2",
     "eslint-plugin-import": "^2.29.0",
     "eslint-plugin-jsdoc": "^48.0.0",
     "eslint-plugin-max-params-no-constructor": "^0.0.4",