aspera-cli 4.25.2 → 4.25.4

data/CHANGELOG.md

@@ -2,16 +2,42 @@
 
 <!-- markdownlint-configure-file { "no-duplicate-heading": { "siblings_only": true } } -->
 
-## 4.25.2
+## 4.25.4
 
-Released: 2026-02-03
+Released: 2026-03-04
 
 ### New Features
 
+* **general**: If `@:` is used, then marker `END` optionally marks the end of collected arguments.
+* `format`: `display` defaults to `info` only if `format` is set to `table`, else defaults to `data`.
+* `node`: Parameter `accept_v4` of option `node_api` (boolean, defaults to `true`) allows using gen4 browsing with `Accept-Version: 4.0` for best performance when there are thousands of files.
+
 ### Issues Fixed
 
+* `faspex5`: Listing content, or receiving a package requires API parameter: `recipient_user_id` or `recipient_workgroup_id`, else error `Not authorized` is returned.
+
 ### Breaking Changes
 
+* `node`: Options `node_cache` and `default_ports` are replaced with option: `node_api` (`Hash`) with boolean parameters (keys): `cache` and `standard_ports` with default value `true`.
+
+## 4.25.3
+
+Released: 2026-02-18
+
+### New Features
+
+* `faspex5`: Package browsing now available for all inbox types.
+
+### Issues Fixed
+
+* `aoc`: Public short links can now be modified.
+
+### Breaking Changes
+
+* `config`: Deprecated and removed action `ascp connect`.
+* **global**: Deprecated and removed option `property` made redundant with `@:` and dotted values. Instead of `--property=foo bar`, use `@: foo=bar`.
+* `faspex5`: Default value for option `box` is now `inbox_all` to match web UI, previously: `inbox`.
+
 ## 4.25.2
 
 Released: 2026-02-03
@@ -74,6 +100,7 @@ Released: 2026-01-21
 
 * `aoc`: Restored command `admin workspace shared_folder :id list` which was since 4.11.0.
 * `direct`: When using `ascp4` do not set env var: `ASPERA_TEST_REDIS_DISABLE`, else it fails with: `Failed to initialize application`.
+* `shares`: Properly detect using `/node_api/ping` endpoint instead of `/app`.
 
 ### Breaking Changes
 
@@ -103,7 +130,7 @@ Released: 2025-10-24
 * `faspex5`: Fix public link auth for Faspex 5.0.13.
 * `aoc`: Fix some admin operations requiring a user's home for Files.
 * `node`: Fix `transfer` operations: `modify` and `cancel`.
-* `config`: #230 Fix problem when installing and detecting SDK on Windows
+* `config`: #230 Fix problem when installing and detecting SDK on Windows.
 
 ### Breaking Changes
 
@@ -170,7 +197,7 @@ Released: 2025-08-11
 
 ### Breaking Changes
 
-* `config`: In `ascp info`: `openssldir` &rarr; `ascp_openssl_dir`, `openssl_version` &rarr; `ascp_openssl_version`, `sdk_ascp_version` &rarr; `ascp_version`
+* `config`: In `ascp info`: `openssldir` &rarr; `ascp_openssl_dir`, `openssl_version` &rarr; `ascp_openssl_version`, `sdk_ascp_version` &rarr; `ascp_version`.
 
 ## 4.22.0
 
@@ -203,20 +230,20 @@ Released: 2025-04-11
 
 ### New Features
 
-* **container**: Updated Ruby to 3.4.2
+* **container**: Updated Ruby to `3.4.2`.
 
 ### Issues Fixed
 
-* **global**: #185 `@val:` shall stop processing extended values
+* **global**: #185 `@val:` shall stop processing extended values.
 * **global**: #186 Removed dependency on OpenSSL 3.3 gem to avoid `MSYS2` dep on Windows.
 * `echo`: Display of list (Array) was showing only first element of it.
-* `transferd`: Support for version 1.1.5+
+* `transferd`: Support for version 1.1.5+.
 
 ### Breaking Changes
 
-* `preview`: Updated Image Magick to v7+
-* `aoc`: `admin subscription` split into `admin subscription account` and `admin subscription usage`
-* **agent**: `alpha` renamed to `desktop`
+* `preview`: Updated Image Magick to v7+.
+* `aoc`: `admin subscription` split into `admin subscription account` and `admin subscription usage`.
+* **agent**: `alpha` renamed to `desktop`.
 
 ## 4.21.1
 
@@ -224,19 +251,19 @@ Released: 2025-03-15
 
 ### New Features
 
-* `config`: New command: `transferd` to list and install specific version of `asperatransferd` and `ascp`
-* `config`: New command: `tokens` with `list`, `show`, `flush` (replace `flush_tokens`)
-* `faspex5`: New command: `admin contact reset_password`
+* `config`: New command: `transferd` to list and install specific version of `asperatransferd` and `ascp`.
+* `config`: New command: `tokens` with `list`, `show`, `flush` (replace `flush_tokens`).
+* `faspex5`: New command: `admin contact reset_password`.
 * `aoc`: #178 packages can be browsed, and individual files can be downloaded now.
 
 ### Issues Fixed
 
-* `config`: #175 `ascli config preset set GLOBAL version_check_days 0` causes a bad `config.yaml` to be written
-* `config`: #180 problem in `ascp install`
-* `config`: Soft links in transfer SDK archive are correctly extracted
+* `config`: #175 `ascli config preset set GLOBAL version_check_days 0` causes a bad `config.yaml` to be written.
+* `config`: #180 Problem in `ascp install`.
+* `config`: Soft links in transfer SDK archive are correctly extracted.
 * `aoc`: #184 token cache shall be different per AoC org.
 * `aoc`: Fix `packages delete` not working.
-* `direct` agent: #174 Race condition fix with `ascp`: timeout waiting management port connect (select not readable)
+* `direct` agent: #174 Race condition fix with `ascp`: timeout waiting management port connect (select not readable).
 * `preview`: #177 fix bug that prevents preview generation to work.
 
 ### Breaking Changes
@@ -245,7 +272,7 @@ Released: 2025-03-15
 * `ascp`: Default SDK version is now 1.1.4. Removes support for ascp4.
 * `node`: Removed deprecated command prefix `exec:`, use `@ruby:` instead.
 * **global**: Now uses OpenSSL 3.
-* **global**: Ruby minimum versions is now 3.1 (mainly due to switch to OpenSSL 3). Future minimum is 3.2. Recommended is 3.4. (that removes macOS default ruby support. Newer Ruby version shall be installed on macOS with `brew`)
+* **global**: Ruby minimum versions is now 3.1 (mainly due to switch to OpenSSL 3). Future minimum is 3.2. Recommended is 3.4. That removes macOS default Ruby support. Newer Ruby version shall be installed on macOS with `brew`.
 * **global**: Options `transpose_single` and `multi_table` replaced with single option `multi_single` and values: `no`, `yes`, `single`.
 * **global**: Column name for single object is now `field` instead of `key`.
 
@@ -253,7 +280,9 @@ Released: 2025-03-15
 
 Released: 2025-01-21
 
-  ATTENTION: [Faspex version 4 is now end of support](https://www.ibm.com/support/pages/lifecycle/search?q=faspex): The `faspex` plugin will be deprecated. Servers shall be upgraded to Faspex 5, and users use plugin `faspex5`.
+> [!CAUTION]
+> [Faspex version 4 is now end of support](https://www.ibm.com/support/pages/lifecycle/search?q=faspex): The `faspex` plugin will be deprecated.
+> Servers shall be upgraded to Faspex 5, and users use plugin `faspex5`.
 
 ### New Features
 
@@ -265,14 +294,14 @@ Released: 2025-01-21
 
 ### Issues Fixed
 
-* `aoc`: Fixed `find` command not working. (undefined variable)
-* `aoc`: #165 AoC `mkdir` now follows the last link of containing folder
+* `aoc`: Fixed `find` command not working (undefined variable).
+* `aoc`: #165 AoC `mkdir` now follows the last link of containing folder.
 
 ### Breaking Changes
 
 * Internal: Basic REST calls now return data directly. (no more `data` key). For advanced calls, use `call`.
 * Internal: Transfer SDK download is now a 2-step procedure: First get the YAML file from GitHub with URLs for the various platforms and versions, and then download the archive from the official IBM repository.
-    **global**: Option `format=multi` is replaced with option `multi_table=yes`
+**global**: Option `format=multi` is replaced with option `multi_table=yes`.
 * `faspex5`: Removed deprecated option `value` replaced with positional parameter.
   
 ## 4.19.0
@@ -281,13 +310,13 @@ Released: 2024-10-02
 
 ### New Features
 
-* `server`: Add support for `async` (Aspera Sync) from Transfer SDK
-* **global**: #156 support sending folders with `httpgw`
-* **global**: New value for option `format`: `multi`
+* `server`: Add support for `async` (Aspera Sync) from Transfer SDK.
+* **global**: #156 support sending folders with `httpgw`.
+* **global**: New value for option `format`: `multi`.
 
 ### Issues Fixed
 
-* `aoc`: #157 fix problem with `files browse` on a link
+* `aoc`: #157 fix problem with `files browse` on a link.
 * `sync`: Better documentation and handling of options.
 
 ### Breaking Changes
@@ -299,19 +328,15 @@ Released: 2024-10-02
 
 Released: 2024-08-21
 
-### New Features
-
-* None
-
 ### Issues Fixed
 
-* **global**: #146 (@junkimu) Fix problem on Windows WRT terminal detection
-* **global**: Node gen4 (`aoc`) browsing through link now follows the link correctly
-* `shares`: #147 Fix problem for `shares files mkdir`
+* **global**: #146 (@junkimu) Fix problem on Windows WRT terminal detection.
+* **global**: Node gen4 (`aoc`) browsing through link now follows the link correctly.
+* `shares`: #147 Fix problem for `shares files mkdir`.
 
 ### Breaking Changes
 
-* **global**: Removed option `id`, deprecated since 4.14.0
+* **global**: Removed option `id`, deprecated since `4.14.0`.
 
 ## 4.18.0
 
@@ -326,7 +351,7 @@ Released: 2024-07-10
 * `httpgw`: New plugin, detect the GW.
 * `faspio`: New plugin, configure bridges.
 * `config`: `ascp info` also shows the version of the OpenSSL library used by `ascp`.
-* `node`: New action: `transport` to display transfer address and ports
+* `node`: New action: `transport` to display transfer address and ports.
 * **global**: Added option `http_proxy`, as an alias to env var `http_proxy`.
 * **global**: Possibility to filter fields when using formats like `json` or `yaml`.
 
@@ -338,8 +363,8 @@ Released: 2024-07-10
 
 * `aoc` : `admin resource` is deprecated, use just `admin`.
 * `faspex5` : `admin resource` is deprecated, use just `admin`.
-* **global**: Option `value` is deprecated and replaced with option `query` when used in generic commands: `delete` and `list`, as well as node access_key browse, node stream and watch folder list. (#142)
-* **global**: Option `warnings` (and short `w`) is removed. To get ruby warnings invoke with `ruby -w .../ascli ...`. See `Makefile` in `test`
+* **global**: Option `value` is deprecated and replaced with option `query` when used in generic commands: `delete` and `list`, as well as node access_key browse, node stream and watch folder list. (#142).
+* **global**: Option `warnings` (and short `w`) is removed. To get Ruby warnings invoke with `ruby -w .../ascli ...`. See `Makefile` in `test`.
 * **global**: Option `table_style` now expects a Hash, not String.
 * **bss**: Removed unused plugin.
 
@@ -359,15 +384,15 @@ Released: 2024-07-13
 
 ### Issues Fixed
 
-* `aoc`: `exclude_dropbox_packages` query option can be overridden (#135)
-* **global**: Removed gem dependency on `bigdecimal` (not used and requires compilation)
-* **global**: Tested with JRuby 9.4.6.0 (use `ServerSocket` instead of `Socket`)
-* **global**: Update version for gem `terminal-table` to 3.0.2
+* `aoc`: `exclude_dropbox_packages` query option can be overridden (#135).
+* **global**: Removed gem dependency on `bigdecimal` (not used and requires compilation).
+* **global**: Tested with JRuby 9.4.6.0 (use `ServerSocket` instead of `Socket`).
+* **global**: Update version for gem `terminal-table` to `3.0.2`.
 
 ### Breaking Changes
 
 * `config`: Command `remote_certificate` now takes a subcommand.
-* **global**: Moved a few internal classes in new/renamed modules
+* **global**: Moved a few internal classes in new/renamed modules.
 * **global**: Deprecated pseudo transfer specification parameters starting with `EX_`:
   * `EX_ssh_key_paths`: Use spec `ssh_private_key` or option `transfer_info={"ascp_args":["-i","..."]}`
   * `EX_http_proxy_url`: Use option `transfer_info={"ascp_args":["-x","..."]}`
@@ -387,87 +412,87 @@ Released: 2024-02-15
 
 ### New Features
 
-* **global**: Option `output` to redirect result to a file instead of `stdout`
-* **global**: New option `silent_insecure`
-* `config`: Keys added to `config ascp info`
-* `config`: Added command `pubkey` to extract public key from private key
-* `config`: New command `vault info`
-* `faspex5`: Added `shared_folders` management
-* `faspex5`: If package has content protection, ask passphrase interactively, unless `content_protection=null` in `ts`
-* `faspex`: Added `INIT` for `once_only`
-* `aoc`: Added `INIT` for `once_only`
-* `aoc`: More list commands honor option `query`
+* **global**: Option `output` to redirect result to a file instead of `stdout`.
+* **global**: New option `silent_insecure`.
+* `config`: Keys added to `config ascp info`.
+* `config`: Added command `pubkey` to extract public key from private key.
+* `config`: New command `vault info`.
+* `faspex5`: Added `shared_folders` management.
+* `faspex5`: If package has content protection, ask passphrase interactively, unless `content_protection=null` in `ts`.
+* `faspex`: Added `INIT` for `once_only`.
+* `aoc`: Added `INIT` for `once_only`.
+* `aoc`: More list commands honor option `query`.
 
 ### Issues Fixed
 
 * `config`: Wizard was failing due to `require` of optional gem.
-* `aoc`: Use paging to list entities, instead of just one page(e.g. retrieve all packages)
+* `aoc`: Use paging to list entities, instead of just one page(e.g. retrieve all packages).
 * `faspex5`: When receiving ALL packages, only get those with status `completed`.
-* `direct` agent: Better support for WSS
+* `direct`: Better support for WSS.
 
 ### Breaking Changes
 
 * `shares`: Option `type` for users and groups is replaced with mandatory positional argument with same value. E.g. `user list --type=local` becomes: `user local list`.
-* `aoc`, `faspex`: Package `recv` command changed to `receive`, for consistency with faspex5 (`recv` is now an alias command)
+* `aoc`, `faspex`: Package `recv` command changed to `receive`, for consistency with faspex5 (`recv` is now an alias command).
 
 ## 4.15.0
 
 Released: 2023-11-18
 
-General: Removed many redundant options, more consistency between plugins, see below in "break"
+General: Removed many redundant options, more consistency between plugins, see below in "break".
 
 ### New Features
 
 * **global**: Added resolution hints for well known issues.
-* **global**: Extended value expression `@extend:` finds and replace extended values in a string (e.g. for JSON)
-* **global**: Option `fields` now supports `RegExp`
-* **global**: Option `home` to set the main folder for configuration and cache
-* **global**: Option `ignore_certificate` to specify specific URLs instead of global option `insecure`
-* **global**: Option `cert_stores` to specify alternate certificate stores
+* **global**: Extended value expression `@extend:` finds and replace extended values in a string (e.g. for JSON).
+* **global**: Option `fields` now supports `RegExp`.
+* **global**: Option `home` to set the main folder for configuration and cache.
+* **global**: Option `ignore_certificate` to specify specific URLs instead of global option `insecure`.
+* **global**: Option `cert_stores` to specify alternate certificate stores.
 * **global**: Uniform progress bar for any type of transfer.
-* **global**: Add extended value types: `re` and `yaml`
-* **global**: Option `pid_file` to write tool's PID during execution, deleted on exit
-* `config`: Command `remote_certificate` to retrieve a remote certificate
-* `config`: Added logger level `trace1` and `trace2`
+* **global**: Add extended value types: `re` and `yaml`.
+* **global**: Option `pid_file` to write tool's PID during execution, deleted on exit.
+* `config`: Command `remote_certificate` to retrieve a remote certificate.
+* `config`: Added logger level `trace1` and `trace2`.
 * `config`: `wizard` can detect multiple applications at the same address or URL.
-* `aoc`: Wizard accepts public links
-* `aoc`: Support private links, and possibility to list shared folder with workspace `@json:null`
-* `orchestrator`: Error analysis for workflow start
-* `httpgw`: Now supports pseudo file for testing: e.g. `faux:///testfile?1k`
-* `node`: Added command `transfer sessions` to list all sessions of all transfers
-* `node`: Generate bearer token from private key and user information
-* `node`: Access node API with bearer token as credentials
-* **global**: Agent `direct` allows ignoring certificate for WSS using HTTP options
-* `preview`: Command `show` generates a preview and displays it in terminal
+* `aoc`: Wizard accepts public links.
+* `aoc`: Support private links, and possibility to list shared folder with workspace `@json:null`.
+* `orchestrator`: Error analysis for workflow start.
+* `httpgw`: Now supports pseudo file for testing: e.g. `faux:///testfile?1k`.
+* `node`: Added command `transfer sessions` to list all sessions of all transfers.
+* `node`: Generate bearer token from private key and user information.
+* `node`: Access node API with bearer token as credentials.
+* **global**: Agent `direct` allows ignoring certificate for WSS using HTTP options.
+* `preview`: Command `show` generates a preview and displays it in terminal.
 
 ### Issues Fixed
 
-* Ruby warning: `net/protocol.rb:68: warning: already initialized constant Net::ProtocRetryError` solved by removing dependency on `net-smtp` from gem spec (already in base ruby).
+* Ruby warning: `net/protocol.rb:68: warning: already initialized constant Net::ProtocRetryError` solved by removing dependency on `net-smtp` from gem spec (already in base Ruby).
 
 ### Breaking Changes
 
 * **global**: Commands `detect` and `wizard` takes now a mandatory argument: address or URL instead of option `url`.
-* **global**: Renamed option `pkeypath` to `key_path`
-* **global**: Renamed option `notif_to` to `notify_to` and `notif_template` to `notify_template`
+* **global**: Renamed option `pkeypath` to `key_path`.
+* **global**: Renamed option `notif_to` to `notify_to` and `notif_template` to `notify_template`.
 * **global**: Removed extended value handler `incps`, as it is never used (use `extend` instead).
 * **global**: Option `fields`: `+prop` is replaced with: `DEF,prop` and `-field` is replaced with: `DEF,-field`, and whole list is evaluated.
-* **global**: Replaced option `progress` with option `progressbar` (bool)
-* **global**: Removed option `rest_debug` and `-r`, replaced with `--log-level=trace2`
-* **global**: The default file name for private key when using wizard is change from `aspera_aoc_key` to `my_private_key.pem`
-* `faspex5`: Removed option and `auth` type `link`: simply provide the public link as `url`
-* `faspex`: Remote source selection now uses percent selector instead of parameter `id` or `name`
-* `faspex`: Option `source_name` is now `remote_source`
-* `aoc`: Selection by name uses percent selector instead of option or parameter `name`
-* `aoc`: Removed option `link`: use `url` instead
-* `aoc`: In command `short_link`, place type before command, e.g. `short_link private create /blah`
-* `aoc`: Replaced option `operation` with mandatory positional parameter for command `files transfer`
-* `aoc`: Replaced option `from_folder` with mandatory positional parameter for command `files transfer`
-* `orchestrator`: Workflow start takes arguments as optional positional extended value instead of option `param`
-* `node`: `find` command now takes an optional `@ruby:` extended value instead of option `query` with prefix: `exec:`
+* **global**: Replaced option `progress` with option `progressbar` (bool).
+* **global**: Removed option `rest_debug` and `-r`, replaced with `--log-level=trace2`.
+* **global**: The default file name for private key when using wizard is change from `aspera_aoc_key` to `my_private_key.pem`.
+* `faspex5`: Removed option and `auth` type `link`: simply provide the public link as `url`.
+* `faspex`: Remote source selection now uses percent selector instead of parameter `id` or `name`.
+* `faspex`: Option `source_name` is now `remote_source`.
+* `aoc`: Selection by name uses percent selector instead of option or parameter `name`.
+* `aoc`: Removed option `link`: use `url` instead.
+* `aoc`: In command `short_link`, place type before command, e.g. `short_link private create /blah`.
+* `aoc`: Replaced option `operation` with mandatory positional parameter for command `files transfer`.
+* `aoc`: Replaced option `from_folder` with mandatory positional parameter for command `files transfer`.
+* `orchestrator`: Workflow start takes arguments as optional positional extended value instead of option `param`.
+* `node`: `find` command now takes an optional `@ruby:` extended value instead of option `query` with prefix: `exec:`.
 * `sync`: Plugin `sync` is removed: actions are available through `server` and `node` plugins.
 * `sync`: Replaced option `sync_session` with optional positional parameter.
 * `preview`: Command `scan`, `events` and `trevents` replaced option `query` with optional positional parameter for filter (like `find`).
-* **global**: Agent `trsdk` parameters `host` and `port` in option `transfer_info` are replaced with parameter `url`, like `grpc://host:port`
+* **global**: Agent `trsdk` parameters `host` and `port` in option `transfer_info` are replaced with parameter `url`, like `grpc://host:port`.
 
 ## 4.14.0
 
@@ -475,32 +500,32 @@ Released: 2023-09-22
 
 ### New Features
 
-* `server`: Option `passphrase` for simpler command line (#114)
-* Percent selector for entities identifier
-* `faspex5`: Shared inbox and workgroup membership management
-* `faspex5`: Invite external user to shared inbox
-* `faspex5`: Package list and receive from workgroup and shared inbox
+* `server`: Option `passphrase` for simpler command line (#114).
+* Percent selector for entities identifier.
+* `faspex5`: Shared inbox and workgroup membership management.
+* `faspex5`: Invite external user to shared inbox.
+* `faspex5`: Package list and receive from workgroup and shared inbox.
 * `config`: Command `ascp info` shows default transfer spec.
-* **global**: Agent `httpgw` synchronous and asynchronous upload modes
-* `node`: Command `bandwidth_average` to get average bandwidth of node, per periods
+* **global**: Agent `httpgw` synchronous and asynchronous upload modes.
+* `node`: Command `bandwidth_average` to get average bandwidth of node, per periods.
 
 ### Issues Fixed
 
-* Option `ts`: Deep add and remove of keys. (#117)
-* `faspex5`: User lookup for `packages send` shall be exact match (#120)
+* Option `ts`: Deep add and remove of keys. (#117).
+* `faspex5`: User lookup for `packages send` shall be exact match (#120).
 * **global**: Agent `direct` if transfer spec contains "paths" and elements with "destination", but first element has only "source", then destinations were ignored. Now "destination" all or none is enforced.
 
 ### Breaking Changes
 
-* Using `aoc files` or node gen4 operations (`browse`, `delete`) on a link will follow the link only if path ends with /
-* `shares`: Command `repository` is changed to `files` for consistency with aoc and upcoming faspex5, but is still available as alias
-* `aoc`: Better handling of shared links
+* Using `aoc files` or node gen4 operations (`browse`, `delete`) on a link will follow the link only if path ends with /.
+* `shares`: Command `repository` is changed to `files` for consistency with `aoc` and upcoming `faspex5`, but is still available as alias.
+* `aoc`: Better handling of shared links.
 * **global**: Option `value` is deprecated. Use positional parameter for creation data and option `query` for list/delete operations.
-* `config`: Remove deprecated command: `export_to_cli`
+* `config`: Remove deprecated command: `export_to_cli`.
 * `config`: Removed all legacy preset command, newer command `preset` shall be used now.
-* `config`: SDK is now installed in `$HOME/.aspera/sdk` instead of `$HOME/.aspera/ascli/sdk`
-* `aoc`, `node`: Simplification: gen4 operations: show modify permission thumbnail are now directly under node gen 4 command. Command `file` is suppressed. Option `path` is suppressed. The default expected argument is a path. To provide a file ID, use selector syntax: `%id:_file_id_`
-* `node`: Option `token_type` is removed, as starting with HSTS 4.3 basic token is only allowed with access keys, so use gen4 operations: `acc do self`
+* `config`: SDK is now installed in `$HOME/.aspera/sdk` instead of `$HOME/.aspera/ascli/sdk`.
+* `aoc`, `node`: Simplification: gen4 operations: show modify permission thumbnail are now directly under node gen 4 command. Command `file` is suppressed. Option `path` is suppressed. The default expected argument is a path. To provide a file ID, use selector syntax: `%id:_file_id_`.
+* `node`: Option `token_type` is removed, as starting with HSTS 4.3 basic token is only allowed with access keys, so use gen4 operations: `acc do self`.
 
 ## 4.13.0
 
@@ -508,26 +533,26 @@ Released: 2023-06-29
 
 ### New Features
 
-* `preview`: Option `reencode_ffmpeg` allows overriding all re-encoding options
-* `faspex5`: `package delete` (#107)
-* `faspex5`: `package recv` for inboxes and regular users (#108)
-* `faspex5`: SMTP management
-* `faspex5`: Use public link for authorization of package download, using option `link`
-* `faspex5`: List content of package, and allow partial download of package
-* `faspex5`: List packages support multiple pages and items limitations (`max` and `pmax`)
-* `aoc`: Files operations with workspace-less user (#109)
-* `node`: `async` with gen3 token (#110)
-* `node`: Display of preview of file in terminal for access keys
+* `preview`: Option `reencode_ffmpeg` allows overriding all re-encoding options.
+* `faspex5`: `package delete` (#107).
+* `faspex5`: `package recv` for inboxes and regular users (#108).
+* `faspex5`: SMTP management.
+* `faspex5`: Use public link for authorization of package download, using option `link`.
+* `faspex5`: List content of package, and allow partial download of package.
+* `faspex5`: List packages support multiple pages and items limitations (`max` and `pmax`).
+* `aoc`: Files operations with workspace-less user (#109).
+* `node`: `async` with gen3 token (#110).
+* `node`: Display of preview of file in terminal for access keys.
 
 ### Issues Fixed
 
-* `cos`: Do not use refresh token when not supported
-* **container**: SDK installed in other folder than `ascli` (#106)
+* `cos`: Do not use refresh token when not supported.
+* **container**: SDK installed in other folder than `ascli` (#106).
 
 ### Breaking Changes
 
-* Option `transfer_info` is now cumulative, setting several times merge values
-* Change(deprecation): Removed support of Ruby 2.4 and 2.5 : Too old, no security update since a long time. If you need older ruby version use older gem version.
+* Option `transfer_info` is now cumulative, setting several times merge values.
+* Change(deprecation): Removed support of Ruby 2.4 and 2.5 : Too old, no security update since a long time. If you need older Ruby version use older gem version.
 
 ## 4.12.0
 
@@ -535,25 +560,25 @@ Released: 2023-03-20
 
 ### New Features
 
-* **container**: Build image from official gem version, possibility to deploy beta as well
-* **global**: `delete` operation supports option `value` for deletion parameters
-* `aoc`: Command `aoc packages recv` accepts option `query` to specify a shared inbox
-* `faspex`: (v4) user delete accepts option `value` with value `{"destroy":true}` to delete users permanently
-* `faspex`: (v4) gateway to Faspex 5 for package send
-* `faspex5`: Possibility to change email templates
-* `faspex5`: Shared folder list and browse
-* `faspex5`: Emulate Faspex 4 post-processing, plugin: `faspex5` command: `postprocessing`
-* `faspex5`: Send package from remote source
-* `shares`: Option `type` for command `shares admin user`
-* `shares`: Full support for shares admin operations
+* **container**: Build image from official gem version, possibility to deploy beta as well.
+* **global**: `delete` operation supports option `value` for deletion parameters.
+* `aoc`: Command `aoc packages recv` accepts option `query` to specify a shared inbox.
+* `faspex`: (v4) user delete accepts option `value` with value `{"destroy":true}` to delete users permanently.
+* `faspex`: (v4) gateway to Faspex 5 for package send.
+* `faspex5`: Possibility to change email templates.
+* `faspex5`: Shared folder list and browse.
+* `faspex5`: Emulate Faspex 4 post-processing, plugin: `faspex5` command: `postprocessing`.
+* `faspex5`: Send package from remote source.
+* `shares`: Option `type` for command `shares admin user`.
+* `shares`: Full support for shares admin operations.
 
 ### Breaking Changes
 
-* `shares`: Command `shares admin user saml_import` replaced with `shares admin user import --type=saml`
-* `shares`: Command `shares admin user ldap_import` replaced with `shares admin user add --type=ldap`
-* `shares`: Command `app_authorizations` now has sub commands `show` and `modify`
-* `shares`: Similar changes for `shares admin share user show`
-* Option `ascp_opts` is removed, and replaced with `transfer_info` parameter `ascp_args`
+* `shares`: Command `shares admin user saml_import` replaced with `shares admin user import --type=saml`.
+* `shares`: Command `shares admin user ldap_import` replaced with `shares admin user add --type=ldap`.
+* `shares`: Command `app_authorizations` now has sub commands `show` and `modify`.
+* `shares`: Similar changes for `shares admin share user show`.
+* Option `ascp_opts` is removed, and replaced with `transfer_info` parameter `ascp_args`.
 
 ## 4.11.0
 
@@ -561,27 +586,27 @@ Released: 2023-01-26
 
 ### New Features
 
-* **global**: `vault`: Secret finder, migration from config file
-* **global**: Allow removal of transfer spec parameter by setting value to `null`
-* **global**: Option `ascp_opts` allows providing native `ascp` options on command line
-* `node`, `server`: Command `sync` added to `node` (gen4) and `server` plugins, also available in `aoc`
+* **global**: `vault`: Secret finder, migration from config file.
+* **global**: Allow removal of transfer spec parameter by setting value to `null`.
+* **global**: Option `ascp_opts` allows providing native `ascp` options on command line.
+* `node`, `server`: Command `sync` added to `node` (gen4) and `server` plugins, also available in `aoc`.
 
 ### Issues Fixed
 
-* **global**: Security: no shell interpolation
-* **global**: Agent `node`: when WSS is used: no localhost (certificate)
-* `aoc`: #99 `file download` for single shared folder
-* `faspex5`: Change of API in Faspex 5 for send package (paths is mandatory for any type of transfer now)
-* **global**: OAuth web authentication was broken, fixed now
+* **global**: Security: no shell interpolation.
+* **global**: Agent `node`: when WSS is used: no localhost (certificate).
+* `aoc`: #99 `file download` for single shared folder.
+* `faspex5`: Change of API in Faspex 5 for send package (paths is mandatory for any type of transfer now).
+* **global**: OAuth web authentication was broken, fixed now.
 
 ### Breaking Changes
 
-* **container**: Image has entry point
-* `aoc`: `admin res node` commands `v3` and `v4` replaced with `do` and command `v3` moved inside `do`
-* Renamed options for `sync`
-* Node gen4 operations are moved from aoc plugin to node plugin but made available where gen4 is used
-* If wss is enabled on server, use wss
-* Lots of cleanup and refactoring
+* **container**: Image has entry point.
+* `aoc`: `admin res node` commands `v3` and `v4` replaced with `do` and command `v3` moved inside `do`.
+* Renamed options for `sync`.
+* Node gen4 operations are moved from aoc plugin to node plugin but made available where gen4 is used.
+* If wss is enabled on server, use wss.
+* Lots of cleanup and refactoring.
 
 ## 4.10.0
 
@@ -589,16 +614,16 @@ Released: 2022-12-02
 
 ### New Features
 
-* `httpgw`: Transfer agent support API v2, support transfer through HTTP proxy, including proxy password
-* `faspex5`: Get bearer token
+* `httpgw`: Transfer agent support API v2, support transfer through HTTP proxy, including proxy password.
+* `faspex5`: Get bearer token.
 
 ### Issues Fixed
 
-* **container**: Container version
+* **container**: Container version.
 
 ### Breaking Changes
 
-* `config`: Option `secrets` is renamed to `vault`
+* `config`: Option `secrets` is renamed to `vault`.
 
 ## 4.9.0
 
@@ -606,23 +631,22 @@ Released: 2022-09-15
 
 ### New Features
 
-* `shares`: Import of SAML users and LDAP users
-* M1 apple silicon support SDK install (uses x86 ascp)
-* Support bulk operation more globally (create/delete), not all ops , though
-* Added missing transfer spec parameters, e.g. `src_base`, `password`
-* Improved documentation on faspex and aoc package send
+* `shares`: Import of SAML users and LDAP users.
+* M1 Apple Silicon support SDK install (uses x86 `ascp`).
+* Support bulk operation more globally (create/delete), not all ops, though.
+* Added missing transfer spec parameters, e.g. `src_base`, `password`.
+* Improved documentation on `faspex` and `aoc` `package send`.
 
 ### Issues Fixed
 
-* `node do` command fixed
-* Improved secret hiding from logs
+* `node do` command fixed.
+* Improved secret hiding from logs.
 
 ### Breaking Changes
 
-* Removed rarely commands `nodeadmin`, `configuration`, `userdata`, `ctl` from plugin `server`
-      as well as option `cmd_prefix`
-* `ascli` runs as user `cliuser` instead of `root` in container
-* Default access right for config folder is now user only, including private keys
+* Removed rarely commands `nodeadmin`, `configuration`, `userdata`, `ctl` from plugin `server` as well as option `cmd_prefix`.
+* `ascli` runs as user `cliuser` instead of `root` in container.
+* Default access right for config folder is now user only, including private keys.
 
 ## 4.8.0
 
@@ -630,20 +654,20 @@ Released: 2022-06-16
 
 ### New Features
 
-* #76 add resource `group_membership` in `aoc`
-* Add resource `metadata_profile` in `faspex5`
-* Add command `user profile` in `faspex5`
-* Add config wizard for `faspex5`
-* #75 gem is signed
+* #76 add resource `group_membership` in `aoc`.
+* Add resource `metadata_profile` in `faspex5`.
+* Add command `user profile` in `faspex5`.
+* Add config wizard for `faspex5`.
+* #75 gem is signed.
 
 ### Breaking Changes
 
 * Removed dependency on gem `grpc` which is used only for the `trsdk` transfer agent. Users can install the gem manually if needed.
-* Hash vault keys are string instead of symbol
-* Cleanup with rubocop, all strings are immutable now by default, list constants are frozen
-* Removed Hash.dig implementation because it is by default in Ruby >= 2.3
+* Hash vault keys are string instead of symbol.
+* Cleanup with `rubocop`, all strings are immutable now by default, list constants are frozen.
+* Removed `Hash.dig` implementation because it is by default in Ruby >= 2.3.
 * Default is now to hide secrets on command output. Set option `show_secrets` to reveal secrets.
-* Option `insecure` displays a warning
+* Option `insecure` displays a warning.
 
 ## 4.7.0
 
@@ -651,25 +675,25 @@ Released: 2022-03-23
 
 ### New Features
 
-* Option to specify font used to generate image of text file in `preview`
-* #66 improvement for content protection (support standard transfer spec options for direct agent)
-* Option `fpac` is now applicable to all ruby based HTTP connections, i.e. API calls
-* Option `show_secrets` to reveal secrets in command output
-* Added and updated commands for Faspex 5
-* Option `cache_tokens`
-* Faspex4 dropbox packages can now be received by id
+* Option to specify font used to generate image of text file in `preview`.
+* #66 improvement for content protection (support standard transfer spec options for direct agent).
+* Option `fpac` is now applicable to all Ruby based HTTP connections, i.e. API calls.
+* Option `show_secrets` to reveal secrets in command output.
+* Added and updated commands for Faspex 5.
+* Option `cache_tokens`.
+* Faspex4 dropbox packages can now be received by id.
 
 ### Issues Fixed
 
-* After AoC version update, wizard did not detect AoC properly
+* After AoC version update, wizard did not detect AoC properly.
 
 ### Breaking Changes
 
-* Command `conf gem path` replaces `conf gem_path`
-* Option `fpac` expects a value instead of URL
-* Option `cipher` in transfer spec must have hyphen
-* Renamed option `log_passwords` to `log_secrets`
-* Removed plugin `shares2` as products is now EOL
+* Command `conf gem path` replaces `conf gem_path`.
+* Option `fpac` expects a value instead of URL.
+* Option `cipher` in transfer spec must have hyphen.
+* Renamed option `log_passwords` to `log_secrets`.
+* Removed plugin `shares2` as products is now EOL.
 
 ## 4.6.0
 
@@ -677,24 +701,24 @@ Released: 2022-02-04
 
 ### New Features
 
-* Command `conf plugin create`
-* Global option `plugin_folder`
-* Global option `transpose_single`
-* Simplified metadata passing for shared inbox package creation in AoC
+* Command `conf plugin create`.
+* Global option `plugin_folder`.
+* Global option `transpose_single`.
+* Simplified metadata passing for shared inbox package creation in AoC.
 
 ### Issues Fixed
 
-* #60 ascli executable was not installed by default in 4.5.0
-* Add password hiding case in logs
+* #60 ascli executable was not installed by default in 4.5.0.
+* Add password hiding case in logs.
 
 ### Breaking Changes
 
-* Command `aoc packages shared_inboxes list` replaces `aoc user shared_inboxes`
-* Command `aoc user profile` replaces `aoc user info`
-* Command `aoc user workspaces list` replaces `aoc user workspaces`
-* Command `aoc user workspaces current` replaces `aoc workspace`
-* Command `conf plugin list` replaces `conf plugins`
-* Command `conf connect` simplified
+* `aoc`: `packages shared_inboxes list` replaces `aoc user shared_inboxes`.
+* `aoc`: `user profile` replaces `aoc user info`.
+* `aoc`: `user workspaces list` replaces `aoc user workspaces`.
+* `aoc`: `user workspaces current` replaces `aoc workspace`.
+* `config`: `plugin list` replaces `conf plugins`.
+* `config`: `connect` simplified.
 
 ## 4.5.0
 
@@ -702,24 +726,24 @@ Released: 2021-12-27
 
 ### New Features
 
-* Support transfer agent: [Transfer SDK](README.md#agt_trsdk)
-* Support [http socket options](README.md#http_options)
-* Logs hide passwords and secrets, option `log_passwords` to enable logging secrets
-* `config vault` supports encrypted passwords, also macos keychain
-* `config preset` command for consistency with id
-* Identifier can be provided using either option `id` or directly after the command, e.g. `delete 123` is the same as `delete --id=123`
+* Support transfer agent: [Transfer SDK](README.md#agt_trsdk).
+* Support [http socket options](README.md#http_options).
+* Logs hide passwords and secrets, option `log_passwords` to enable logging secrets.
+* `config vault` supports encrypted passwords, also macos keychain.
+* `config preset` command for consistency with macOS.
+* Identifier can be provided using either option `id` or directly after the command, e.g. `delete 123` is the same as `delete --id=123`.
 
 ### Issues Fixed
 
-* Various smaller fixes and renaming of some internal classes (transfer agents and few other)
+* Various smaller fixes and renaming of some internal classes (transfer agents and few others).
 
 ### Breaking Changes
 
-* When using wss, use [ruby's CA certs](README.md#certificates)
-* Unexpected parameter makes exit code not zero
-* Options `id` and `name` cannot be specified at the same time anymore, use [positional identifier or name selection](README.md#res_select)
-* `aoc admin res node` does not take workspace main node as default node if no `id` specified.
-* : `orchestrator workflow status` requires id, and supports special id `ALL`
+* When using WSS, use [Ruby's CA certs](README.md#certificates).
+* Unexpected parameter makes exit code not zero.
+* Options `id` and `name` cannot be specified at the same time anymore, use [positional identifier or name selection](README.md#res_select).
+* `aoc`: `admin res node` does not take workspace main node as default node if no `id` specified.
+* `orchestrator`: `workflow status` requires IS, and supports special IS `ALL`.
 
 ## 4.4.0
 
@@ -727,16 +751,16 @@ Released: 2021-11-13
 
 ### New Features
 
-* `aoc packages list` add possibility to add filter with option `query`
-* `aoc admin res xxx list` now get all items by default #50
-* `preset` option can specify name or hash value
-* `node` plugin accepts bearer token and access key as credential
+* `aoc packages list` add possibility to add filter with option `query`.
+* `aoc admin res xxx list` now get all items by default #50.
+* `preset` option can specify name or hash value.
+* `node` plugin accepts bearer token and access key as credential.
 * `node` option `token_type` allows using basic token in addition to aspera type.
 
 ### Breaking Changes
 
 * `server`: Option `username` not mandatory anymore: `xfer` user is by default. If transfer spec token is provided, password or keys are optional, and bypass keys are used by default.
-* Resource `apps_new` of `aoc` replaced with `application` (more clear)
+* Resource `apps_new` of `aoc` replaced with `application` (more clear).
 
 ## 4.3.0
 
@@ -753,21 +777,21 @@ Released: 2021-09-23
 
 ### New Features
 
-* `faspex package list` retrieves the whole list, not just first page
-* Support web based auth to aoc and faspex 5 using HTTPS, new dependency on gem `webrick`
-* The error "Remote host is not who we expected" displays a special remediation message
-* `conf ascp spec` displays supported transfer spec
-* Options `notif_to` and `notif_template` to send email notifications on transfer (and other events)
+* `faspex package list` retrieves the whole list, not just first page.
+* Support web based auth to aoc and faspex 5 using HTTPS, new dependency on gem `webrick`.
+* The error "Remote host is not who we expected" displays a special remediation message.
+* `conf ascp spec` displays supported transfer spec.
+* Options `notif_to` and `notif_template` to send email notifications on transfer (and other events).
 
 ### Issues Fixed
 
-* Space character in `faspe:` url are percent encoded if needed
-* `preview scan`: If file_id is unknown, ignore and continue scan
+* Space character in `faspe:` url are percent encoded if needed.
+* `preview scan`: If file_id is unknown, ignore and continue scan.
 
 ### Breaking Changes
 
-* For commands that potentially execute several transfers (`package recv --id=ALL`), if one transfer fails then ascli exits with code 1 (instead of zero=success)
-* Option `notify` or `aoc` replaced with `notif_to` and `notif_template`
+* For commands that potentially execute several transfers (`package recv --id=ALL`), if one transfer fails then `ascli` exits with code 1 (instead of zero=success).
+* Option `notify` or `aoc` replaced with `notif_to` and `notif_template`.
 
 ## 4.2.1
 
@@ -775,8 +799,8 @@ Released: 2021-09-01
 
 ### New Features
 
-* Command `faspex package recv` supports link of type: `faspe:`
-* Command `faspex package recv` supports option `recipient` to specify dropbox with leading `*`
+* Command `faspex package recv` supports link of type: `faspe:`.
+* Command `faspex package recv` supports option `recipient` to specify dropbox with leading `*`.
 
 ## 4.2.0
 
@@ -784,22 +808,22 @@ Released: 2021-08-24
 
 ### New Features
 
-* Command `aoc remind` to receive organization membership by email
-* In `preview` option `value` to filter out on file name
-* `initdemo` to initialize for demo server
-* [`direct`](README.md#agt_direct) transfer agent options: `spawn_timeout_sec` and `spawn_delay_sec`
+* Command `aoc remind` to receive organization membership by email.
+* In `preview` option `value` to filter out on file name.
+* `initdemo` to initialize for demo server.
+* [`direct`](README.md#agt_direct) transfer agent options: `spawn_timeout_sec` and `spawn_delay_sec`.
 
 ### Issues Fixed
 
-* On Windows `conf ascp use` expects ascp.exe
-* (break) multi_session_threshold is Integer, not String
-* `conf ascp install` renames sdk folder if it already exists (leftover shared lib may make fail)
-* Removed `replace_illegal_chars` from default `aspera.conf` causing "Error creating illegal char conversion table"
+* On Windows `conf ascp use` expects ascp.exe.
+* (break) multi_session_threshold is Integer, not String.
+* `conf ascp install` renames sdk folder if it already exists (leftover shared lib may make fail).
+* Removed `replace_illegal_chars` from default `aspera.conf` causing "Error creating illegal char conversion table".
 
 ### Breaking Changes
 
-* `aoc apiinfo` is removed, use `aoc servers` to provide the list of cloud systems
-* Parameters for resume in `transfer-info` for [`direct`](README.md#agt_direct) are now in sub-key `"resume"`
+* `aoc apiinfo` is removed, use `aoc servers` to provide the list of cloud systems.
+* Parameters for resume in `transfer-info` for [`direct`](README.md#agt_direct) are now in sub-key `"resume"`.
 
 ## 4.1.0
 
@@ -807,22 +831,22 @@ Released: 2021-06-23
 
 ### New Features
 
-* Update documentation with regard to offline and docker installation
-* Renamed command `nagios_check` to `health`
-* Agent `http_gw` now supports upload
-* Added option `sdk_url` to install SDK from local file for offline install
-* Check new gem version periodically
-* The --fields= option, support -_field_name_ to remove a field from default fields
-* Oauth tokens are discarded automatically after 30 minutes (useful for COS delegated refresh tokens)
-* `mimemagic` is now optional, needs manual install for `preview`, compatible with version 0.4.x
-* AoC a password can be provided for a public link
-* `conf doc` take an optional parameter to go to a section
-* Initial support for Faspex 5 Beta 1
+* Update documentation with regard to offline and docker installation.
+* Renamed command `nagios_check` to `health`.
+* Agent `http_gw` now supports upload.
+* Added option `sdk_url` to install SDK from local file for offline install.
+* Check new gem version periodically.
+* The --fields= option, support -_field_name_ to remove a field from default fields.
+* Oauth tokens are discarded automatically after 30 minutes (useful for COS delegated refresh tokens).
+* `mimemagic` is now optional, needs manual install for `preview`, compatible with version 0.4.x.
+* AoC a password can be provided for a public link.
+* `conf doc` take an optional parameter to go to a section.
+* Initial support for Faspex 5 Beta 1.
 
 ### Issues Fixed
 
-* Remove keys from transfer spec and command line when not needed
-* Default to `create_dir`:`true` so that sending single file to a folder does not rename file if folder does not exist
+* Remove keys from transfer spec and command line when not needed.
+* Default to `create_dir`:`true` so that sending single file to a folder does not rename file if folder does not exist.
 
 ## 4.0.0
 
@@ -830,432 +854,432 @@ Released: 2021-02-03
 
 ### New Features
 
-* Now available as open source (GitHub) with general cleanup
-* Added possibility to install SDK: `config ascp install`
+* Now available as open source (GitHub) with general cleanup.
+* Added possibility to install SDK: `config ascp install`.
 
 ### Breaking Changes
 
-* Changed default tool name from `mlia` to `ascli`
-* Changed `aspera` command to `aoc`
-* Changed gem name from `asperalm` to `aspera-cli`
-* Changed module name from `Asperalm` to `Aspera`
-* Removed command `folder` in `preview`, merged to `scan`
-* Persistency files go to sub folder instead of main folder
+* Changed default tool name from `mlia` to `ascli`.
+* Changed `aspera` command to `aoc`.
+* Changed gem name from `asperalm` to `aspera-cli`.
+* Changed module name from `Asperalm` to `Aspera`.
+* Removed command `folder` in `preview`, merged to `scan`.
+* Persistency files go to sub folder instead of main folder.
 
 ## 0.11.8
 
-* Simplified to use `unoconv` instead of bare `libreoffice` for office conversion, as `unoconv` does not require a X server (previously using `Xvfb`)
+* Simplified to use `unoconv` instead of bare `libreoffice` for office conversion, as `unoconv` does not require a X server (previously using `Xvfb`).
 
 ## 0.11.7
 
-* Rework on rest call error handling
-* Use option `display` with value `data` to remove out of extraneous information
-* Fixed option `lock_port` not working
-* Generate special icon if preview failed
-* Possibility to choose transfer progress bar type with option `progress`
-* AoC package creation now output package id
+* Rework on rest call error handling.
+* Use option `display` with value `data` to remove out of extraneous information.
+* Fixed option `lock_port` not working.
+* Generate special icon if preview failed.
+* Possibility to choose transfer progress bar type with option `progress`.
+* AoC package creation now output package id.
 
 ## 0.11.6
 
-* `orchestrator`: Added more choice in auth type
-* `preview`: Cleanup in generator (removed and renamed parameters)
-* `preview`: Better documentation
-* `preview`: Animated thumbnails for video (option: `video_png_conv=animated`)
-* `preview`: New event trigger: `trevents` (`events` seems broken)
-* `preview`: Unique tmp folder to avoid clash of multiple instances
-* Repo: Added template for secrets used for testing
+* `orchestrator`: Added more choice in auth type.
+* `preview`: Cleanup in generator (removed and renamed parameters).
+* `preview`: Better documentation.
+* `preview`: Animated thumbnails for video (option: `video_png_conv=animated`).
+* `preview`: New event trigger: `trevents` (`events` seems broken).
+* `preview`: Unique tmp folder to avoid clash of multiple instances.
+* Added template for secrets used for testing.
 
 ## 0.11.5
 
-* Added option `default_ports` for AoC (see manual)
-* Allow bulk delete in `aspera files` with option `bulk=yes`
-* Fix getting connect versions
-* Added section for Aix
-* Support all ciphers for [`direct`](README.md#agt_direct) agent (including gcm, etc..)
-* Added transfer spec param `apply_local_docroot` for [`direct`](README.md#agt_direct)
+* Added option `default_ports` for AoC (see manual).
+* Allow bulk delete in `aspera files` with option `bulk=yes`.
+* Fix getting connect versions.
+* Added section for Aix.
+* Support all ciphers for [`direct`](README.md#agt_direct) agent (including gcm, etc..).
+* Added transfer spec param `apply_local_docroot` for [`direct`](README.md#agt_direct).
 
 ## 0.11.4
 
-* Possibility to give shared inbox name when sending a package (else use id and type)
+* Possibility to give shared inbox name when sending a package (else use id and type).
 
 ## 0.11.3
 
-* Minor fixes on multi-session: Avoid exception on progress bar
+* Minor fixes on multi-session: Avoid exception on progress bar.
 
 ## 0.11.2
 
-* Fixes on multi-session: Progress bat and transfer spec param for "direct"
+* Fixes on multi-session: Progress bat and transfer spec param for "direct".
 
 ## 0.11.1
 
-* Enhanced short_link creation commands (see examples)
+* Enhanced short_link creation commands (see examples).
 
 ## 0.11
 
-* Add transfer spec option (agent `direct` only) to provide file list directly to ascp: `EX_file_list`
+* Add transfer spec option (agent `direct` only) to provide file list directly to ascp: `EX_file_list`.
 
 ## 0.10.18
 
-* New option in. `server` : `ssh_options`
+* New option in. `server` : `ssh_options`.
 
 ## 0.10.17
 
-* Fixed problem on `server` for option `ssh_keys`, now accepts both single value and list
-* New modifier: `@list:<separator>val1<separator>...`
+* Fixed problem on `server` for option `ssh_keys`, now accepts both single value and list.
+* New modifier: `@list:<separator>val1<separator>...`.
 
 ## 0.10.16
 
-* Added list of shared inboxes in workspace (or global), use `--query=@json:'{}'`
+* Added list of shared inboxes in workspace (or global), use `--query=@json:'{}'`.
 
 ## 0.10.15
 
-* In case of command line error, display the error cause first, and non-parsed argument second
-* `aoc`: Activity / Analytics
+* In case of command line error, display the error cause first, and non-parsed argument second.
+* `aoc`: Activity / Analytics.
 
 ## 0.10.14
 
-* Added missing bss plugin
+* Added missing bss plugin.
 
 ## 0.10.13
 
-* Added Faspex5 (use option `value` to give API arguments)
+* Added Faspex5 (use option `value` to give API arguments).
 
 ## 0.10.12
 
-* Added support for AoC node registration keys
-* Replaced option : `local_resume` with `transfer_info` for agent [`direct`](README.md#agt_direct)
-* Transfer agent is no more a Singleton instance, but only one is used in CLI
-* `@incps` : New extended value modifier
-* ATS: No more provides access keys secrets: now user must provide it
-* Begin work on "aoc" transfer agent
+* Added support for AoC node registration keys.
+* Replaced option : `local_resume` with `transfer_info` for agent [`direct`](README.md#agt_direct).
+* Transfer agent is no more a Singleton instance, but only one is used in CLI.
+* `@incps` : New extended value modifier.
+* ATS: No more provides access keys secrets: now user must provide it.
+* Begin work on `aoc` transfer agent.
 
 ## 0.10.11
 
-* Minor refactor and fixes
+* Minor refactor and fixes.
 
 ## 0.10.10
 
-* Fix on documentation
+* Fix on documentation.
 
 ## 0.10.9.1
 
-* Add total number of items for AoC resource list
-* Better gem version dependency (and fixes to support Ruby 2.0.0)
-* Removed aoc search_nodes
+* Add total number of items for AoC resource list.
+* Better gem version dependency (and fixes to support Ruby 2.0.0).
+* Removed `aoc search_nodes`.
 
 ## 0.10.8
 
-* Removed option: `fasp_proxy`, use pseudo transfer spec parameter: `EX_fasp_proxy_url`
-* Removed option: `http_proxy`, use pseudo transfer spec parameter: `EX_http_proxy_url`
-* Several other changes
+* Removed option: `fasp_proxy`, use pseudo transfer spec parameter: `EX_fasp_proxy_url`.
+* Removed option: `http_proxy`, use pseudo transfer spec parameter: `EX_http_proxy_url`.
+* Several other changes.
 
 ## 0.10.7
 
-* Fix: `ascli` fails when username cannot be computed on Linux
+* Fix: `ascli` fails when username cannot be computed on Linux.
 
 ## 0.10.6
 
-* FaspManager: Transfer spec `authentication` no more needed for local transfer to use Aspera public keys. public keys will be used if there is a token and no key or password is provided
-* Gem version requirements made more open
+* FaspManager: Transfer spec `authentication` no more needed for local transfer to use Aspera public keys. public keys will be used if there is a token and no key or password is provided.
+* Gem version requirements made more open.
 
 ## 0.10.5
 
-* Fix faspex package receive command not working
+* Fix faspex package receive command not working.
 
 ## 0.10.4
 
-* New options for AoC : `secrets`
-* `ACLI-533` temp file list folder to use file lists is set by default, and used by `asession`
+* New options for AoC : `secrets`.
+* `ACLI-533` temp file list folder to use file lists is set by default, and used by `asession`.
 
 ## 0.10.3
 
-* Included user name in oauth bearer token cache for AoC when JWT is used
+* Included user name in oauth bearer token cache for AoC when JWT is used.
 
 ## 0.10.2
 
-* Updated `search_nodes` to be more generic, so it can search not only on access key, but also other queries
-* Added doc for "cargo" like actions
-* Added doc for multi-session
+* Updated `search_nodes` to be more generic, so it can search not only on access key, but also other queries.
+* Added doc for "cargo" like actions.
+* Added doc for multi-session.
 
 ## 0.10.1
 
-* AoC and node v4 "browse" works now on non-folder items: file, link
-* Initial support for AoC automation (do not use yet)
+* AoC and node v4 "browse" works now on non-folder items: file, link.
+* Initial support for AoC automation (do not use yet).
 
 ## 0.10
 
-* Support for transfer using IBM Cloud Object Storage
-* Improved `find` action using arbitrary expressions
+* Support for transfer using IBM Cloud Object Storage.
+* Improved `find` action using arbitrary expressions.
 
 ## 0.9.36
 
-* Added option to specify file pair lists
+* Added option to specify file pair lists.
 
 ## 0.9.35
 
-* `preview`: Changed parameter names, added documentation
-* `ats`: Fix: instance ID needed in request header
+* `preview`: Changed parameter names, added documentation.
+* `ats`: Fix: instance ID needed in request header.
 
 ## 0.9.34
 
-* Parser "@preset" can be used again in option "transfer_info"
-* Some documentation re-organizing
+* Parser "@preset" can be used again in option "transfer_info".
+* Some documentation re-organizing.
 
 ## 0.9.33
 
-* New command to display basic token of node
-* New command to display bearer token of node in AoC
-* The --fields= option, support +_field_name_ to add a field to default fields
-* Many small changes
+* New command to display basic token of node.
+* New command to display bearer token of node in AoC.
+* The `--fields=` option, support `+_field_name_` to add a field to default fields.
+* Many small changes.
 
 ## 0.9.32
 
 ### New Features
 
-* All Faspex public links are now supported
+* All Faspex public links are now supported.
 * Removed faspex operation `recv_publink`. Replaced with option `link` (consistent with AoC).
 
 ## 0.9.31
 
 ### New Features
 
-* Added more support for public link: receive and send package, to user or dropbox and files view
-* Delete expired file lists
-* Changed text table gem from text-table to terminal-table because it supports multiline values
+* Added more support for public link: receive and send package, to user or dropbox and files view.
+* Delete expired file lists.
+* Changed text table gem from text-table to terminal-table because it supports multiline values.
 
 ## 0.9.27
 
 ### New Features
 
-* Basic email support with SMTP
-* Basic proxy auto config support
+* Basic email support with SMTP.
+* Basic proxy auto config support.
 
 ## 0.9.26
 
 ### New Features
 
-* Table display with `--fields=ALL` now includes all column names from all lines, not only first one
-* Unprocessed argument shows error even if there is an error beforehand
+* Table display with `--fields=ALL` now includes all column names from all lines, not only first one.
+* Unprocessed argument shows error even if there is an error beforehand.
 
 ## 0.9.25
 
 ### New Features
 
-* The option `value` of command `find`, to filter on name, is not optional
-* `find` now also reports all types (file, folder, link)
-* `find` now is able to report all fields (type, size, etc...)
+* The option `value` of command `find`, to filter on name, is not optional.
+* `find` now also reports all types (file, folder, link).
+* `find` now is able to report all fields (type, size, etc...).
 
 ## 0.9.24
 
 ### New Features
 
-* Fix bug where AoC node to node transfer did not work
-* Fix bug on error if ED25519 private key is defined in .ssh
+* Fix bug where AoC node to node transfer did not work.
+* Fix bug on error if ED25519 private key is defined in .ssh.
 
 ## 0.9.23
 
 ### New Features
 
-* Defined REST error handlers, more error conditions detected
-* Commands to select specific ascp location
+* Defined REST error handlers, more error conditions detected.
+* Commands to select specific ascp location.
 
 ## 0.9.21
 
 ### New Features
 
-* Supports simplified wizard using global client
-* Only `ascp` binary is required, other SDK (keys) files are now generated
+* Supports simplified wizard using global client.
+* Only `ascp` binary is required, other SDK (keys) files are now generated.
 
 ## 0.9.20
 
 ### New Features
 
-* Improved wizard (prepare for AoC global client id)
-* Preview generator: Added option : --skip-format=&lt;png,mp4&gt;
-* Removed outdated pictures from this doc
+* Improved wizard (prepare for AoC global client id).
+* Preview generator: Added option : --skip-format=&lt;png,mp4&gt;.
+* Removed outdated pictures from this doc.
 
 ## 0.9.19
 
 ### New Features
 
-* Added command `aspera bearer --scope=xx`
+* Added command `aspera bearer --scope=xx`.
 
 ## 0.9.18
 
 ### New Features
 
-* Enhanced aspera admin events to support query
+* Enhanced aspera admin events to support query.
 
 ## 0.9.16
 
 ### New Features
 
-* AoC transfers are now reported in activity app
-* New interface for Rest class authentication (keep backward compatibility)
+* AoC transfers are now reported in activity app.
+* New interface for Rest class authentication (keep backward compatibility).
 
 ## 0.9.15
 
 ### New Features
 
-* New feature: "find" command in aspera files
-* Sample code for transfer API
+* New feature: "find" command in aspera files.
+* Sample code for transfer API.
 
 ## 0.9.12
 
 ### New Features
 
-* Add nagios commands
-* Support of ATS for IBM Cloud, removed old version based on aspera id
+* Add nagios commands.
+* Support of ATS for IBM Cloud, removed old version based on aspera id.
 
 ## 0.9.11
 
-* Support of ATS for IBM Cloud, removed old version based on aspera id
+* Support of ATS for IBM Cloud, removed old version based on aspera id.
 
 ### Breaking Changes
 
-* **global**: `@stdin` is now `@stdin:`
+* **global**: `@stdin` is now `@stdin:`.
 
 ## 0.9.10
 
-* Display SaaS storage usage with command: `aspera admin res node --id=nn info`
-* Cleaner way of specifying source file list for transfers
+* Display SaaS storage usage with command: `aspera admin res node --id=nn info`.
+* Cleaner way of specifying source file list for transfers.
 
 ### Breaking Changes
 
-* **global**: Parameter transfer-node becomes more generic: `transfer-info`
-* **global**: Replaced download_mode option with http_download action
+* **global**: Parameter transfer-node becomes more generic: `transfer-info`.
+* **global**: Replaced download_mode option with http_download action.
 
 ## 0.9.9
 
 ### New Features
 
-* Now supports "cargo" for Aspera on Cloud (automatic package download)
+* Now supports "cargo" for Aspera on Cloud (automatic package download).
 
 ### Breaking Changes
 
-* **global**: "aspera package send" parameter deprecated, use the --value option instead with "recipients" value. See example
+* **global**: "aspera package send" parameter deprecated, use the --value option instead with "recipients" value. See example.
 
 ## 0.9.8
 
 ### New Features
 
-* `faspex`: Use option `once_only` set to `yes` to enable cargo like function. id=NEW deprecated
-* `aoc`: Share to share transfer with command `transfer`
+* `faspex`: Use option `once_only` set to `yes` to enable cargo like function. id=NEW deprecated.
+* `aoc`: Share to share transfer with command `transfer`.
 
 ## 0.9.7
 
 ### New Features
 
-* Homogeneous transfer spec for `node` and [`direct`](README.md#agt_direct) transfer agents
-* Preview persistency goes to unique file by default
-* Catch mxf extension in preview as video
-* Faspex: Possibility to download all packages by specifying id=ALL
-* Faspex: To come: Cargo-like function to download only new packages with id=NEW
+* Homogeneous transfer spec for `node` and [`direct`](README.md#agt_direct) transfer agents.
+* Preview persistency goes to unique file by default.
+* Catch mxf extension in preview as video.
+* Faspex: Possibility to download all packages by specifying id=ALL.
+* Faspex: To come: Cargo-like function to download only new packages with id=NEW.
 
 ## 0.9.6
 
 ### New Features
 
-* AoC: Added command to display current workspace information
+* AoC: Added command to display current workspace information.
 
 ### Breaking Changes
 
-* **global**: `@param:`is now `@preset:` and is generic
+* **global**: `@param:`is now `@preset:` and is generic.
 
 ## 0.9.5
 
 ### New Features
 
-* New parameter: `new_user_option` used to choose between public_link and invite of external users
-* Fixed bug in wizard, and wizard uses now product detection
+* New parameter: `new_user_option` used to choose between public_link and invite of external users.
+* Fixed bug in wizard, and wizard uses now product detection.
 
 ## 0.9.4
 
 ### New Features
 
-* AoC Package send supports external users
-* New command to export AoC config to Aspera CLI config
+* AoC Package send supports external users.
+* New command to export AoC config to Aspera CLI config.
 
 ### Breaking Changes
 
-* `oncloud`: `oncloud file list` follow `--source` convention as well (plus specific case for download when first path is source folder, and other are source file names)
+* `oncloud`: `oncloud file list` follow `--source` convention as well (plus specific case for download when first path is source folder, and other are source file names).
 
 ## 0.9.3
 
 ### New Features
 
-* REST error message show host and code
-* Option for quiet display
-* Modified transfer interface and allow token re-generation on error
-* `async` add `admin` command
-* `async` add db parameters
+* REST error message show host and code.
+* Option for quiet display.
+* Modified transfer interface and allow token re-generation on error.
+* `async` add `admin` command.
+* `async` add db parameters.
 
 ### Breaking Changes
 
-* **global**: New option `sources` to specify files to transfer
+* **global**: New option `sources` to specify files to transfer.
 
 ## 0.9.2
 
 ### Breaking Changes
 
-* `aoc`: Changed AoC package creation to match API, see AoC section
+* `aoc`: Changed AoC package creation to match API, see AoC section.
 
 ## 0.9.1
 
 ### Breaking Changes
 
-* `faspex`: Changed faspex package creation to match API, see Faspex section
+* `faspex`: Changed faspex package creation to match API, see Faspex section.
 
 ## 0.9
 
 ### New Features
 
-* Automatic rename and conversion of former config folder from aslmcli to ascli
+* Automatic rename and conversion of former config folder from aslmcli to ascli.
 
 ### Breaking Changes
 
-* Renamed the CLI from aslmcli to ascli
+* Renamed the CLI from aslmcli to ascli.
 
 ## 0.7.6
 
 ### New Features
 
-* Add `sync` plugin
+* Add `sync` plugin.
 
 ## 0.7
 
 ### New Features
 
-* AoC: Receive package from public link
-* Select by col value on output
-* Added rename (AoC, node)
+* AoC: Receive package from public link.
+* Select by col value on output.
+* Added rename (AoC, node).
 
 ### Breaking Changes
 
-* `aoc`: AoC `package recv` take option if for package instead of argument
-* **global**: Rest class and Oauth class changed init parameters
+* `aoc`: AoC `package recv` take option if for package instead of argument.
+* **global**: Rest class and Oauth class changed init parameters.
 
 ## 0.6.19
 
 ### Breaking Changes
 
-* `ats`: `ats server list provisioned` &rarr; `ats cluster list`
-* `ats`: `ats server list clouds` &rarr; `ats cluster clouds`
-* `ats`: `ats server list instance --cloud=x --region=y` &rarr; `ats cluster show --cloud=x --region=y`
-* `ats`: `ats server id xxx` &rarr; `ats cluster show --id=xxx`
-* `ats`: `ats subscriptions` &rarr; `ats credential subscriptions`
-* `ats`: `ats api_key repository list` &rarr; `ats credential cache list`
-* `ats`: `ats api_key list` &rarr; `ats credential list`
-* `ats`: `ats access_key id xxx` &rarr; `ats access_key --id=xxx`
+* `ats`: `ats server list provisioned` &rarr; `ats cluster list`.
+* `ats`: `ats server list clouds` &rarr; `ats cluster clouds`.
+* `ats`: `ats server list instance --cloud=x --region=y` &rarr; `ats cluster show --cloud=x --region=y`.
+* `ats`: `ats server id xxx` &rarr; `ats cluster show --id=xxx`.
+* `ats`: `ats subscriptions` &rarr; `ats credential subscriptions`.
+* `ats`: `ats api_key repository list` &rarr; `ats credential cache list`.
+* `ats`: `ats api_key list` &rarr; `ats credential list`.
+* `ats`: `ats access_key id xxx` &rarr; `ats access_key --id=xxx`.
 
 ## 0.6.18
 
 ### New Features
 
-* Some commands take now `--id` option instead of `id` command
+* Some commands take now `--id` option instead of `id` command.
 
 ## 0.6.15
 
 ### Breaking Changes
 
-* `aspera`: `files` application renamed to `aspera` (for "Aspera on Cloud"). `repository` renamed to `files`. Default is automatically reset, e.g. in config files and change key `files` to `aspera` in preset `default`
+* `aspera`: `files` application renamed to `aspera` (for "Aspera on Cloud"). `repository` renamed to `files`. Default is automatically reset, e.g. in config files and change key `files` to `aspera` in preset `default`.