MuranoCLI 3.2.1.pre.beta.4 → 3.2.1.pre.beta.5

data/HISTORY.md

@@ -0,0 +1,826 @@
+# Murano CLI Release Notes
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.1.pre.beta.5 (2018-08-09)
+
+### New
+
+- New Business commands (Issue: [MUR-6808](https://i.exosite.com/jira/browse/MUR-6808)):
+
+  `murano business show`
+
+  `murano business members`
+
+  `murano business set name`
+
+  `murano business set email`
+
+  `murano business set contact`
+
+- This new changelog! `HISTORY.md` (Issue: [MUR-7654](https://i.exosite.com/jira/browse/MUR-7654))
+
+### Improved
+
+- Remove erroneous third-party library warning.
+
+  - Update `murano-cli-commander` to upstream version 4.4.6 to prevent erroneous, misleading error message reported from library.
+
+- Replace deprecated BizAPI `overview/` endpoint usage. (Issue: [MUR-6808](https://i.exosite.com/jira/browse/MUR-6808))
+
+### Fixed
+
+- Bugfix: Fix `business find` to match on either bizid or fuzzy name by default (not just bizid). (Issue: [MUR-7361](https://i.exosite.com/jira/browse/MUR-7361))
+
+### Developer improvements
+
+- New Ruby Gem release Rake tasks (and accompanying release help doc). (Issue: [MUR-7654](https://i.exosite.com/jira/browse/MUR-7654))
+
+- New Semantic Versioning Rake tasks. (Issue: [MUR-7654](https://i.exosite.com/jira/browse/MUR-7654))
+
+- New GitHub PR shortcut Rake task. (Issue: [MUR-7654](https://i.exosite.com/jira/browse/MUR-7654))
+
+- New WebMock Snapshot infrastructure (to reduce unit test runtime from
+  30 minutes to under 1 minute). (Issue: [MUR-7654](https://i.exosite.com/jira/browse/MUR-7654))
+
+- Add additional debug messages when "corrupt" cache file fails to load. (Issue: [MUR-5281](https://i.exosite.com/jira/browse/MUR-5281))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.1.pre.beta.4 (2018-07-30)
+
+### Fixed
+
+- #### Sync regressions.
+
+  - Fix regression failures introduced to `murano syncup` and `murano syncdown`. (Issue: [MUR-7424](https://i.exosite.com/jira/browse/MUR-7424))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.1.pre.beta.3 (2018-07-26)
+
+### Improved
+
+- On `murano syncup`, scrub client-side only properties. (Issue: [MUR-7424](https://i.exosite.com/jira/browse/MUR-7424))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.1.pre.beta.2 (2018-07-26)
+
+#### Note: There is no official, published release for v3.2.1.pre.beta.2.
+
+### Fixed
+
+- #### Fix regressions and unit tests. (Issue: [MUR-7352](https://i.exosite.com/jira/browse/MUR-7352))
+
+  - Unit tests: Multiple unit test bugs fixed.
+
+  - Bugfix: Scrub local-only Item attributes on `syncup`.
+
+  - Bugfix: On syncup, process "phantom" items specially.
+
+  - Bugfix: Fix status/diff of 0-sized Asset items.
+
+  - Bugfix: Whitelist `config_service` and `config_status`.
+
+  - Bugfix: Fix handling of Endpoint headers.
+
+  - Bugfix: Avoid false positive duplicate conflict on local items sync.
+
+  - Bugfix: Typo in `config --locations` caused scope not to print.
+
+  - Bugfix: Avoid nil-reference errors in `Item.location_friendly`.
+
+  - Bugfix: Fix loading LUA route scripts from grandchild dirs.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.1.pre.beta.1 (2018-07-26)
+
+#### Note: There is no official, published release for v3.2.1.pre.beta.1.
+
+### New
+
+- #### CSR Authentication support
+
+  - Feature: Add "csr" auth-type support. (Issue: [MUR-7349](https://i.exosite.com/jira/browse/MUR-7349))
+
+### Improved
+
+- Update deprecated reference from `tier.network` to `tier.features.network`. (Issue: [MUR-6815](https://i.exosite.com/jira/browse/MUR-6815))
+
+### Fixed
+
+- Regression: Prevent nil reference error in Account.businesses.
+
+  - Introduced with `network` commands.
+
+- Regression: Fix `syncup`/`syncdown`/`status`/`diff` re: header handling.
+
+  - Earlier code to fix solution template issues broke
+    header handling, causing issues with sync and status/diff.
+
+- Bugfix: Silence erroneous unknown-config-key warnings.
+
+- Bugfix: `Config.get` `@exclude_scopes` was not being applied correctly.
+
+- Remove erroneous warning about `business.child` config key.
+
+- Remove display of nonexistent keys "email" and "contact" from `murano child show` command.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0 (2018-06-28)
+
+### NOTE: Version 3.2.0 has sync command regressions.
+
+## - **You are advised to _avoid this version (v3.2.0)_.**
+
+### New
+
+- #### Business Network: Manage Child Businesses
+
+  - Create/Delete Network Child Businesses and Add/Remove Members. (Issues: [MUR-6969](https://i.exosite.com/jira/browse/MUR-6969), [MUR-6970](https://i.exosite.com/jira/browse/MUR-6970), [MUR-6971](https://i.exosite.com/jira/browse/MUR-6971), [MUR-6974](https://i.exosite.com/jira/browse/MUR-6974))
+
+    - This includes the following new commands: `murano network children`, `murano network new`, `murano network delete`, `murano child show`, `murano child add`, and `murano child remove`.
+
+### Improved
+
+- Extend `business` commands to show network information when applicable. (Issue: [MUR-6975](https://i.exosite.com/jira/browse/MUR-6975))
+
+  - Improve `business list` and `business find` commands: Add new `--network` option, which adds an extra column with additional network information.
+
+### Fixed
+
+- Bugfix: Business ID in config is case sensitive but does not have validation. (Issue: [MUR-7233](https://i.exosite.com/jira/browse/MUR-7233))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.9 (2018-06-20)
+
+### Improved
+
+- Improvement: Warn user if config key (from `-c` or file) is not valid. (Issue: [MUR-7233](https://i.exosite.com/jira/browse/MUR-7233))
+
+### Fixed
+
+- Bugfix: Value-less key in config breaks login. (Issue: [MUR-7232](https://i.exosite.com/jira/browse/MUR-7232))
+
+  - Check `user.name` not nil before duck typing.
+
+  - Attempting to log in without a username in config causes a crash.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.8 (2018-06-14)
+
+### New
+
+- #### Business Network: Name and Edit Parent Network
+
+  - Add business network view and configure commands, under `murano network`: `network view` and `network configure`. (Issues: [MUR-6972](https://i.exosite.com/jira/browse/MUR-6972), [MUR-6973](https://i.exosite.com/jira/browse/MUR-6973))
+
+### Improved
+
+- Enhancement: Prevent false-positive on diff when service excludes (optional) `#HEADER`. (Issue: [MUR-6562](https://i.exosite.com/jira/browse/MUR-6562))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.7 (2018-06-14)
+
+- No new features or bugfixes.
+
+  - Intermediate build used to troubleshoot the Jenkins Gem release runner.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.6 (2018-06-05)
+
+### New
+
+- Feature: Restrict commands for managed Solutions, based on new Solution property, "managed". (Issue: [MUR-6691](https://i.exosite.com/jira/browse/MUR-6691))
+
+  - Note that Exosite employees -- users whose email address ends with `@exosite.com` -- are free to run any command against a managed Solution.
+
+### Improved
+
+- Docs: Improve `business list` help (explain how to delimit special characters). (Issue: [MUR-6107](https://i.exosite.com/jira/browse/MUR-6107))
+
+### Fixed
+
+- Bugfix: Correct table column header text to not span 2 columns. (Issue: [MUR-4989](https://i.exosite.com/jira/browse/MUR-4989))
+
+- Bugfix: Encode keystore command key and values. (Issue: [MUR-4363](https://i.exosite.com/jira/browse/MUR-4363))
+
+  - Otherwise, e.g., a keystore key name containing `/` would not work correctly.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.5 (2018-05-01)
+
+### New
+
+- #### `service` command
+
+  - New `service` command with subcommands: `add`, `delete`, `get`, `list`. (Issue: [MUR-5880](https://i.exosite.com/jira/browse/MUR-5880))
+
+### Improved
+
+- New `token delete <any-token>` command.
+
+- Sort `exchange list` like `service list` sort.
+
+- Hide password in curldebug output.
+
+- New `tool.curlfancy` option for even more curldebug output!
+
+### Fixed
+
+- Bugfix: Catch Postgres failure and handle error gracefully.
+
+- Bugfix: Add missing `tool.*` default to `murano config --dump`.
+
+- Bugfix: Fix `exchange` pagination.
+
+- Bugfix: Fix `-c` config setting option to work with boolean values.
+
+- Bugfix: Let user skip Application and/or Product on murano-init. (Issue: [MUR-6456](https://i.exosite.com/jira/browse/MUR-6456))
+
+- Bugfix: `status` and `diff` were showing false positives because SHA1 → MD5.
+
+- Regression: Workaround issue uploading empty files. (Issues: [MUR-6479](https://i.exosite.com/jira/browse/MUR-6479), [MUR-6477](https://i.exosite.com/jira/browse/MUR-6477))
+
+- Bugfix: Fix problem not being able to murano-diff nested files. (Issue: [MUR-6488](https://i.exosite.com/jira/browse/MUR-6488))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.4 (2018-05-01)
+
+#### Note: There is no official, published release for v3.2.0.beta.4.
+
+### New
+
+- #### Exchange Element improvements
+
+  - New Update Element action. (Issue: [MUR-6407](https://i.exosite.com/jira/browse/MUR-6407))
+
+    - New command, element edit`.
+
+    - New command, `element show`.
+
+    - Bugfix: Have `--csv` always use quotes (even when a value may not need to be quoted).
+
+    - Bugfix: Use forked commander lib. to handle empty string arguments, e.g., `--option ''`.
+
+    - Bugfix: Add support for ARGV end-of-options indicator, `--`.
+
+    - Bugfix: Add bare `murano element` command help.
+
+    - Bugfix: Make zero or 1+ elements found error more readable.
+
+    - Bugfix: New option, `--elem-type`, to include "type" in exchange element list table.
+
+    - Bugfix: Fix splitting table column at terminal width (off-by-one).
+
+### Improved
+
+- Helpdocs: Rename: 'IOT Exchange' => 'IoT Marketplace'.
+
+### Fixed
+
+- Bugfix: Do not repeat "base" path in `murano show --location`, and sort by keyname.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.3 (2018-05-01)
+
+#### Note: There is no official, published release for v3.2.0.beta.3.
+
+### Fixed
+
+- #### Sync commands improvements and bugfixes
+
+  - Bugfix: Change default directories to match new GitHub template. (Issues: [MUR-6329](https://i.exosite.com/jira/browse/MUR-6329), [MUR-6562](https://i.exosite.com/jira/browse/MUR-6562))
+
+  - Bugfix: Improve `syncup/syncdown` to handle multiple items specified in the same file (module). (Issue: [MUR-6562](https://i.exosite.com/jira/browse/MUR-6562))
+
+  - Bugfix: Group duplicate items by synckey, so user knows which files conflict. (Issue: [MUR-6562](https://i.exosite.com/jira/browse/MUR-6562))
+
+  - Bugfix: Add line numbers to diff output, to make entries distinct. (Issue: [MUR-6562](https://i.exosite.com/jira/browse/MUR-6562))
+
+  - Bugfix: Correct item line numbering: make 1-based (like diff); and do not overlap line numbers for segment beginning and end. (Issue: [MUR-6562](https://i.exosite.com/jira/browse/MUR-6562))
+
+  - Bugfix: Fix sync up/down item filtering to not check for `\`-delimited `*`'s in file glob (i.e., `\*` ). (Issue: [MUR-6414](https://i.exosite.com/jira/browse/MUR-6414))
+
+- #### Miscellaneous bugfixes
+
+  - Bugfix: `muruno postgresql` crashes trying to parse results. (Issue: [MUR-6545](https://i.exosite.com/jira/browse/MUR-6545))
+
+  - Bugfix: Update `unicode-display_width` dependency to at least version `1.3.2` to avoid version `1.3.1` crashing Murano CLI on load.
+
+  - Bugfix: Update `rb-commander` dependency from version `4.4.3` to `4.4.4` to avoid seeing meaningless warning injected from library.
+
+### Developer improvements
+
+- Enhance test runner to retry failed tests, which are often caused by BizAPI timeouts, to avoid false-positive test failures.
+
+- New `tool.developer` option to enable logging of dev-only messages.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.2 (2018-05-01)
+
+#### Note: There is no official, published release for v3.2.0.beta.2.
+
+### New
+
+- #### New `service` commands
+
+  - New `service` commands.
+
+    - New command, `murano service add`. (Issue: [MUR-6265](https://i.exosite.com/jira/browse/MUR-6265))
+
+    - New command, `murano service list`, lists all the services in a solution. (Issue: [MUR-5880](https://i.exosite.com/jira/browse/MUR-5880))
+
+    - New command, `murano service delete`, to delete services. (Issue: [MUR-5881](https://i.exosite.com/jira/browse/MUR-5881))
+
+    - New `service get` command to query individual service. (Issue: [MUR-5881](https://i.exosite.com/jira/browse/MUR-5881))
+
+### Improved
+
+- Sort `murano exchange list` results (similar to how new `murano service list`
+  results are sorted).
+
+- Enhance `murano token delete` to accept any token.
+
+  - E.g., a simple `murano token delete` will delete the current user's active token, whereas `murano token delete <token>` will delete the specified token.
+
+- Improve Postgres error handling reporting.
+
+  - Print platform-supplied error message before exiting.
+
+### Fixed
+
+- Fix `-c` option to work with bools.
+
+  - E.g., so that `murano ... -c tool.curldebug=false` works.
+
+- Bugfix: Let user skip Application and/or Product on `murano init`. (Issue: [MUR-6456](https://i.exosite.com/jira/browse/MUR-6456))
+
+- Add missing Asset file keys (`md5` and `size`; recently added to backend service).
+
+### Developer improvements
+
+- Hide password in `curldebug` output.
+
+- Add missing `tool.*` defaults, so they appear in `murano config --dump`.
+
+- Refactor and fix Murano CLI source code unit tests.  (Issues: [MUR-5939](https://i.exosite.com/jira/browse/MUR-5939), [MUR-5880](https://i.exosite.com/jira/browse/MUR-5880), [MUR-5881](https://i.exosite.com/jira/browse/MUR-5881), [MUR-6265](https://i.exosite.com/jira/browse/MUR-6265), [MUR-6561](https://i.exosite.com/jira/browse/MUR-6561))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.2.0.beta.1 (2018-02-01)
+
+### New
+
+- #### Token Authentication
+
+  - Change default authentication to token, from username-password authentication. (Issue: [MUR-5939](https://i.exosite.com/jira/browse/MUR-5939))
+
+    - The user will be prompted for a password on initial login, but password is no longer cached by default. Instead, the token will be cached by default.
+
+    - You can override this behavior and have the password cached locally by specifying the `--cache` runtime option, or by setting the `auth.persist-basic` config option to `true`. (By default, `auth.persist-token` is true, signifying that the token should be cached (which can similarly be overridden at runtime by specifying `--no-token`).)
+
+    - You can configure the token time-to-live using the `auth.ttl` config option, or the `--ttl` runtime option. The default is 2 days (specified in seconds, i.e., `172800`).
+
+    - Add new `murano token` command, similar to `murano password` command.
+
+      - Replace `murano logout --token` feature with `murano token delete`.
+
+    - Clear all credentials using `murano logout`.
+
+      - You can logout but keep your user name and business ID cached by running: `murano logout --keep-user`.
+
+### Improved
+
+- Quickly check the username for the current project using `murano whoami`.
+
+### Fixed
+
+- Catch I/O error on opening curlfile and handle exception. (Issue: [MUR-5939](https://i.exosite.com/jira/browse/MUR-5939))
+
+- Catch YAML load error on cache file and explain error -- and fix -- before gracefully dying.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0 (2018-01-25)
+
+### New
+
+- #### Service & Script Debug Logs
+
+  - CLI now uses a WebSocket to stream solution logs. (Issue: [MUR-5105](https://i.exosite.com/jira/browse/MUR-5105))
+
+    - Use `--follow` to stream logs over WSS.
+
+      Otherwise, CLI fetches previous 20 logs entries over HTTP.
+
+    - Use filtering options to fetch only certain records. (Issue: [MUR-5108](https://i.exosite.com/jira/browse/MUR-5108))
+
+      E.g., `--message`, `--severity`, `--types`, etc.
+
+    - Use formatting options to change the output. (Issue: [MUR-5109](https://i.exosite.com/jira/browse/MUR-5109))
+
+      E.g., `--message-only`, `--one-line`, `--json`, etc.
+
+    - Refer to the app for detailed help and examples. (Issue: [MUR-5113](https://i.exosite.com/jira/browse/MUR-5113))
+
+      E.g., `murano logs --help`
+
+- #### Close source source code
+
+  - Close source source code. (Issue: [MUR-4309](https://i.exosite.com/jira/browse/MUR-4309))
+
+    - Change LICENSE, privatize repository, migrate Jenkins to Docker.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0.beta.8 (2018-01-18)
+
+### Developer improvements
+
+- #### Docker enhancements
+
+  - Simplify Dockerfiles: Use `dnl` to not copy comments. (Issue: [MUR-4309](https://i.exosite.com/jira/browse/MUR-4309))
+
+  - Avoid NoMethodError on delete failure: Check delete_solution return value nil?
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0.beta.7 (2018-01-18)
+
+### Developer improvements
+
+- #### Dockerization
+
+    - Intermediate build used to implement new Jenkins Gem release runner. (Issue: [MUR-4309](https://i.exosite.com/jira/browse/MUR-4309))
+
+    - No new features or bugfixes.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0.beta.6 (2018-01-18)
+
+#### Note: There is no official, published release for v3.1.0.beta.6.
+
+### Developer improvements
+
+- #### Dockerization
+
+    - Intermediate build used to implement new Jenkins Gem release runner. (Issue: [MUR-4309](https://i.exosite.com/jira/browse/MUR-4309))
+
+    - No new features or bugfixes.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0.beta.5 (2018-01-18)
+
+### Developer improvements
+
+- #### Dockerization
+
+    - Add Dockerfiles and shell scripts for new Jenkins server. (Issue: [MUR-4309](https://i.exosite.com/jira/browse/MUR-4309))
+
+    - No new features or bugfixes.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0.beta.4 (2018-01-18)
+
+### Improved
+
+- ### Windows bug triaging
+
+  - Add verbose messages for Windows mkdir error. (Issue: [MUR-5081](https://i.exosite.com/jira/browse/MUR-5081))
+
+### Developer improvements
+
+- #### Jenkins testing
+
+  - Fix headless (Jenkins) tests: Skip terminal stuff if !tty? and use --ascii if UTF-8 encoding not detected. (Issue: [MUR-4309](https://i.exosite.com/jira/browse/MUR-4309))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0.beta.3 (2018-01-12)
+
+### New
+
+- #### WSS Logging
+
+  - Fix issue using `--tracking` format option.
+
+### Improved
+
+- Remove post-Gem install message.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0.beta.2 (2018-01-11)
+
+### New
+
+- #### WSS Logging
+
+  - Add more examples to the logs command `--help`. (Issue: [MUR-5113](https://i.exosite.com/jira/browse/MUR-5113))
+
+  - Fix Hash syntax for Ruby 2.0 compliance.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.1.0.beta.1 (2018-01-10)
+
+### New
+
+- ### WSS Logging
+
+  - Implement WebSocket logs feature. (Issue: [MUR-5105](https://i.exosite.com/jira/browse/MUR-5105))
+
+  - Lots of logs command filtering options. (Issue: [MUR-5108](https://i.exosite.com/jira/browse/MUR-5108))
+
+    - E.g., --message, --severity, --types, etc.
+
+  - Lots of logs command formatting options. (Issue: [MUR-5109](https://i.exosite.com/jira/browse/MUR-5109))
+
+    - E.g., --message-only, --one-line, --json, etc.
+
+  - Update logs command inline --help. (Issue: [MUR-5113](https://i.exosite.com/jira/browse/MUR-5113))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.8 (2017-12-19)
+
+### Fixed
+
+- #### Bugfixes to `syncup`/`syncdown`
+
+  - Fix `syncup`/`syncdown` of "undeletable" event handlers. (Issues: [MUR-5153](https://i.exosite.com/jira/browse/MUR-5153), [MUR-5154](https://i.exosite.com/jira/browse/MUR-5154))
+
+    - This includes: `*.event`, `timer.timer`, `tsdb.exportJob`, and `user.account`.
+
+  - Set `script` in remote event handler to empty string when local script removed, rather than deleting remote event handler.
+
+  - Do not add trailing newline to synced script unless there previously. (Issue: [MUR-5156](https://i.exosite.com/jira/browse/MUR-5156))
+
+  - Fix specifying individual paths on `syncdown`. (Issue: [MUR-5042](https://i.exosite.com/jira/browse/MUR-5042))
+
+    - Allow relative paths rather than requiring absolute paths to files.
+
+- #### New config options
+
+  - Use `net.protocol` to specify HTTP (not HTTPS) BizAPI endpoint.
+
+    E.g.,:
+
+     `murano config net.host localhost --project`
+
+     `murano config net.protocol http --project`
+
+  - Use `--debug` as shortcut to setting `tool.debug=true`.
+
+### Improved
+
+- Show diff of items being added or removed when debugging (`-c tool.debug`).
+
+- Lots of linting fixes.
+
+### Developer improvements
+
+- Update source file copyright headers and change LICENSE. (Issue: [MUR-4309](https://i.exosite.com/jira/browse/MUR-4309))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.7 (2017-11-03)
+
+### New
+
+- #### Add new `Httpservice` class
+
+  - For use by plugins.
+
+### Improved
+
+- Improvement: Print more helpful error message when `syncup` fails.
+
+### Fixed
+
+- Bugfix: Fix displaying HTTP error when JSON returned.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.6 (2017-10-06)
+
+### Fixed
+
+- Bugfix: Fix `tsdb query` command to work when `--sampling_size` not specified. (Issue: [MUR-4301](https://i.exosite.com/jira/browse/MUR-4301))
+
+- Bugfix: Fix `device enable` command. (Issue: [MUR-4537](https://i.exosite.com/jira/browse/MUR-4537))
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.5 (2017-09-28)
+
+### New
+
+- #### Two-factor authentication support
+
+  - When logging on, you'll be prompted to check your email for a token.
+
+  - You can clear the token at any time using `murano logout --token`.
+
+### Fixed
+
+- Bugfix: `murano exchange` command was failing after recent changes to element description.
+
+- Fix `murano syncup`/`syncdown` when only one Solution configured
+
+  - E.g., if only `product.id` was set, but not `application.id`.
+
+- Fix `murano cors` command
+
+  - Fix `--csv` output option.
+
+  - Default now is to show table, like `murano usage` and other commands.
+
+  - Update help examples to show how to use `--json`, `--yaml`, etc.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.4 (2017-09-13)
+
+### Fixed
+
+- #### Microsoft Windows support
+
+  - Fix issues installing and using Murano CLI on Windows.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.3 (2017-09-13)
+
+### Fixed
+
+- #### Microsoft Windows support
+
+  - Fix issues installing and using Murano CLI on Windows.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.2 (2017-09-11)
+
+### New
+
+- #### Murano IoT Exchange Elements commands (Issues: [MUR-3921](https://i.exosite.com/jira/browse/MUR-3921), [MUR-3922](https://i.exosite.com/jira/browse/MUR-3922), [MUR-3923](https://i.exosite.com/jira/browse/MUR-3923))
+
+  - Add Support for Murano IoT Exchange Elements.
+
+    - See the new commands' `help` for more:
+
+      `murano exchange list --help`
+
+      `murano exchange purchase --help`
+
+    - E.g.,
+
+      - `murano exchange list --full -c outformat=json`
+
+      - `murano exchange add IoT`
+
+### Improved
+
+- Fix problem working with older solutions that were migrated to Murano 1.1.
+
+- Improve error reporting and recovery when handling network errors.
+
+- Fix compatibility with latest release of third-party gem, `public_suffix`.
+
+### Developer improvements
+
+- Enable `rb-commander` code coverage
+
+  - Enable all files under `lib/MrMurano/commands/` to be part of RSpec coverage.
+
+    - See the monkey patches atop `cmd_common.rb`, and the hack-of-a-function,
+      `murano_command_runner`.
+
+    - We can now add functional tests without needing to call
+      `Open3.capture3` and using a subshell, but rather by calling
+      Commander directly.
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.1 (2017-08-23)
+
+### New
+
+- #### Product ID Event Handler Aliasing
+
+  - Alias filename parts and magic script header using config variables, e.g., use `{product.id}` instead of actual Product ID.
+
+    Support config variable aliases in filenames and event handler scripts.
+
+    - For instance, instead of specifying the Product ID in the filename, such as
+
+        `services/abcd1234_event.lua`
+
+      you can name it with a config variable,
+
+        `services/{product.id}_event.lua`
+
+    - And instead of hard coding the ID in the magic header, e.g.,
+
+       `--#EVENT a1b2c3d4e5f6 event`
+
+      you can use the same config variable substitution, e.g.,
+
+       `--#EVENT {product.id} event`
+
+- #### New `device` Commands and Options
+
+  - New `--expire` option for the `device enable` command specifies the number of hours until the authentication window closes (and the device in Murano must be re-enabled before the physical device can authenticate).
+
+  - New device commands: `device lock`, `device unlock`, and `device revoke`.
+
+- #### New global option, `--ascii`
+
+  - Disable Unicode output with `--ascii` (the progress bar defaults to using Unicode, as do some messages).
+
+- New command line option `--no-page` and corresponding config variable `tool.no-page` disable paging the help.
+
+### Improved
+
+- #### Disable Progress if Command Being Piped
+
+  If the `murano` command is being piped (or run in a subshell), disable the progress display, which adds hidden characters to any captured output.
+
+  - E.g., for commands like `URL=$(murano domain application --brief)` and `murano usage | grep email | awk '{print $4}'`
+
+### Fixed
+
+- Bugfix: `murano domain product` incorrectly showing application, too.
+
+- Bugfix: `murano business find` failing on fuzzy search.
+
+- Bugfix: `murano device enable` command was using old API.
+
+- Fix `--help` issues.
+
+  - Fix `--help` to work when other --options are present.
+
+  - Fix `--help` on base commands to show list of subcommands (was showing just the description).
+
+  - Fix `--help` to work on command aliases (was erroneously telling you to run `--help`).
+
+---------------------------------------------------------------------------
+
+## Murano CLI v3.0.0 (2017-08-18)
+
+### New
+
+- #### Murano Advanced Device Connectivity (ADC) support
+
+  Add support for Murano `device2` interface.
+
+  http://docs.exosite.com/articles/adc-overview/
+
+  - If you would like to work with an older solution that has not been migrated to ADC, please use Murano CLI v2.2.4.
+
+- #### Multi-solution support
+
+  Add support for one Device and one Application.
+
+  In Murano CLI v2, there was one `solution.id` used to identify the active solution.
+
+  Now there is an `application.id` and a `product.id` used to identify two solutions, which are usually "linked".
+
+- #### Better onboarding
+
+  Use `murano init` to easily and quickly set up a new project, or to connect to an existing project.
+
+- #### Nested Lua script support
+
+  Add support for organizing Lua modules hierarchically.
+
+  E.g., a file located at `modules/foo/bar/baz.lua` can be included with `require 'foo.bar.baz'`.
+
+  - If you would like to disable this behavior, please use `--no-nesting`
+
+- #### Progress display
+
+  - Added flashy progress indicator.
+
+    - Use `--no-progress` to disable.
+
+  - Colorize terminal output text.
+
+    - Use `--no-color` to disable.
+