CHANGELOG.md in eco-helpers-2.5.2 vs CHANGELOG.md in eco-helpers-2.5.3

@@ -1,8 +1,53 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
-## [2.5.2] - 2023-06-xx
+## [2.5.3] - 2023-07-xx
+
+### Added
+  - _GraphQL base case_ for **locations structure update**.
+    - Refer to `Eco::API::UseCases::GraphQL::Samples::LocationCommands`
+    - See also `Eco::API::UseCases::GraphQL`. **Added** `Helpers` and `Samples`
+  - `Eco::Data::Locations` helpers
+    - **Converters**: it offers a `DSL` (see `Eco::Data::Locations::DSL`) manage as input/output:
+      1. CSV files with locations in two basic formats (list of nodes and hierarchy of locations)
+      2. This comes with integrity checkers to ensure the input data files are correct (warnings)
+      3. It also allows to convert to/from an organization locations structure and csv files.
+    - Making generic the helpers of `Eco::API::UseCases::DefaultCases::CsvToTree`
+    - The prospect is to move to the new/reviewed helpers at some stage (so remove the old helpers)
+    - This comes with a series of **converters** and **parsers** to allow two basic forms of input/output:
+      - CSV with list of nodes (`id`, `name`, `parent_id`)
+      - CSV of the actual tree (each column is one level of the tree)
+  - `Eco::API::Organization::TagTree` - **added/improved methods**
+    - **added** shortcuts: `parent_id`, `parent_name`
+    - **added** filters: `select`, `reject`
+    - **improved** `as_json`:
+      1. new parameter `include_children`
+      2. Hash keys | Header names to `HEADER` column
+    - **added** `as_nodes_json` to obtain a plain list (rather than hierarchical `as_json`)
+  - `Eco::CSV::Table`
+    - **added** `#add_index_column` to numerate the rows in a new column
+    - **improved** `#add_column` with new parameter `pos`
+    - **added** `#nil_blank_cells` and `#nil_blank_cells!`
+  - `Eco::Language::BasicLogger` brief extensible logger.
+
+### Changed
+  - Refactored `Eco::API::Session::Logger` inheriting from `Eco::Language::BasicLogger`
+
+### Fixed
+  - Live tree retrieval. Allow to specify locations structure `id`, `kargs` & `block`.
+    - `Eco::API::Session#live_tree` allow `id`, `kargs` & `block`, **fix** pass `include_archived`
+    - `Eco::API::Session::Config#live_tree` allow `id`, `kargs` & `block`
+      - When `id` is given, it uses `tagtree_config#live_tree_get`
+      - **fixed** neither `kargs` nor `include_archived` where defined
+    - `Eco::API::Session::Config::Tagtree` methods
+      - `#live_trees` allow `kargs`
+      - `#live_tree_get` **added**: it does not memoize
+      - `#live_tree` allow `id` and `kargs`
+        - **fixed** `include_archived` nodes should not be redirected to `live_trees` as in the latter this parameter has a different meaning (it refers to archived structures).
+    - **Important note**: the `ecoportal-api-graphql` gem, at the moment always retrieves archived nodes. This makes the `include_archived` argument non-functional. However, at some stage this will be changed and everything should be sorted out by then.
+
+## [2.5.2] - 2023-06-23
 
 ### Added
   - `Eco::API::Session::Config::Workflow#exit_handle`
     - Allows to define a callback on `SystemExit` (`exit` call).