@futdevpro/nts-dynamo 1.15.306 → 1.15.308

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

@@ -0,0 +1,116 @@
+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_CommonOptions } from '../interfaces/cli-common-options.interface';
+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); `common` = the parsed common options. */
+    action?(values: DyCLI_CommandValues, params: DyCLI_Command_Params, common?: DyCLI_CommonOptions): 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, common?: DyCLI_CommonOptions): 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":"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"}

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

@@ -0,0 +1,20 @@
+/**
+ * The common options every command of a `DyCLI_Program_ControlService` gets (HP-DOPL MP-4.3): `--json --pretty --dry-run`
+ * always, `--api-key --base-url --timeout` on commands that call a server operation. A command flag with the same name
+ * wins — e.g. the `dryRun` guardrail argument of an operation is a value of the call, not a common option.
+ */
+export interface DyCLI_CommonOptions {
+    /** Force the JSON envelope, whatever the command's output. */
+    json?: boolean;
+    /** Indent the JSON envelope. */
+    pretty?: boolean;
+    /** Validate and preview without saving (when the command has no own `--dry-run`). */
+    dryRun?: boolean;
+    /** The API key of the server call. */
+    apiKey?: string;
+    /** The server base URL. */
+    baseUrl?: string;
+    /** The server call timeout in milliseconds. */
+    timeoutMs?: number;
+}
+//# sourceMappingURL=cli-common-options.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-common-options.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/cli/_models/interfaces/cli-common-options.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/build/_modules/cli/_models/interfaces/cli-common-options.interface.js

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

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

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

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

@@ -0,0 +1,28 @@
+/** The error part of a failed command envelope (HP-DOPL MP-4.3). */
+export interface DyCLI_EnvelopeError {
+    /** A stable error code (e.g. `NIT|DyNTS-CLP-VAL`, `INVALID_ARGS`). */
+    code: string;
+    /** What went wrong, for the caller. */
+    message: string;
+    /** What the caller can do next, when known. */
+    nextStep?: string;
+}
+/**
+ * The result envelope of every Dynamo CLI command (HP-DOPL MP-4.3) — the organizer `fo` shape, which the fleet CLIs
+ * copy: `{ ok, action, requestId, elapsedMs, result | error }`. Success goes to stdout, failure to stderr.
+ */
+export interface DyCLI_Envelope {
+    /** Whether the command succeeded. */
+    ok: boolean;
+    /** The command name (`cli.parse` for an argument error). */
+    action: string;
+    /** A unique id of this call. */
+    requestId: string;
+    /** The run time of the command in milliseconds. */
+    elapsedMs: number;
+    /** The result of a successful command. */
+    result?: unknown;
+    /** The error of a failed command. */
+    error?: DyCLI_EnvelopeError;
+}
+//# sourceMappingURL=cli-envelope.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-envelope.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/cli/_models/interfaces/cli-envelope.interface.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B"}

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

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

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

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

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":""}