@signageos/cli 2.6.0 → 2.7.0

package/dist/Device/Connect/connectCommand.d.ts

@@ -64,7 +64,7 @@ declare const OPTION_LIST: readonly [{
  * The command sets up a development server and configures the device to load the applet
  * from the local machine, enabling hot reload and live debugging capabilities.
  *
- * @group Management:1
+ * @group Management:11
  *
  * @example
  * ```bash

package/dist/Device/Connect/connectCommand.js

@@ -53,7 +53,7 @@ const OPTION_LIST = [
  * The command sets up a development server and configures the device to load the applet
  * from the local machine, enabling hot reload and live debugging capabilities.
  *
- * @group Management:1
+ * @group Management:11
  *
  * @example
  * ```bash

package/dist/Device/Content/setContentCommand.d.ts

@@ -15,30 +15,36 @@ declare const OPTION_LIST: readonly [{
     readonly name: "device-uid";
     readonly type: StringConstructor;
     readonly description: "Device UID";
+}, {
+    readonly name: "yes";
+    readonly type: BooleanConstructor;
+    readonly description: "Skip selection prompts (requires explicit device-uid and applet-uid for safety)";
 }];
 /**
  * Deploys an applet to a specific device by creating a timing configuration
  * that activates the specified applet version on the target device. This command
  * establishes the applet-to-device relationship for production deployment.
  *
- * @group Management:3
+ * @group Management:13
  *
  * @example
  * ```bash
- * # Deploy applet to device
+ * # Deploy applet to device (interactive, allows selection if multiple versions exist)
  * sos device set-content --device-uid device123 --applet-uid my-applet
  *
+ * # Skip selection prompts (requires explicit UIDs, fails if multiple versions)
+ * sos device set-content --device-uid device123 --applet-uid my-applet --yes
+ *
  * # Deploy with organization override
  * sos device set-content --device-uid device123 --applet-uid my-applet --organization-uid org456
  * ```
  *
+ * @throws {Error} When device-uid or applet-uid arguments are missing
+ * @throws {Error} When multiple applets/versions exist and --yes is used
  * @throws {Error} When device or applet cannot be found or accessed
- *
  * @throws {Error} When timing configuration creation fails
- *
  * @throws {Error} When organization access is denied
- *
- * @throws {Error} When applet version cannot be determined
+ * @throws {Error} When user cancels interactive prompts (without `--yes`)
  *
  * @since 0.9.0
  */
@@ -61,6 +67,10 @@ export declare const setContent: {
         readonly name: "device-uid";
         readonly type: StringConstructor;
         readonly description: "Device UID";
+    }, {
+        readonly name: "yes";
+        readonly type: BooleanConstructor;
+        readonly description: "Skip selection prompts (requires explicit device-uid and applet-uid for safety)";
     }];
     commands: never[];
     run(options: CommandLineOptions<typeof OPTION_LIST>): Promise<void>;

package/dist/Device/Content/setContentCommand.js

@@ -20,30 +20,42 @@ const commandDefinition_1 = require("../../Command/commandDefinition");
 const helper_1 = require("../../helper");
 const organizationFacade_1 = require("../../Organization/organizationFacade");
 const deviceFacade_1 = require("../deviceFacade");
-const OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, organizationFacade_1.ORGANIZATION_UID_OPTION, appletFacade_1.APPLET_UID_OPTION, deviceFacade_1.DEVICE_UID_OPTION];
+const OPTION_LIST = [
+    organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION,
+    organizationFacade_1.ORGANIZATION_UID_OPTION,
+    appletFacade_1.APPLET_UID_OPTION,
+    deviceFacade_1.DEVICE_UID_OPTION,
+    {
+        name: 'yes',
+        type: Boolean,
+        description: 'Skip selection prompts (requires explicit device-uid and applet-uid for safety)',
+    },
+];
 /**
  * Deploys an applet to a specific device by creating a timing configuration
  * that activates the specified applet version on the target device. This command
  * establishes the applet-to-device relationship for production deployment.
  *
- * @group Management:3
+ * @group Management:13
  *
  * @example
  * ```bash
- * # Deploy applet to device
+ * # Deploy applet to device (interactive, allows selection if multiple versions exist)
  * sos device set-content --device-uid device123 --applet-uid my-applet
  *
+ * # Skip selection prompts (requires explicit UIDs, fails if multiple versions)
+ * sos device set-content --device-uid device123 --applet-uid my-applet --yes
+ *
  * # Deploy with organization override
  * sos device set-content --device-uid device123 --applet-uid my-applet --organization-uid org456
  * ```
  *
+ * @throws {Error} When device-uid or applet-uid arguments are missing
+ * @throws {Error} When multiple applets/versions exist and --yes is used
  * @throws {Error} When device or applet cannot be found or accessed
- *
  * @throws {Error} When timing configuration creation fails
- *
  * @throws {Error} When organization access is denied
- *
- * @throws {Error} When applet version cannot be determined
+ * @throws {Error} When user cancels interactive prompts (without `--yes`)
  *
  * @since 0.9.0
  */
@@ -57,9 +69,10 @@ exports.setContent = (0, commandDefinition_1.createCommandDefinition)({
             const organizationUid = yield (0, organizationFacade_1.getOrganizationUidOrDefaultOrSelect)(options);
             const organization = yield (0, organizationFacade_1.getOrganization)(organizationUid);
             const restApi = yield (0, helper_1.createOrganizationRestApi)(organization);
-            const appletUid = yield (0, appletFacade_1.getAppletUid)(restApi, options);
-            const appletVersion = yield (0, appletFacade_1.getAppletVersionFromApi)(restApi, appletUid);
-            const deviceUid = yield (0, deviceFacade_1.getDeviceUid)(restApi, options);
+            const skipConfirmation = !!options.yes;
+            const appletUid = yield (0, appletFacade_1.getAppletUid)(restApi, options, skipConfirmation);
+            const appletVersion = yield (0, appletFacade_1.getAppletVersionFromApi)(restApi, appletUid, skipConfirmation);
+            const deviceUid = yield (0, deviceFacade_1.getDeviceUid)(restApi, options, skipConfirmation);
             yield restApi.timing.create({
                 deviceUid: deviceUid,
                 appletUid: appletUid,

package/dist/Device/PowerAction/powerActionCommand.d.ts

@@ -22,7 +22,7 @@ declare const OPTION_LIST: readonly [{
  * This command provides remote device management capabilities for troubleshooting
  * and maintenance operations.
  *
- * @group Management:2
+ * @group Management:12
  *
  * @example
  * ```bash

package/dist/Device/PowerAction/powerActionCommand.js

@@ -26,7 +26,7 @@ const OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, organi
  * This command provides remote device management capabilities for troubleshooting
  * and maintenance operations.
  *
- * @group Management:2
+ * @group Management:12
  *
  * @example
  * ```bash

package/dist/Device/deviceCommand.d.ts

@@ -2,7 +2,7 @@
  * Provides commands for managing signageOS devices, including connecting to devices
  * for development, controlling device power states, and managing applet deployment.
  *
- * @group Management:3
+ * @group Management:200
  *
  * @example
  * ```bash
@@ -41,6 +41,10 @@ export declare const device: {
             readonly name: "device-uid";
             readonly type: StringConstructor;
             readonly description: "Device UID";
+        }, {
+            readonly name: "yes";
+            readonly type: BooleanConstructor;
+            readonly description: "Skip selection prompts (requires explicit device-uid and applet-uid for safety)";
         }];
         commands: never[];
         run(options: import("../Command/commandDefinition").CommandLineOptions<readonly [{
@@ -59,6 +63,10 @@ export declare const device: {
             readonly name: "device-uid";
             readonly type: StringConstructor;
             readonly description: "Device UID";
+        }, {
+            readonly name: "yes";
+            readonly type: BooleanConstructor;
+            readonly description: "Skip selection prompts (requires explicit device-uid and applet-uid for safety)";
         }]>): Promise<void>;
     } | {
         name: "power-action";

package/dist/Device/deviceCommand.js

@@ -18,7 +18,7 @@ const commandDefinition_1 = require("../Command/commandDefinition");
  * Provides commands for managing signageOS devices, including connecting to devices
  * for development, controlling device power states, and managing applet deployment.
  *
- * @group Management:3
+ * @group Management:200
  *
  * @example
  * ```bash

package/dist/Device/deviceFacade.d.ts

@@ -17,6 +17,6 @@ export declare const POWER_ACTION_TYPE_OPTION: {
     readonly type: StringConstructor;
     readonly description: "Type of device power action";
 };
-export declare function getDeviceUid(restApi: RestApi, options: CommandLineOptions<[typeof DEVICE_UID_OPTION]>): Promise<string>;
+export declare function getDeviceUid(restApi: RestApi, options: CommandLineOptions<[typeof DEVICE_UID_OPTION]>, skipConfirmation?: boolean): Promise<string>;
 export declare function getActionType(options: CommandLineOptions<[typeof POWER_ACTION_TYPE_OPTION]>): Promise<string>;
 export declare function disconnectDevice(organization: IOrganization, deviceUid: string): Promise<any>;

package/dist/Device/deviceFacade.js

@@ -35,25 +35,30 @@ exports.typeMap = new Map([
 ]);
 exports.DEVICE_UID_OPTION = { name: 'device-uid', type: String, description: 'Device UID' };
 exports.POWER_ACTION_TYPE_OPTION = { name: 'type', type: String, description: `Type of device power action` };
-function getDeviceUid(restApi, options) {
-    return __awaiter(this, void 0, void 0, function* () {
+function getDeviceUid(restApi_1, options_1) {
+    return __awaiter(this, arguments, void 0, function* (restApi, options, skipConfirmation = false) {
         let deviceUid = options['device-uid'];
         if (!deviceUid) {
-            const devices = yield restApi.device.list();
-            const response = yield (0, prompts_1.default)({
-                type: 'autocomplete',
-                name: 'deviceUid',
-                message: `Select device to use`,
-                choices: devices.map((dev) => {
-                    var _a;
-                    return ({
-                        title: `${(_a = dev.name) !== null && _a !== void 0 ? _a : `Unnamed device, created ${dev.createdAt.toString()}`} (${dev.uid})`,
-                        value: dev.uid,
-                    });
-                }),
-            });
-            Debug('Device selected', response.deviceUid);
-            deviceUid = response.deviceUid;
+            if (skipConfirmation) {
+                throw new Error('Device UID is required. Please specify --device-uid argument.');
+            }
+            else {
+                const devices = yield restApi.device.list();
+                const response = yield (0, prompts_1.default)({
+                    type: 'autocomplete',
+                    name: 'deviceUid',
+                    message: `Select device to use`,
+                    choices: devices.map((dev) => {
+                        var _a;
+                        return ({
+                            title: `${(_a = dev.name) !== null && _a !== void 0 ? _a : `Unnamed device, created ${dev.createdAt.toString()}`} (${dev.uid})`,
+                            value: dev.uid,
+                        });
+                    }),
+                });
+                Debug('Device selected', response.deviceUid);
+                deviceUid = response.deviceUid;
+            }
         }
         if (!deviceUid) {
             throw new Error('Missing argument --device-uid <string>');

package/dist/Organization/Get/organizationGetCommand.d.ts

@@ -13,7 +13,7 @@ declare const OPTION_LIST: readonly [{
  * by its UID. If no organization UID is provided, uses the default organization
  * or prompts for selection from available organizations.
  *
- * @group Management:2
+ * @group Management:22
  *
  * @example
  * ```bash

package/dist/Organization/Get/organizationGetCommand.js

@@ -24,7 +24,7 @@ const OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, organi
  * by its UID. If no organization UID is provided, uses the default organization
  * or prompts for selection from available organizations.
  *
- * @group Management:2
+ * @group Management:22
  *
  * @example
  * ```bash

package/dist/Organization/List/organizationListCommand.d.ts

@@ -3,7 +3,7 @@
  * account has access to. This command helps users understand which organizations
  * they can work with and select appropriate targets for other CLI operations.
  *
- * @group Management:1
+ * @group Management:21
  *
  * @example
  * ```bash

package/dist/Organization/List/organizationListCommand.js

@@ -23,7 +23,7 @@ const Debug = (0, debug_1.default)('@signageos/cli:Organization:list');
  * account has access to. This command helps users understand which organizations
  * they can work with and select appropriate targets for other CLI operations.
  *
- * @group Management:1
+ * @group Management:21
  *
  * @example
  * ```bash

package/dist/Organization/SetDefault/organizationSetDefaultCommand.d.ts

@@ -9,7 +9,7 @@ declare const OPTION_LIST: readonly [{
  * that require an organization context. This eliminates the need to specify the organization
  * UID for each command. The default organization is stored in the ~/.sosrc configuration file.
  *
- * @group Management:3
+ * @group Management:23
  *
  * @example
  * ```bash

package/dist/Organization/SetDefault/organizationSetDefaultCommand.js

@@ -26,7 +26,7 @@ const OPTION_LIST = [organizationFacade_1.ORGANIZATION_UID_OPTION];
  * that require an organization context. This eliminates the need to specify the organization
  * UID for each command. The default organization is stored in the ~/.sosrc configuration file.
  *
- * @group Management:3
+ * @group Management:23
  *
  * @example
  * ```bash

package/dist/Organization/organizationCommand.d.ts

@@ -2,7 +2,7 @@
  * Provides commands to manage signageOS organizations including listing available organizations,
  * retrieving organization details, and setting default organization for CLI operations.
  *
- * @group Management:6
+ * @group Management:201
  *
  * @subcommands
  * - `list` - List all organizations accessible to the current user

package/dist/Organization/organizationCommand.js

@@ -18,7 +18,7 @@ const commandDefinition_1 = require("../Command/commandDefinition");
  * Provides commands to manage signageOS organizations including listing available organizations,
  * retrieving organization details, and setting default organization for CLI operations.
  *
- * @group Management:6
+ * @group Management:201
  *
  * @subcommands
  * - `list` - List all organizations accessible to the current user

package/dist/Plugin/Generate/pluginGenerateCommand.d.ts

@@ -1,7 +1,41 @@
+import { CommandLineOptions } from '../../Command/commandDefinition';
+import { OPTION_LIST } from './pluginGenerateOptions';
+/**
+ * Generates a local repository for developing a Plugin with boilerplate code and configuration files.
+ * Sets up complete development environment with necessary dependencies and project structure.
+ *
+ * Runs interactively by default or non-interactively with `--yes` option.
+ * Requires Git to be installed and accessible.
+ *
+ * @group Development:31
+ *
+ * @example
+ * ```bash
+ * # Generate plugin project interactively
+ * sos plugin generate
+ *
+ * # Generate non-interactively (suitable for CI/CD)
+ * sos plugin generate --name my-plugin --description "My custom plugin" --yes
+ * ```
+ *
+ * @since 2.6.0
+ */
 export declare const pluginGenerate: {
     name: "generate";
     description: string;
-    optionList: never[];
+    optionList: readonly [{
+        readonly name: "name";
+        readonly type: StringConstructor;
+        readonly description: "Plugin name";
+    }, {
+        readonly name: "description";
+        readonly type: StringConstructor;
+        readonly description: "Plugin description";
+    }, {
+        readonly name: "yes";
+        readonly type: BooleanConstructor;
+        readonly description: "Skip confirmation prompts and use provided values";
+    }];
     commands: never[];
-    run(): Promise<void>;
+    run(options: CommandLineOptions<typeof OPTION_LIST>): Promise<void>;
 };

package/dist/Plugin/Generate/pluginGenerateCommand.js

@@ -19,15 +19,37 @@ const commandDefinition_1 = require("../../Command/commandDefinition");
 const git_1 = require("../../Lib/git");
 const customScriptFacade_1 = require("../../CustomScript/customScriptFacade");
 const pluginGenerateFacade_1 = require("./pluginGenerateFacade");
+const pluginGenerateOptions_1 = require("./pluginGenerateOptions");
+/**
+ * Generates a local repository for developing a Plugin with boilerplate code and configuration files.
+ * Sets up complete development environment with necessary dependencies and project structure.
+ *
+ * Runs interactively by default or non-interactively with `--yes` option.
+ * Requires Git to be installed and accessible.
+ *
+ * @group Development:31
+ *
+ * @example
+ * ```bash
+ * # Generate plugin project interactively
+ * sos plugin generate
+ *
+ * # Generate non-interactively (suitable for CI/CD)
+ * sos plugin generate --name my-plugin --description "My custom plugin" --yes
+ * ```
+ *
+ * @since 2.6.0
+ */
 exports.pluginGenerate = (0, commandDefinition_1.createCommandDefinition)({
     name: 'generate',
     description: 'Generates a local repository for developing a Plugin',
-    optionList: [],
+    optionList: pluginGenerateOptions_1.OPTION_LIST,
     commands: [],
-    run() {
+    run(options) {
         return __awaiter(this, void 0, void 0, function* () {
             yield (0, git_1.throwErrorIfGitNotInstalled)();
-            const { targetDir, name, description } = yield (0, pluginGenerateFacade_1.askForParameters)();
+            const skipConfirmation = !!options.yes;
+            const { targetDir, name, description } = yield (0, pluginGenerateFacade_1.askForParameters)(options, skipConfirmation);
             yield (0, pluginGenerateFacade_1.downloadBoilerplateCode)(targetDir);
             yield (0, customScriptFacade_1.addToConfigFile)(targetDir, { name, description });
             (0, log_1.log)('info', `Plugin ${chalk_1.default.green(name)} has been generated in ${chalk_1.default.green(targetDir)}.`);

package/dist/Plugin/Generate/pluginGenerateFacade.d.ts

@@ -1,10 +1,12 @@
+import { CommandLineOptions } from '../../Command/commandDefinition';
+import { OPTION_LIST } from './pluginGenerateOptions';
 /**
- * Prompts the user for the parameters needed to generate a plugin.
+ * Prompts the user for the parameters needed to generate a custom script.
  */
-export declare function askForParameters(): Promise<{
-    targetDir: any;
-    name: any;
-    description: any;
+export declare function askForParameters(options?: CommandLineOptions<typeof OPTION_LIST>, skipConfirmation?: boolean): Promise<{
+    targetDir: string;
+    name: string;
+    description: string;
 }>;
 /**
  * Downloads the latest version of the boilerplate code from the GitHub repository.

package/dist/Plugin/Generate/pluginGenerateFacade.js

@@ -54,39 +54,61 @@ const fs = __importStar(require("fs-extra"));
 const log_1 = require("@signageos/sdk/dist/Console/log");
 const git_1 = require("../../Lib/git");
 /**
- * Prompts the user for the parameters needed to generate a plugin.
+ * Prompts the user for the parameters needed to generate a custom script.
  */
-function askForParameters() {
-    return __awaiter(this, void 0, void 0, function* () {
+function askForParameters(options_1) {
+    return __awaiter(this, arguments, void 0, function* (options, skipConfirmation = false) {
         const throwCanceledError = () => {
             throw new Error('Plugin generation was canceled.');
         };
-        const { name, description } = yield (0, prompts_1.default)([
-            {
+        // Get values from CLI options if provided
+        const nameFromOptions = options === null || options === void 0 ? void 0 : options.name;
+        const descriptionFromOptions = options === null || options === void 0 ? void 0 : options.description;
+        // Determine which prompts are needed
+        const promisesToAsk = [];
+        if (!nameFromOptions) {
+            promisesToAsk.push({
                 type: 'text',
                 name: 'name',
                 message: 'Type name',
                 min: 1,
-            },
-            {
+            });
+        }
+        if (!descriptionFromOptions) {
+            promisesToAsk.push({
                 type: 'text',
                 name: 'description',
                 message: 'Type description',
                 min: 1,
-            },
-        ], { onCancel: throwCanceledError });
+            });
+        }
+        // Only prompt if we need values
+        let promptResults = {};
+        if (promisesToAsk.length > 0) {
+            if (skipConfirmation && (nameFromOptions || descriptionFromOptions)) {
+                // If in non-interactive mode but missing required parameters, throw error
+                throw new Error('Missing required parameters. In non-interactive mode (--yes), you must provide --name and --description options.');
+            }
+            promptResults = yield (0, prompts_1.default)(promisesToAsk, { onCancel: throwCanceledError });
+        }
+        // Use CLI options or prompt results
+        const name = nameFromOptions || promptResults.name;
+        const description = descriptionFromOptions || promptResults.description;
         const targetDir = name;
         (0, log_1.log)('info', `Generating Plugin with these parameters:\n` +
             `  - Directory: ${chalk_1.default.green(targetDir)}\n` +
             `  - Name: ${chalk_1.default.green(name)}\n` +
             `  - Description: ${chalk_1.default.green(description)}\n`);
-        const { confirm } = yield (0, prompts_1.default)({
-            type: 'confirm',
-            name: 'confirm',
-            message: 'Confirm',
-        });
-        if (!confirm) {
-            throwCanceledError();
+        // Skip confirmation if in non-interactive mode
+        if (!skipConfirmation) {
+            const { confirm } = yield (0, prompts_1.default)({
+                type: 'confirm',
+                name: 'confirm',
+                message: 'Confirm',
+            });
+            if (!confirm) {
+                throwCanceledError();
+            }
         }
         return {
             targetDir,

package/dist/Plugin/Generate/pluginGenerateOptions.d.ts

@@ -0,0 +1,13 @@
+export declare const OPTION_LIST: readonly [{
+    readonly name: "name";
+    readonly type: StringConstructor;
+    readonly description: "Plugin name";
+}, {
+    readonly name: "description";
+    readonly type: StringConstructor;
+    readonly description: "Plugin description";
+}, {
+    readonly name: "yes";
+    readonly type: BooleanConstructor;
+    readonly description: "Skip confirmation prompts and use provided values";
+}];

package/dist/Plugin/Generate/pluginGenerateOptions.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPTION_LIST = void 0;
+exports.OPTION_LIST = [
+    {
+        name: 'name',
+        type: String,
+        description: 'Plugin name',
+    },
+    {
+        name: 'description',
+        type: String,
+        description: 'Plugin description',
+    },
+    {
+        name: 'yes',
+        type: Boolean,
+        description: 'Skip confirmation prompts and use provided values',
+    },
+];

package/dist/Plugin/Upload/pluginUploadCommand.d.ts

@@ -7,7 +7,31 @@ export declare const OPTION_LIST: readonly [{
     readonly name: "organization-uid";
     readonly type: StringConstructor;
     readonly description: "Organization UID";
+}, {
+    readonly name: "yes";
+    readonly type: BooleanConstructor;
+    readonly description: "Skip confirmation prompts for plugin or version creation";
 }];
+/**
+ * Uploads current plugin version to the signageOS platform based on configuration
+ * and schema files in the current directory. Handles plugin and version management automatically.
+ *
+ * May prompt for confirmation when creating new plugins or versions.
+ * Use `--yes` to skip confirmation prompts for automated deployments.
+ *
+ * @group Development:32
+ *
+ * @example
+ * ```bash
+ * # Upload plugin from current directory
+ * sos plugin upload
+ *
+ * # Upload with specific organization, skip prompts
+ * sos plugin upload --organization-uid abc123def456 --yes
+ * ```
+ *
+ * @since 2.6.0
+ */
 export declare const pluginUpload: {
     name: "upload";
     description: string;
@@ -19,6 +43,10 @@ export declare const pluginUpload: {
         readonly name: "organization-uid";
         readonly type: StringConstructor;
         readonly description: "Organization UID";
+    }, {
+        readonly name: "yes";
+        readonly type: BooleanConstructor;
+        readonly description: "Skip confirmation prompts for plugin or version creation";
     }];
     commands: never[];
     run(options: CommandLineOptions<typeof OPTION_LIST>): Promise<void>;

package/dist/Plugin/Upload/pluginUploadCommand.js

@@ -23,7 +23,35 @@ const util_1 = require("util");
 const helper_1 = require("../../helper");
 const debug_1 = __importDefault(require("debug"));
 const Debug = (0, debug_1.default)('@signageos/cli:Plugin:Upload:Command');
-exports.OPTION_LIST = [organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION, organizationFacade_1.ORGANIZATION_UID_OPTION];
+exports.OPTION_LIST = [
+    organizationFacade_1.NO_DEFAULT_ORGANIZATION_OPTION,
+    organizationFacade_1.ORGANIZATION_UID_OPTION,
+    {
+        name: 'yes',
+        type: Boolean,
+        description: 'Skip confirmation prompts for plugin or version creation',
+    },
+];
+/**
+ * Uploads current plugin version to the signageOS platform based on configuration
+ * and schema files in the current directory. Handles plugin and version management automatically.
+ *
+ * May prompt for confirmation when creating new plugins or versions.
+ * Use `--yes` to skip confirmation prompts for automated deployments.
+ *
+ * @group Development:32
+ *
+ * @example
+ * ```bash
+ * # Upload plugin from current directory
+ * sos plugin upload
+ *
+ * # Upload with specific organization, skip prompts
+ * sos plugin upload --organization-uid abc123def456 --yes
+ * ```
+ *
+ * @since 2.6.0
+ */
 exports.pluginUpload = (0, commandDefinition_1.createCommandDefinition)({
     name: 'upload',
     description: 'Uploads current plugin version',
@@ -37,7 +65,8 @@ exports.pluginUpload = (0, commandDefinition_1.createCommandDefinition)({
             const restApi = yield (0, helper_1.createOrganizationRestApi)(organization);
             const config = yield (0, customScriptFacade_1.getConfig)(currentDirectory);
             const schema = yield (0, pluginFacade_1.loadSchemas)(currentDirectory);
-            const pluginVersion = yield (0, pluginFacade_1.ensurePluginVersion)(restApi, config, schema);
+            const skipConfirmation = !!options.yes;
+            const pluginVersion = yield (0, pluginFacade_1.ensurePluginVersion)(restApi, config, schema, skipConfirmation);
             for (const platform of Object.keys(config.platforms)) {
                 const platformConfig = config.platforms[platform];
                 if (!platformConfig) {