@microtronics/studio-cli 0.43.0 → 0.44.0

package/CHANGELOG.md

@@ -1,16 +1,18 @@
 # Changelog
 
-## 0.43.0 (2026-01-19)
-
-### Features
-
-* add debug option to enable mdnCom logging ([34dfd29](https://bitbucket.org/microtronics-core/vscode-studio/commits/34dfd29cf2f5e6776e31463a85f0484a6907b13b))
-* add support for uploading any amx file to an usb device ([e89f108](https://bitbucket.org/microtronics-core/vscode-studio/commits/e89f1087e22e6c0cc88c8b68bbbcc4f1d813dc4f))
-* add USB device detection and listing functionality ([906e3e1](https://bitbucket.org/microtronics-core/vscode-studio/commits/906e3e12bca647f5ceba8b4196f00d507be163d9))
-* add USB device listing command ([fb16e1a](https://bitbucket.org/microtronics-core/vscode-studio/commits/fb16e1ab0c9a52e38467b664e4b2b6adb135a249)), closes [#close](https://bitbucket.org/microtronics-core/vscode-studio/issues/close)
-
-### Bug Fixes
-
+## 0.44.0 (2026-01-19)
+
+## 0.43.0 (2026-01-19)
+
+### Features
+
+* add debug option to enable mdnCom logging ([34dfd29](https://bitbucket.org/microtronics-core/vscode-studio/commits/34dfd29cf2f5e6776e31463a85f0484a6907b13b))
+* add support for uploading any amx file to an usb device ([e89f108](https://bitbucket.org/microtronics-core/vscode-studio/commits/e89f1087e22e6c0cc88c8b68bbbcc4f1d813dc4f))
+* add USB device detection and listing functionality ([906e3e1](https://bitbucket.org/microtronics-core/vscode-studio/commits/906e3e12bca647f5ceba8b4196f00d507be163d9))
+* add USB device listing command ([fb16e1a](https://bitbucket.org/microtronics-core/vscode-studio/commits/fb16e1ab0c9a52e38467b664e4b2b6adb135a249)), closes [#close](https://bitbucket.org/microtronics-core/vscode-studio/issues/close)
+
+### Bug Fixes
+
 * ensure proper exit code on successful USB upload ([cc1ae63](https://bitbucket.org/microtronics-core/vscode-studio/commits/cc1ae632669e785017c2afaa689c3750ba22d7fb))
 
 ## 0.42.0 (2026-01-13)

package/README.md

@@ -21,9 +21,130 @@ For a reference on all the available `studio-cli` commands, run `studio-cli --he
 
 ## Requirements
 
-[Node.js](https://nodejs.org/en/) at least `20.x.x`.
+[Node.js](https://nodejs.org/en/) version `22` or higher.
 
 
+## Commands
+
+### install (alias: i)
+Install all dependencies in your project.
+
+```console
+$ studio-cli install [dependency...]
+```
+
+**Options:**
+- `-e, --env <environment>` - CLI target environment (defaults to STUDIO_ENV environment variable)
+- `--token <API-token>` - API Access Token (defaults to STUDIO_TOKEN environment variable)
+
+**Examples:**
+```console
+$ studio-cli install
+$ studio-cli i
+$ studio-cli install dependency-name
+```
+
+### build
+Build the project.
+
+```console
+$ studio-cli build [options]
+```
+
+**Options:**
+- `-p, --part <APM part>` - APM part that should be built
+  - Available parts: `dde`, `dlo`, `pov`, `blo`, `dfiles`
+- `-e, --env <environment>` - CLI target environment
+  - Available environments: `lucky`, `wynni`, `production` (default)
+- `--token <API-token>` - API Access Token
+
+**Manifest Overrides:**
+You can overwrite manifest options using the `--option=value` syntax.
+
+**Examples:**
+```console
+$ studio-cli build
+$ studio-cli build --part dlo
+$ studio-cli build --env wynni
+$ studio-cli build --dlo.mainFile="./dlo/test.dlo"
+```
+
+### publish
+Publish the project to the registry.
+
+```console
+$ studio-cli publish [options]
+```
+
+**Options:**
+- `-ph, --phase <release phase>` - Specify a release phase (default: `release`)
+  - Available phases: `alpha`, `beta`, `rc`, `release`, `stage`, `passive`, `withdrawn`
+- `--allowedBackends <null|*|server.xz;server.yz>` - Specify the allowedBackends deployment for this version
+  - `null` - No restrictions (default)
+  - `*` - All backends allowed
+  - `server.xz;server.yz` - Specific backend servers (semicolon-separated)
+- `-e, --env <environment>` - CLI target environment
+  - Available environments: `lucky`, `wynni`, `production` (default)
+- `--token <API-token>` - API Access Token
+- `-i, --packagePath <path>` - Publish the provided library or app package. Use "*" for autodetection
+
+**Examples:**
+```console
+$ studio-cli publish
+$ studio-cli publish --phase beta
+$ studio-cli publish --allowedBackends "*"
+$ studio-cli publish --packagePath ./my-package.tar.gz --env wynni
+```
+
+### package (alias: pack)
+Package the project.
+
+```console
+$ studio-cli package [options]
+```
+
+**Options:**
+- `-ph, --phase <release phase>` - Specify a release phase (default: `release`)
+  - Available phases: `alpha`, `beta`, `rc`, `release`, `stage`, `passive`, `withdrawn`
+- `-e, --env <environment>` - CLI target environment
+  - Available environments: `lucky`, `wynni`, `production` (default)
+- `--token <API-token>` - API Access Token
+
+**Examples:**
+```console
+$ studio-cli package
+$ studio-cli pack --phase alpha
+$ studio-cli pack --env wynni
+```
+
+### usb
+USB device management commands.
+
+#### usb list
+List available USB devices.
+
+```console
+$ studio-cli usb list
+```
+
+#### usb upload
+Upload an AMX binary to a USB device.
+
+```console
+$ studio-cli usb upload -s <serial> -f <path> [--debug]
+```
+
+**Options:**
+- `-s, --serial <serial>` - Device serial number (16 characters hex) **[required]**
+- `-f, --file <path>` - Path to the AMX file (relative to current directory) **[required]**
+- `--debug` - Enable debug logging
+
+**Example:**
+```console
+$ studio-cli usb upload -s 1234567890ABCDEF -f ./app.amx
+$ studio-cli usb upload -s 1234567890ABCDEF -f ./app.amx --debug
+```
+
 ## Development
 
 Execute commands from the root dir

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@microtronics/studio-cli",
-	"version": "0.43.0",
+	"version": "0.44.0",
 	"description": "Microtronics Studio CLI Tool",
 	"main": "./out/api.js",
 	"typings": "./dist/studio-cli.d.ts",