@suitegeezus/suitecloud-cli 3.1.6-1 → 3.1.6-3

package/DELTA.md

@@ -2,18 +2,27 @@
 
 - binary name is `sdf` (not `suitecloud`)
 - package name is `@suitegeezus/suitecloud-cli`
-- `package.json#configFile` can be used to set expected names of config files to hunt for
-- environment variables for AUTHID, PROJECTFOLDER, PROJECTPATH
-- `authid` option available on many commands
-- `project` option available on many commands (to find resource files)
-- `config` option available on many command (to be exact about config file to use)
-- `customflag` option available on any command
-- `customoptions` option available on any command
+- hunts for a config file in the directory tree
+  - `package.json#configFile` can be used to set expected names of config files to hunt for
+- environment variables while running:
+  - SUITECLOUD_AUTHID
+  - SUITECLOUD_PROJECT_FOLDER
+  - SUITECLOUD_PROJECT_PATH
+  - SUITECLOUD_PROJECT_ROOT
+  - SUITECLOUD_EXE
+- `authid` option available on any command including in interactive
+- `project` option available on any commands (to find resource files) including in interactive
+- `config` option available on any command (to be exact about config file to use) including in interactive
+- `noconfig` option available on any command including in interactive
+- `customflag` option available on any command including in interactive
+- `customoptions` option available on any command including in interactive
 - `debug` option available on any command including in interactive
+- `skiphooks` option available on any command including in interactive
 
 <p align="left"><a href="#"><img width="250" src="resources/Netsuite-logo-ocean-150-bg.png"></a></p>
 
-- It can coexist with the regular version. You can install both at the same time. But why.
+- It can coexist with the regular version. You can install both at the same time.
+  - But why.
 - They will share account credentials and the underlying SDK. They will reference the same `~/.suitecloud-sdk` resource folder. 
 - Example, They can use different config files and not conflict with each other within the same project.
 - By default, this uses `sdf.config.js`.
@@ -103,9 +112,7 @@ Note: this example does not require a config file
 | [`account:setup`](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_89132630266.html)            | Sets up an account to use with SuiteCloud SDK and configures the default auth ID for the SuiteCloud project. It requires browser-based login to NetSuite.                                                                        |
 | [`account:setup:ci`](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_81134826821.html)         | Sets up an account to use with SuiteCloud SDK and configures the default auth ID for the SuiteCloud project. It does not require browser-based login to NetSuite. This command is helpful for automated environments such as CI. |
 | `custom:hello`                                                                                                       | A sanity command to check configuration. You can use hooks but you should leave it ias it is.                                                                                                                                    |
-| `custom:pass`                                                                                                        | A passthrough command that does nothing. You can build hooks for it                                                                                                                                                              |
-| `custom:job`                                                                                                         | Run pre-configured commands such as running admindocs queries.  This also supports hooks                                                                                                                                         |
-| `custom:config`                                                                                                      | Show location and contents of config file |
+| `custom:hook`                                                                                                        | A passthrough command that does nothing. You can build hooks for it                                                                                                                                                              |
 | [`file:create`](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_162810635242.html)             | Creates SuiteScript files in the selected folder using the correct template with SuiteScript modules injected.                                                                                                                   |
 | [`file:import`](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_156041963273.html)             | Imports files from an account to your account customization project.                                                                                                                                                             |
 | [`file:list`](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_156042966488.html)               | Lists the files in the File Cabinet of your account.                                                                                                                                                                             |
@@ -149,7 +156,7 @@ sdf custom:config --show
 
 #### Project Folder & Project Root
 
-The projectFolder is not the location of the `sdf.config.js`. It can be anywhere on your file system, but typically it is the same directory or a subDirectory of the project. It can be overridden in some commands using the `--project` flag
+The projectFolder is not necessarily the location of the `sdf.config.js`. It can be anywhere on your file system, but typically it is the same directory or a subDirectory of the project. It can be overridden in some commands using the `--project` flag
 
 If the config (or command line override) specifies a value for `defaultProjectFolder` then that value is appended to the project root to determine the `projectFolder`. That location is expected to contain things such as:
 
@@ -162,8 +169,7 @@ If the config (or command line override) specifies a value for `defaultProjectFo
 many `sdf` commands can run without any config file. You may need to provide additional command line flags in lieu.
 
 There are some commands where a `manifest.xml` file or `deploy.xml` file is required in the discovered root, but the file isn't actually
-use. In this case you could use the hook to detect this and create a dummy file and then remove it onCompleted.
-TODO:  use `--forceManifest` which will create a temporary `manifest.xml` file and then remove it when done.
+used. In this case you could use the hook to detect this and create a dummy file and then remove it onCompleted.
 
 Ranked from top priority to bottom priority
 

package/README.md

@@ -2,9 +2,9 @@
 
 # SuiteCloud CLI for Node.js
 <p>
-  <a href="https://www.npmjs.com/package/@oracle/suitecloud-cli">
-    <img src="https://img.shields.io/npm/dm/@oracle/suitecloud-cli.svg" alt="npm-cli"/>
-    <img src="https://img.shields.io/npm/v/@oracle/suitecloud-cli.svg" alt="npm-cli"/>
+  <a href="https://www.npmjs.com/package/@suitegeezus/suitecloud-cli">
+    <img src="https://img.shields.io/npm/dm/@suitegeezus/suitecloud-cli.svg" alt="npm-cli"/>
+    <img src="https://img.shields.io/npm/v/@suitegeezus/suitecloud-cli.svg" alt="npm-cli"/>
   </a>
 </p>
 
@@ -19,35 +19,30 @@ The following software is required to work with SuiteCloud CLI for Node.js:
 Read the full list of prerequisites in [SuiteCloud CLI for Node.js Installation Prerequisites](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_1558708810.html).
 
 ## Supported Versions
-To ensure that you get the latest features and bug fixes, you should use the latest version of the SuiteCloud CLI for Node.js available in NPM. 
+This is a fork of `@oracle/suitecloud-cli`. It supports older command lines but with a new binary `sdf`. 
 
-The following table shows the CLI versions currently available in NPM.
-
-| CLI Versions Available in NPM | 
-|:-----------------------------:|
-| 3.1.2 |
-| 3.1.1 |
+It is enhanced for easier customizing via hooks. See [./DELTA.md] for more
 
 
 ## Installation
 Since CLI for Node.js is a development tool, use a global instance to install it by running the following command:
 
 ```
-npm install -g @oracle/suitecloud-cli
+npm install -g @suitegeezus/suitecloud-cli
 ```
 When installing SuiteCloud CLI for Node.js via script, for instance in a CI environment, you can skip showing the license presented during the normal installation process by adding the --acceptSuiteCloudSDKLicense flag to the install script as shown below. Note that by adding the mentioned flag to the script, you confirm that you have read and accepted the Oracle Free Use Terms and Conditions license. See the [License](#license) section for details.
 
 ```
-npm install -g --acceptSuiteCloudSDKLicense @oracle/suitecloud-cli
+npm install -g --acceptSuiteCloudSDKLicense @suitegeezus/suitecloud-cli
 ```
 
 
-CLI for Node.js is available from within any directory by running `suitecloud`.
+CLI for Node.js is available from within any directory by running `sdf`.
 
 ## Usage
 CLI for Node.js uses the following syntax: 
 ```
-suitecloud <command> <option> <argument>
+sdf <command> <option> <argument>
 ```
 
 ### Commands
@@ -71,7 +66,7 @@ suitecloud <command> <option> <argument>
 
 To check the help for a specific command, run the following command:
 ```
-suitecloud {command} -h
+sdf {command} -h
 ```
 
 Read the detailed documentation for all the commands in [SuiteCloud CLI for Node.js Reference](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/chapter_155931263126.html).
@@ -84,12 +79,12 @@ Read the detailed documentation for all the commands in [SuiteCloud CLI for Node
 
 Create a new project in an empty folder by running the following command:
 ```
-suitecloud project:create -i
+sdf project:create -i
 ```
 
 After you create a project, configure a NetSuite account, by running the following command within the project folder:
 ```
-suitecloud account:setup
+sdf account:setup
 ```
 
 ## Release Notes & Documentation

package/messages.json

@@ -259,7 +259,7 @@
 	"ERRORS_FILE": "There was an error in the file {0}: \n",
 	"ERRORS_FILE_NOT_EXIST": "The file {0} was not found in the project.",
 	"ERRORS_GENERAL_CONNECTION_PROBLEM": "There was an error when communicating with the server. Try again later.",
-	"ERRORS_INTERACTIVE_MODE_MORE_OPTIONS": "The '-i' option cannot be used in combination with other options. Use either the '-i' option, or the other options you specified.",
+	"ERRORS_INTERACTIVE_MODE_MORE_OPTIONS": "The '-i' option cannot be used in combination with certain options. Use either the '-i' option, or remove the non-interactive options you specified.",
 	"ERRORS_MISSING_DEFAULT_AUTH_ID": "The \"{0}\" property or \"{1}\" option is missing.",
 	"ERRORS_NO_OBJECTS": "There are no objects matching your search criteria. Select a different set of object types, and if applicable, check the specified application ID and script ID.",
 	"ERRORS_NOT_PROJECT_FOLDER": "No {0} file was found in {1}. Run \"{2}\" in a valid project folder.",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@suitegeezus/suitecloud-cli",
-	"version": "3.1.6-1",
+	"version": "3.1.6-3",
 	"license": "UPL-1.0",
 	"description": "SuiteCloud CLI for Node.js",
 	"keywords": [

package/src/ApplicationConstants.js

@@ -77,6 +77,7 @@ module.exports = {
 		SUITECLOUD_PROJECT_FOLDER: 'SUITECLOUD_PROJECT_FOLDER',
 		SUITECLOUD_PROJECT_PATH: 'SUITECLOUD_PROJECT_PATH',
 		SUITECLOUD_PROJECT_ROOT: 'SUITECLOUD_PROJECT_ROOT',
+		SUITECLOUD_EXE: 'SUITECLOUD_EXE'
 	},
 	HTTP_RESPONSE_CODE: {
 		UNAUTHORIZED: 401,

package/src/CLI.js

@@ -28,6 +28,87 @@ const HELP_COMMAND = 'help';
 const HELP_OPTION = '--help';
 const HELP_ALIAS = '-h';
 const VERSION_OPTION = '--version';
+const UBIQUITOUS_OPTIONS = {
+	"config": {
+		"name": "config",
+		"option": "config",
+		"description": "Specify a config file to use. Otherwise cli will discover closest config file",
+		"allowInteractive":true,
+		"mandatory": false,
+		"type": "SINGLE",
+		"usage": "\"./path/to/sdf.config.alt.js\"",
+		"defaultOption": false,
+		"disableInIntegrationMode": false,
+		"forceinclude": false,
+		"conflicts": ["noconfig"]
+	},
+	"noconfig": {
+		"name": "noconfig",
+		"option": "noconfig",
+		"description": "Do not use any config file",
+		"allowInteractive":true,
+		"mandatory": false,
+		"type": "FLAG",
+		"usage": "",
+		"forceinclude": true,
+		"defaultOption": false,
+		"disableInIntegrationMode": false,
+		"conflicts": ["config"]
+	},
+	"customflag": {
+		"name": "customflag",
+		"option": "customflag",
+		"description": "A custom boolean that will be passed into the hooks. Has no effect unless you implement the logic in a hook",
+		"allowInteractive":true,
+		"mandatory": false,
+		"type": "FLAG",
+		"usage": "",
+		"forceinclude": true,
+		"defaultOption": false,
+		"disableInIntegrationMode": false
+	},
+	"customoptions": {
+		"name": "customoptions",
+		"option": "customoptions",
+		"description": "Custom string values that will be passed into the hooks. Has no effect unless you implement the logic in a hook",
+		"allowInteractive":true,
+		"mandatory": false,
+		"type": "MULTIPLE",
+		"usage": "\"value1\" \"value2\"",
+		"forceinclude": true,
+		"defaultOption": undefined,
+		"disableInIntegrationMode": false
+	},
+	"debug": {
+		"name": "debug",
+		"option": "debug",
+		"description": "Directory to dump debug data for debugging. Creates a \"debug-{command}.json\" file in specified directory.\nUsage: \"--debug .\"",
+		"allowInteractive":true,
+		"mandatory": false,
+		"type": "SINGLE",
+		"usage": "--debug \"./tmpdir",
+		"forceinclude": true,
+		"defaultOption": false,
+		"disableInIntegrationMode": false
+	},
+	"skiphooks": {
+		"name": "skiphooks",
+		"option": "skiphooks",
+		"description": "Skip hook execution. Usage:\n" + [
+			'"--skiphooks all" (skip all)',
+			'"--skiphooks pre" (skip beforeExecuting)',
+			'"--skiphooks post" (skip onCompleted/onError)',
+			'"--skiphooks none" (skip nothing -- default)'
+		].join('\n'),
+		"allowInteractive":true,
+		"forceinclude": true,
+		"mandatory": false,
+		"type": "SINGLE",
+		"usage": "\"pre|post|all|none\"",
+		"defaultOption": "none",
+		"disableInIntegrationMode": false
+	}
+};
 
 module.exports = class CLI {
 	constructor(dependencies) {
@@ -76,7 +157,7 @@ module.exports = class CLI {
 				.option(
 					`${INTERACTIVE_ALIAS}, ${INTERACTIVE_OPTION}`,
 					NodeTranslationService.getMessage(INTERACTIVE_OPTION_DESCRIPTION),
-					this._validateInteractive
+					this._validateInteractive(commandMetadataList[thirdArgument].options)
 				)
 				.helpOption(`${HELP_ALIAS}, ${HELP_OPTION}`, NodeTranslationService.getMessage(COMMAND_OPTIONS.HELP))
 				.addHelpCommand(`${HELP_COMMAND} ${COMMAND_ALIAS}`, NodeTranslationService.getMessage(COMMAND_OPTIONS.HELP))
@@ -104,14 +185,26 @@ module.exports = class CLI {
 		return process.argv.includes(INTERACTIVE_ALIAS) || process.argv.includes(INTERACTIVE_OPTION);
 	}
 
-	_validateInteractive() {
+	_validateInteractive(additionalOptions) {
 		let additionalAllowed = 0;
+		const ubiquitousValuesThatAreInteractive = Object.values(UBIQUITOUS_OPTIONS)
+			.concat(Object.values(additionalOptions))
+			.filter((o)=>o.allowInteractive)
+			.map((o)=>({
+				name: o.name,
+				additionalAllowed: o.type === "SINGLE" ? 2 : 1
+			}))
 		process.argv.forEach((arg)=>{
-			if( /\b(authid|project|config|debug|skiphooks|folder)\b/.test(arg) ) additionalAllowed += 2;
+			const mactchingOption = ubiquitousValuesThatAreInteractive.find(
+				(o)=>(`--${o.name}` === arg)
+			);
+			additionalAllowed += mactchingOption?.additionalAllowed || 0;
 		});
-		if (process.argv.length > (4 + additionalAllowed) ) {
-			// There are more options apart from -i or --interactive
-			throw NodeTranslationService.getMessage(ERRORS.INTERACTIVE_MODE_MORE_OPTIONS);
+		return ()=> {
+			if (process.argv.length > (4 + additionalAllowed)) {
+				// There are more options apart from -i or --interactive
+				throw NodeTranslationService.getMessage(ERRORS.INTERACTIVE_MODE_MORE_OPTIONS);
+			}
 		}
 	}
 
@@ -121,70 +214,7 @@ module.exports = class CLI {
 
 			Object.assign(
 				commandMetadata.options,
-				{
-					"config": {
-						"name": "config",
-						"option": "config",
-						"description": "Specify a config file to use. Otherwise cli will discover closest config file",
-						"mandatory": false,
-						"type": "SINGLE",
-						"usage": "\"./path/to/sdf.config.alt.js\"",
-						"defaultOption": false,
-						"disableInIntegrationMode": false,
-						"conflicts": ["noconfig"]
-					},
-					"noconfig": {
-						"name": "noconfig",
-						"option": "noconfig",
-						"description": "Do not use any config file",
-						"mandatory": false,
-						"type": "FLAG",
-						"usage": "",
-						"defaultOption": false,
-						"disableInIntegrationMode": false,
-						"conflicts": ["config"]
-					},
-					"customflag": {
-						"name": "customflag",
-						"option": "customflag",
-						"description": "A custom boolean that will be passed into the hooks. Has no effect unless you implement the logic in a hook",
-						"mandatory": true,
-						"type": "FLAG",
-						"usage": "",
-						"defaultOption": false,
-						"disableInIntegrationMode": false
-					},
-					"customoptions": {
-						"name": "customoptions",
-						"option": "customoptions",
-						"description": "Custom string values that will be passed into the hooks. Has no effect unless you implement the logic in a hook",
-						"mandatory": false,
-						"type": "MULTIPLE",
-						"usage": "\"value1\" \"value2\"",
-						"defaultOption": false,
-						"disableInIntegrationMode": false
-					},
-					"debug": {
-						"name": "debug",
-						"option": "debug",
-						"description": "Directory to dump debug data for debugging. Creates a unique {command}.{datetime}.json file per run",
-						"mandatory": true,
-						"type": "SINGLE",
-						"usage": "\"./debug-output\"",
-						"defaultOption": false,
-						"disableInIntegrationMode": false
-					},
-					"skiphooks": {
-						"name": "skiphooks",
-						"option": "skiphooks",
-						"description": "Skip hook execution. Values: 'pre' (skip beforeExecuting), 'post' (skip onCompleted/onError), 'all' (skip all hooks)",
-						"mandatory": true,
-						"type": "SINGLE",
-						"usage": "\"pre|post|all|none\"",
-						"defaultOption": "none",
-						"disableInIntegrationMode": false
-					}
-				}
+				UBIQUITOUS_OPTIONS
 			);
 		});
 	}

package/src/core/CommandActionExecutor.js

@@ -32,6 +32,7 @@ module.exports = class CommandActionExecutor {
 		this._commandsMetadataService = dependencies.commandsMetadataService;
 		this._log = dependencies.log;
 		this._sdkPath = dependencies.sdkPath;
+		this._binaryName = dependencies.binaryName;
 
 		if (!dependencies.executionEnvironmentContext) {
 			this._executionEnvironmentContext = new ExecutionEnvironmentContext();
@@ -144,6 +145,7 @@ module.exports = class CommandActionExecutor {
 			process.env[ENV_VARS.SUITECLOUD_PROJECT_FOLDER] = projectFolder;
 			process.env[ENV_VARS.SUITECLOUD_PROJECT_PATH] = projectPath;
 			process.env[ENV_VARS.SUITECLOUD_PROJECT_ROOT] = this._executionPath;
+			process.env[ENV_VARS.SUITECLOUD_EXE] = this._binaryName;
 			// this might modified but we need the user's hooks to take advantage of their current values
 			process.env[ENV_VARS.SUITECLOUD_AUTHID] = authId;
 			const skipPre = skipHooks === 'pre' || skipHooks === 'all';
@@ -253,22 +255,10 @@ module.exports = class CommandActionExecutor {
 		const optionValues = {};
 		for (const optionId in options) {
 			const optionMeta = options[optionId];
-			// apply defaults first
 			if (options.hasOwnProperty(optionId)){
-				if(optionMeta?.mandatory) {
-					switch(true){
-						case optionMeta?.type !== 'FLAG' && typeof optionMeta?.defaultOption === "boolean":
-							// don't set a value for boolean unless it is a FLAG type
-							break;
-						case (optionMeta?.type === "FLAG"):
-							optionValues[optionId] = Boolean(optionMeta.defaultOption)
-							break;
-						case !["undefined"].includes( typeof optionMeta?.defaultOption) && optionMeta?.type !== 'FLAG':
-								optionValues[optionId] = optionMeta.defaultOption;
-							break;
-						default:
-							break;
-					}
+				// apply defaults first when it is force include
+				if(optionMeta?.forceinclude) {
+					optionValues[optionId] = optionMeta.defaultOption
 				}
 			    if(args.hasOwnProperty(optionId)) {
 					optionValues[optionId] = args[optionId];
@@ -323,7 +313,7 @@ module.exports = class CommandActionExecutor {
 	_getDebugFilePath(debugDir, commandName) {
 		if (!debugDir) return null;
 		const sanitizedCommandName = commandName.replace(/:/g, '-');
-		const filename = `${sanitizedCommandName}.json`;
+		const filename = `debug.${sanitizedCommandName}.json`;
 		return path.join(debugDir, filename);
 	}
 

package/src/core/CommandRegistrationService.js

@@ -65,7 +65,7 @@ module.exports = class CommandRegistrationService {
 
 	_addInteractiveCommandOptions(commandSetup,options){
 		const filteredOptions = Object.entries(options).filter(([key,o])=>{
-			return ['authid','project','config','debug','skiphooks','folder'].includes(o.name);
+			if( o.allowInteractive ) return true;
 		});
 		filteredOptions.push(['interactive',{
 			"name": "interactive",

package/src/metadata/CommandGenerators.json

@@ -21,7 +21,7 @@
 	},
 	{
 		"commandName": "custom:hook",
-		"supportsInteractiveMode": false,
+		"supportsInteractiveMode": true,
 		"generator": "./commands/custom/hook/Command"
 	},
 	{

package/src/metadata/NodeCommandsMetadata.json

@@ -7,114 +7,137 @@
 		"isSetupRequired": false,
 		"forceInteractiveMode": false,
 		"options": {
+			"name":  {
+				"name": "name",
+				"description": "The name of your hook for your own purposes.",
+				"allowInteractive": true,
+				"type": "SINGLE",
+				"mandatory": true,
+				"disableInIntegrationMode": false
+			},
 			"option1": {
 				"name": "option1",
-				"description": "Arbitrary value for your custom hook to recognize",
+			"description": "Arbitrary value for your custom hook to recognize. Type is string",
+			"allowInteractive":true,
 				"type": "SINGLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"option2": {
 				"name": "option2",
-				"description": "Arbitrary for your custom hook to recognize",
+				"description": "Arbitrary for your custom hook to recognize. Type is string",
+				"allowInteractive":true,
 				"type": "SINGLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"option3": {
 				"name": "option3",
-				"description": "Arbitrary for your custom hook to recognize",
+				"description": "Arbitrary for your custom hook to recognize. Type is string",
+				"allowInteractive":true,
 				"type": "SINGLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"option4": {
 				"name": "option4",
-				"description": "Arbitrary for your custom hook to recognize",
+				"description": "Arbitrary for your custom hook to recognize. Type is string",
+				"allowInteractive":true,
 				"type": "SINGLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"option5": {
 				"name": "option5",
-				"description": "Arbitrary for your custom hook to recognize",
+				"description": "Arbitrary for your custom hook to recognize. Type is string",
+				"allowInteractive":true,
 				"type": "SINGLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"multi1": {
 				"name": "multi1",
-				"description": "Arbitrary array for your custom hook to recognize",
+				"description": "Arbitrary array for your custom hook to recognize. Type is string[]",
 				"usage": "--multi1 a b c",
-				"type": "SINGLE",
+				"type": "MULTIPLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"multi2": {
 				"name": "multi2",
-				"description": "Arbitrary array for your custom hook to recognize",
+				"description": "Arbitrary array for your custom hook to recognize. Type is string[]",
 				"usage": "--multi2 a b c",
-				"type": "SINGLE",
+				"type": "MULTIPLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"multi3": {
 				"name": "multi3",
-				"description": "Arbitrary array for your custom hook to recognize",
+				"description": "Arbitrary array for your custom hook to recognize. Type is string[]",
 				"usage": "--multi3 a b c",
-				"type": "SINGLE",
+				"type": "MULTIPLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"multi4": {
 				"name": "multi4",
-				"description": "Arbitrary array for your custom hook to recognize",
+				"description": "Arbitrary array for your custom hook to recognize. Type is string[]",
 				"usage": "--multi4 a b c",
-				"type": "SINGLE",
+				"type": "MULTIPLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"multi5": {
 				"name": "multi5",
-				"description": "Arbitrary array for your custom hook to recognize",
+				"description": "Arbitrary array for your custom hook to recognize. Type is string[]",
 				"usage": "--multi5 a b c",
-				"type": "SINGLE",
+				"type": "MULTIPLE",
 				"mandatory": false,
 				"disableInIntegrationMode": false
 			},
 			"flag1": {
 				"name": "flag1",
-				"description": "Arbitrary on/off flag for your custom hook to use",
+				"description": "Arbitrary on/off flag for your custom hook to use. Type is boolean",
+				"allowInteractive":true,
 				"type": "FLAG",
 				"mandatory": false,
+				"defaultOption": false,
 				"disableInIntegrationMode": false
 			},
 			"flag2": {
 				"name": "flag2",
-				"description": "Arbitrary on/off flag for your custom hook to use",
+				"description": "Arbitrary on/off flag for your custom hook to use. Type is boolean",
+				"allowInteractive":true,
 				"type": "FLAG",
 				"mandatory": false,
+				"defaultOption": false,
 				"disableInIntegrationMode": false
 			},
 			"flag3": {
 				"name": "flag3",
-				"description": "Arbitrary on/off flag for your custom hook to use",
+				"description": "Arbitrary on/off flag for your custom hook to use. Type is boolean",
+				"allowInteractive":true,
 				"type": "FLAG",
 				"mandatory": false,
+				"defaultOption": false,
 				"disableInIntegrationMode": false
 			},
 			"flag4": {
 				"name": "flag4",
-				"description": "Arbitrary on/off flag for your custom hook to use",
+				"description": "Arbitrary on/off flag for your custom hook to use. Type is boolean",
+				"allowInteractive":true,
 				"type": "FLAG",
 				"mandatory": false,
+				"defaultOption": false,
 				"disableInIntegrationMode": false
 			},
 			"flag5": {
 				"name": "flag5",
-				"description": "Arbitrary on/off flag for your custom hook to use",
+				"description": "Arbitrary on/off flag for your custom hook to use. Type is boolean",
+				"allowInteractive":true,
 				"type": "FLAG",
 				"mandatory": false,
+				"defaultOption": false,
 				"disableInIntegrationMode": false
 			}
 		}

package/src/metadata/SdkCommandsMetadata.json

@@ -533,6 +533,7 @@
 				"option": "folder",
 				"description": "Specifies the File Cabinet path, for example, \"\/SuiteScripts\". All files within subfolders are included.",
 				"mandatory": true,
+				"allowInteractive": true,
 				"type": "SINGLE",
 				"usage": "\"\/SuiteScripts\"",
 				"defaultOption": true,

package/src/suitecloud.js

@@ -13,9 +13,16 @@ const CommandOptionsValidator = require('./core/CommandOptionsValidator');
 const CLIConfigurationService = require('./core/extensibility/CLIConfigurationService');
 const sdkPath = require('./core/sdksetup/SdkProperties').getSdkPath();
 const NodeConsoleLogger = require('./loggers/NodeConsoleLogger');
+const PACKAGE_FILE = `../package.json`;
 
 const executionPath = process.cwd();
 const commandsMetadataServiceSingleton = new CommandsMetadataService();
+const getBinaryName = ()=>{
+	const configFile = require(PACKAGE_FILE);
+	return Object.entries(configFile.bin || {}).flatMap(
+		(k,v)=>(String(v).endsWith('suitecloud.js')? [k]: [])
+	).shift() || process.argv[1];
+}
 
 const cliInstance = new CLI({
 	commandsMetadataService: commandsMetadataServiceSingleton,
@@ -26,7 +33,8 @@ const cliInstance = new CLI({
 		cliConfigurationService: new CLIConfigurationService(),
 		commandsMetadataService: commandsMetadataServiceSingleton,
 		log: NodeConsoleLogger,
-		sdkPath: sdkPath
+		sdkPath: sdkPath,
+		binaryName: getBinaryName()
 	}),
 });