eco-helpers 3.2.13 → 3.2.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 164a0d7e0bea8396208dae904e45bac439f288773a138e01869fe19ec9eafe21
-  data.tar.gz: b56add1010ab7feee79f58c8bac0835bc39f9bfceb8a56fcf1cb6aff176bdd1d
+  metadata.gz: d67a16095de2e32c2c627214b0254df6d2685e0591ab6295082736e52494c4d3
+  data.tar.gz: 60835a688189d8feda9bdc6198bbdb0cfaa9e9f95e5c7521f36cedbec706c1b0
 SHA512:
-  metadata.gz: 9a584c9593325bbd6fa7ec08794de3d839bd675c719613899c25e7d3d53bbfb58b03bc33f703b0b38a906a0ce08c30ec31c11d180653e9181f25b510db3bc3dd
-  data.tar.gz: ddfd53f1a2e72cbbf4136ee4ebb25481e098512ac258ff21bfea188417a6824e22aab407f16cb3a3d966b21d320b6aa56659e71f0782accda71f921d5db24601
+  metadata.gz: 0c1ded6a88ad0c6394e96cb511fddb5c5ac29635307affc1577d5eeb210f01ad8dd78edf78e449b9bca765a8754aa31083abb72beb60746ed21741e523878e6c
+  data.tar.gz: a18f9c81c2430ba8251bdfc34e6e4e1d3da0fd3cbe4647226942469d8da1f71e00aa7e21e3162d9d89d492f98e800642c0132edc30a305515df67764c397de91

data/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-## [3.2.14] - 2026-04-xx
+## [3.2.15] - 2026-05-xx
 
 ### Added
 
@@ -10,6 +10,17 @@ All notable changes to this project will be documented in this file.
 
 ### Fixed
 
+## [3.2.14] - 2026-05-22
+
+### Added
+
+- `track-files` case
+- `add-page-id` case
+
+### Changed
+
+- **improvement**: added `-format` argument to `-group-csv` to output a `jsonl` **custom** file.
+
 ## [3.2.13] - 2026-04-15
 
 ### Added

data/lib/eco/api/usecases/default/utils/add_page_id_case.rb

@@ -0,0 +1,273 @@
+# @note you might add a `filter` method
+#
+#      def filter
+#        @filter ||= proc do |row, _r_idx|
+#          next true
+#          next true unless (ref_id = row[pivot_column(row)])
+#          next false if excluded_ref_id?(ref_id)
+#
+#          true
+#        end
+#      end
+#
+class Eco::API::UseCases::Default::Utils::AddPageId < Eco::API::Custom::UseCase
+  name 'add-page-id'
+  type :other
+
+  require_relative 'cli/add_page_id_cli'
+
+  PIVOT_FIELD = [
+    'ref_id'
+  ].freeze
+
+  PAGE_ID          = 'page_id'.freeze
+  EXCLUDED_REF_IDS = %w[].freeze
+
+  def main(*_args)
+    if simulate?
+      count = Eco::CSV.count(input_file)
+      log(:info) { "CSV '#{input_file}' has #{count} rows." }
+    else
+      generate_file(&filter)
+    end
+  end
+
+  private
+
+  attr_reader :headers, :headers_rest
+
+  def filter
+    nil
+  end
+
+  def excluded_ref_id?(ref_id)
+    self.class::EXCLUDED_REF_IDS.include?(ref_id)
+  end
+
+  def generate_file # rubocop:disable Metrics/AbcSize
+    idx           = -1
+    row_count     = 0
+    headers_added = false
+
+    CSV.open(output_filename, 'wb') do |csv|
+      puts "\n"
+
+      Eco::CSV.foreach(input_file, headers: true, skip_blanks: true) do |row|
+        idx += 1
+
+        next unless !block_given? || yield(row, idx)
+
+        unless headers_added
+          headers!(row)
+          require_pivot_field!(row, file: input_file)
+
+          csv           << headers
+          headers_added = true
+        end
+
+        unless (pivot_value = row[pivot_field])
+          msg  = "Row #{idx} doesn't have value for pivot field '#{pivot_field}'"
+          msg << ". Skipping (discarded) ..."
+          log(:warn) { msg }
+          next
+        end
+
+        unless (page_id = input_maps[pivot_value])
+          warn_unknown_mapping_reference!(pivot_value)
+          next
+        end
+
+        row_count += 1
+
+        if (row_count % 500).zero?
+          print "... Mapped #{row_count} rows          \r"
+          $stdout.flush
+        end
+
+        values     = [page_id, pivot_value]
+        oth_values = row.values_at(*headers_rest)
+        values.concat(oth_values) unless headers_rest.empty?
+
+        csv << values
+      end
+    end
+  ensure
+    msg = "Generated file '#{output_filename}' with #{row_count} rows (out of #{idx})."
+    log(:info) { msg } unless simulate?
+  end
+
+  def warn_unknown_mapping_reference!(ref_id)
+    return if unknown.include?(ref_id)
+
+    unknown << ref_id
+    msg  = "Could not map '#{pivot_field}' '#{ref_id}' to a '#{page_id_field}'"
+    msg << ". Skipping (discarded) ..."
+
+    log(:warn) { msg }
+  end
+
+  def unknown
+    @unknown ||= []
+  end
+
+  def headers!(row)
+    return if instance_variable_defined?(:@headers)
+
+    @headers_rest = row.headers - base_out_header(row)
+    @headers      = [*base_out_header, *headers_rest]
+  end
+
+  def base_out_header(row = nil)
+    @base_out_header ||= [page_id_field, pivot_field(row)] # space: :output
+  end
+
+  def input_maps
+    return @input_maps if instance_variable_defined?(:@input_maps)
+
+    @input_maps = {}
+    idx = 0
+
+    Eco::CSV.foreach(input_maps_file, headers: true) do |row|
+      idx += 1
+
+      if (idx % 500).zero?
+        print "... Creating mappings table (#{idx} done)          \r"
+        $stdout.flush
+      end
+
+      require_pivot_field!(row, space: :maps, file: input_maps_file)
+      require_page_id_field!(row, file: input_maps_file)
+
+      ref_id  = row[pivot_field(space: :maps)]
+      page_id = row[page_id_field(space: :maps)]
+
+      @input_maps[ref_id] = page_id
+    end
+
+    @input_maps
+  end
+
+  def input_maps_file
+    options.dig(:input, :maps).tap do |file|
+      next if file && File.exist?(file)
+
+      log(:error) {
+        msg = "You must specify an existing maps file with the option '-maps-file'"
+        msg << ".\n  * File: '#{file}' does not exist" unless file.nil?
+        msg
+      }
+      exit 1
+    end
+  end
+
+  def output_filename
+    return nil unless input_name
+
+    File.join(
+      input_dir,
+      "#{input_name}_mapped#{input_ext}"
+    )
+  end
+
+  def input_name
+    @input_name ||= File.basename(
+      input_basename,
+      input_ext
+    )
+  end
+
+  def input_ext
+    @input_ext ||= input_basename.split('.')[1..].join('.').then do |name|
+      ".#{name}"
+    end
+  end
+
+  def input_basename
+    @input_basename ||= File.basename(input_full_filename)
+  end
+
+  def input_dir
+    @input_dir = File.dirname(input_full_filename)
+  end
+
+  def input_full_filename
+    @input_full_filename ||= File.expand_path(input_file)
+  end
+
+  def input_file
+    options.dig(:input, :file)
+  end
+
+  def require_pivot_field!(row, file:, space: :input)
+    return true if row.key?(pivot_field(row, space: space))
+
+    msg = "Pivot field '#{pivot_field}' missing in header of file '#{file}'"
+    log(:error) { msg }
+    raise msg
+  end
+
+  def require_page_id_field!(row, file:)
+    return true if row.key?(page_id_field(space: :maps))
+
+    msg = "Page ID field '#{page_id_field(space: :maps)}' missing in header of file '#{file}'"
+    log(:error) { msg }
+    raise msg
+  end
+
+  def pivot_field(row = nil, space: :input)
+    @pivot_field ||= {}
+    return @pivot_field[space] if @pivot_field.key?(space)
+
+    @pivot_field[space] ||= pivot_fields(space: space).select do |name|
+      row.key?(name)
+    end.then do |sel|
+      next sel.first if sel.one?
+
+      msg = "Could not find any column named: #{pivot_fields.join(', ')}"
+      msg = "Multiple pivot columns: #{sel.join(', ')}" if sel.any?
+
+      log(:error) { msg }
+      raise msg
+    end.tap do |col|
+      log(:info) { "Using header '#{col}' as pivot column." }
+    end
+  end
+
+  def pivot_fields(space: :input)
+    @pivot_fields ||= {}
+    return @pivot_fields[space] if @pivot_fields.key?(space)
+
+    return (@pivot_fields[space] = [opts_pivot]) if opts_pivot && space == :input
+
+    unless self.class.const_defined?(:PIVOT_FIELD)
+      msg = "(#{self.class}) You must define PIVOT_FIELD constant"
+      log(:error) { msg }
+      raise msg
+    end
+
+    @pivot_fields[space] = self.class::PIVOT_FIELD.dup
+  end
+
+  def page_id_field(space: :output)
+    @page_id_field = {}
+    return @page_id_field[space] if @page_id_field.key?(space)
+
+    return (@page_id_field[space] = opts_page_id) if opts_page_id && space == :output
+
+    unless self.class.const_defined?(:PAGE_ID)
+      msg = "(#{self.class}) You must define PAGE_ID field constant"
+      log(:error) { msg }
+      raise msg
+    end
+
+    @page_id_field[space] = self.class::PAGE_ID
+  end
+
+  def opts_pivot
+    options.dig(:input, :pivot_field)
+  end
+
+  def opts_page_id
+    options.dig(:input, :page_id)
+  end
+end

data/lib/eco/api/usecases/default/utils/cli/add_page_id_cli.rb

@@ -0,0 +1,29 @@
+class Eco::API::UseCases::Default::Utils::AddPageId
+  class Cli < Eco::API::UseCases::Cli
+    desc 'Adds the page_id column based on mappings onto -pivot'
+
+    callback do |_session, options, _usecase|
+      if (file = SCR.get_file(cli_name, required: true, should_exist: true))
+        options.deep_merge!(input: {file: file})
+      end
+    end
+
+    add_option('-maps-file', 'Source file with he mappings') do |options|
+      if (file = SCR.get_file('-maps-file', required: true, should_exist: true))
+        options.deep_merge!(input: {maps: file})
+      end
+    end
+
+    add_option('-pivot', 'The column that should be used to pivot') do |options|
+      if (file = SCR.get_arg("-pivot", with_param: true))
+        options.deep_merge!(input: {pivot_field: file})
+      end
+    end
+
+    add_option('-page-id', 'The column that should be used to dump the id') do |options|
+      if (file = SCR.get_arg("-page-id", with_param: true))
+        options.deep_merge!(input: {page_id: file})
+      end
+    end
+  end
+end

data/lib/eco/api/usecases/default/utils/cli/group_csv_cli.rb

@@ -22,5 +22,10 @@ class Eco::API::UseCases::Default::Utils::GroupCsv
         options.deep_merge!(input: {group_by_field: file})
       end
     end
+
+    add_option('-format', 'Kind of extract (csv - default | jsonl') do |options|
+      format = SCR.get_arg('-format', with_param: true)
+      options.deep_merge!(output: {format: format})
+    end
   end
 end

data/lib/eco/api/usecases/default/utils/cli/track_files_cli.rb

@@ -0,0 +1,16 @@
+class Eco::API::UseCases::Default::Utils::TrackFiles
+  class Cli < Eco::API::UseCases::Cli
+    desc 'Tracks the files of a folder in a CSV'
+
+    callback do |_session, options, _usecase|
+      if (folder = SCR.get_file(cli_name, required: true))
+        options.deep_merge!(input: {folder: folder})
+      end
+    end
+
+    add_option("-s3-path", "Relative subpath from the S3 uploads folder.") do |options|
+      path = SCR.get_arg("-s3-path", with_param: true)
+      options.deep_merge!(output: {s3_path: path})
+    end
+  end
+end

data/lib/eco/api/usecases/default/utils/group_csv_case/file_handler.rb

@@ -0,0 +1,62 @@
+class Eco::API::UseCases::Default::Utils::GroupCsv
+  class FileHandler
+    attr_reader :filename, :format
+
+    def initialize(filename, format: :csv)
+      @filename = filename
+      @format   = format
+
+      open
+    end
+
+    def <<(value)
+      msg = "File has been closed. Can't write to it: #{filename}"
+      raise msg unless file
+
+      case format
+      when :csv
+        file << value
+      when :jsonl
+        file.puts to_s(value)
+      end
+    end
+
+    def close
+      return if file.nil?
+
+      file.close.tap do
+        @file = nil
+      end
+    end
+
+    private
+
+    attr_reader :file
+
+    def to_s(value)
+      case value
+      when String
+        value.split("\n").first.tap do |line|
+          next if line == value
+
+          raise ArgumentError, "As string, value should be a single line. Given: #{value}"
+        end
+      when Hash
+        value.to_json
+      else
+        raise ArgumentError, "Unsupported type: #{value.class}"
+      end
+    end
+
+    def open
+      case format
+      when :csv
+        @file = CSV.open(filename, 'wb')
+      when :jsonl
+        @file = File.open(filename, 'wb')
+      else
+        raise "Unknown output format: #{format}"
+      end
+    end
+  end
+end

data/lib/eco/api/usecases/default/utils/group_csv_case.rb

@@ -1,35 +1,59 @@
 # This script assumes that for the `GROUP_BY_FIELD` rows are consecutive.
 # @note you might run first the `sort-csv` case.
+# @note when using `jsonl` as an output `format`, it doesn't merge fields,
+#   but it groups them based on some criteria.
+#   - In this case you need to define a `json_builder` method that returns a hash.
 # @note you must inherit from this case and define the constants.
 #
-#      GROUP_BY_FIELD = 'target_csv_field'.freeze
+#      GROUP_BY_FIELD = 'target_csv_field'.freeze # if `-by` command option isn't used
 #      GROUPED_FIELDS = [
 #        'joined_field_1',
 #        'joined_field_2',
 #        'joined_field_3',
 #      ].freeze
-#
+# @note that `GROUPED_FIELDS` isn't necessary if `jsonl` is used as an output `format`
 class Eco::API::UseCases::Default::Utils::GroupCsv < Eco::API::Custom::UseCase
   name 'group-csv'
   type :other
 
   require_relative 'cli/group_csv_cli'
+  require_relative 'group_csv_case/file_handler'
+
+  OUTPUT_FORMAT = :csv # :csv or :jsonl
 
   def main(*_args)
     if simulate?
       count = Eco::CSV.count(input_file)
       log(:info) { "CSV '#{input_file}' has #{count} rows." }
     else
+      msg = "You should define a json_builder method when using jsonl as output format"
+      raise msg unless respond_to?(:json_builder, true) || output_format != :jsonl
+
       generate_file
     end
   end
 
   private
 
+  attr_reader :in_index
+
+  def with_output_file
+    handler = FileHandler.new(output_filename, format: output_format)
+
+    yield handler
+  ensure
+    handler&.close
+
+    msg  = "Generated file '#{output_filename}' "
+    msg << "with #{row_count} rows (out of #{in_index + 1})."
+
+    log(:info) { msg } unless simulate?
+  end
+
   def generate_file # rubocop:disable Metrics/AbcSize
-    in_index = nil
+    @in_index = nil
 
-    CSV.open(output_filename, 'wb') do |out_csv|
+    with_output_file do |f_handler|
       first = true
 
       puts "\n"
@@ -38,11 +62,11 @@ class Eco::API::UseCases::Default::Utils::GroupCsv < Eco::API::Custom::UseCase
         if first
           first = false
           headers!(row)
-          out_csv << headers
+          f_handler << headers if output_format == :csv
           require_group_by_field!(row, file: input_file)
         end
 
-        in_index = idx
+        @in_index = idx
         next unless !block_given? || yield(row, idx)
 
         next unless pivotable?(row, idx)
@@ -50,19 +74,25 @@ class Eco::API::UseCases::Default::Utils::GroupCsv < Eco::API::Custom::UseCase
 
         row_count!
 
-        out_csv << last_group.values_at(*headers)
+        case output_format
+        when :csv
+          f_handler << last_group.values_at(*headers)
+        when :jsonl
+          f_handler << json_builder(last_group)
+        end
       end
 
       # finalize
       if (l_row = pivot_row)
         row_count!
-        out_csv   << l_row.values_at(*headers)
-      end
-    ensure
-      msg  = "Generated file '#{output_filename}' "
-      msg << "with #{row_count} rows (out of #{in_index + 1})."
 
-      log(:info) { msg } unless simulate?
+        case output_format
+        when :csv
+          f_handler << l_row.values_at(*headers)
+        when :jsonl
+          f_handler << json_builder(l_row)
+        end
+      end
     end
   end
 
@@ -76,16 +106,23 @@ class Eco::API::UseCases::Default::Utils::GroupCsv < Eco::API::Custom::UseCase
     pivot_value = row[group_by_field]
 
     unless (last_pivot = @group[group_by_field])
+      # init
       last_pivot = @group[group_by_field] = pivot_value
     end
 
     last   = @group
     @group = {group_by_field => pivot_value} unless pivot_value == last_pivot
 
-    headers_rest.each do |field|
-      curr_values   = row[field].to_s.split('|').compact.uniq
-      pivot_values  = @group[field].to_s.split('|').compact.uniq
-      @group[field] = (pivot_values | curr_values).join('|')
+    case output_format
+    when :csv
+      headers_rest.each do |field|
+        curr_values   = row[field].to_s.split('|').compact.uniq
+        group_values  = @group[field].to_s.split('|').compact.uniq
+        @group[field] = (group_values | curr_values).join('|')
+      end
+    when :jsonl
+      @group['rows'] ||= []
+      @group['rows'] << row.to_h.slice(*headers_rest)
     end
 
     last unless last == @group
@@ -97,9 +134,10 @@ class Eco::API::UseCases::Default::Utils::GroupCsv < Eco::API::Custom::UseCase
   def headers!(row)
     return if headers?
 
-    @headers_rest  = grouped_fields & row.headers
-    @headers_rest -= [group_by_field]
-    @headers       = [group_by_field, *headers_rest]
+    @grouped_fields = row.headers - [group_by_field] if output_format == :jsonl
+    @headers_rest   = grouped_fields & row.headers
+    @headers_rest  -= [group_by_field]
+    @headers        = [group_by_field, *headers_rest]
   end
 
   def headers?
@@ -108,7 +146,7 @@ class Eco::API::UseCases::Default::Utils::GroupCsv < Eco::API::Custom::UseCase
 
   def row_count!
     @row_count ||= 0
-    (@row_count  += 1).tap do |cnt|
+    (@row_count += 1).tap do |cnt|
       if (cnt % 500).zero?
         print "... Done #{cnt} rows            \r"
         $stdout.flush
@@ -141,10 +179,14 @@ class Eco::API::UseCases::Default::Utils::GroupCsv < Eco::API::Custom::UseCase
     num
   end
 
+  def output_format
+    options.dig(:output, :format)&.to_sym || self.class::OUTPUT_FORMAT
+  end
+
   def output_filename
     return unless input_name
 
-    File.join(input_dir, "#{input_name}_grouped#{input_ext}")
+    File.join(input_dir, "#{input_name}_grouped.#{output_format}")
   end
 
   def input_name

data/lib/eco/api/usecases/default/utils/track_files_case.rb

@@ -0,0 +1,179 @@
+# Tracks the files of a source folder into a file
+class Eco::API::UseCases::Default::Utils::TrackFiles < Eco::API::Custom::UseCase
+  name 'track-files'
+  type :other
+
+  require_relative 'cli/track_files_cli'
+
+  OUT_HEADERS = %w[
+    ref_id
+    filename
+    filesize
+    s3_path
+  ].freeze
+
+  REF_ID_PATH_POSITION = :last
+  BASE_S3_PATH         = 'uploads'.freeze
+  # S3_SUBPATH   = 'org-name'.freeze
+
+  def main(*_args)
+    if simulate?
+      count_files
+    else
+      generate_file
+    end
+  end
+
+  private
+
+  attr_reader :folder_count, :file_count
+
+  def folder_count!(cnt = 1)
+    @folder_count ||= 0
+
+    print '.'
+    @folder_count += cnt
+  end
+
+  def file_count!(cnt = 1)
+    @file_count ||= 0
+    @file_count  += cnt
+  end
+
+  def count_files
+    with_each_file
+
+    log(:info) {
+      "Found #{file_count} files, in #{folder_count} folders (with files)."
+    }
+  end
+
+  def ref_id_path_position
+    self.class::REF_ID_PATH_POSITION
+  end
+
+  def generate_file
+    CSV.open(output_filename, 'wb') do |csv|
+      csv << self.class::OUT_HEADERS
+
+      with_each_file do |file, src_path|
+        ref_id =
+          case ref_id_path_position
+          when :first then src_path.first
+          when :last  then src_path.last
+          else
+            raise ArgumentError, "Unknown REF_ID_PATH_POSITION: #{ref_id_path_position}  "
+          end
+
+        file_row  = [ref_id]
+        file_row << file_name = File.basename(file)
+        file_row << File.size(file)
+        file_row << s3_path(file_name, src_path)
+
+        csv      << file_row
+      end
+    end
+  ensure
+    msg  = "Generated file '#{output_filename}' "
+    msg << "with #{file_count} files/rows "
+    msg << "organized in #{folder_count} folders."
+
+    log(:info) { msg } unless simulate?
+  end
+
+  def with_each_file(folders = top_subfolders, src_path: [], &block)
+    folders.each do |folder|
+      folder_name = File.basename(folder)
+      path        = src_path[0..-1]
+      path       << folder_name
+
+      files       = folder_files(folder)
+      subfolders  = top_subfolders(folder)
+
+      next if files.empty? && subfolders.empty? # skip
+
+      if files.any? && subfolders.any?
+        msg  = "Folder '#{folder}' contains both files and subfolders."
+        msg << "\nFor correctly tracking and handling file attachments, "
+        msg << "this is not supported."
+
+        raise ArgumentError, msg
+      end
+
+      unless files.empty?
+        folder_count!
+        file_count!(files.count)
+
+        files.each do |file|
+          yield(file, path) if block_given?
+        end
+      end
+
+      next if subfolders.empty?
+
+      with_each_file(
+        subfolders,
+        src_path: path,
+        &block
+      )
+    end
+  end
+
+  def s3_path(filename, path)
+    [
+      self.class::BASE_S3_PATH,
+      s3_subpath,
+      *path,
+      filename
+    ].compact.join('/')
+  end
+
+  def s3_subpath
+    options.dig(:output, :s3_path) ||
+      s3_subpath_const             ||
+      config.active_enviro
+  end
+
+  def s3_subpath_const
+    self.class::S3_SUBPATH if self.class.const_defined?(:S3_SUBPATH)
+  end
+
+  def top_subfolders(base_folder = input_base_folder)
+    Dir[
+      File.join(base_folder, "*")
+    ].select do |f|
+      File.directory?(f)
+    end
+  end
+
+  def folder_files(dir)
+    Dir[
+      File.join(dir, "*")
+    ].select do |f|
+      File.file?(f)
+    end
+  end
+
+  def output_filename
+    return unless input_folder_name
+
+    File.join(
+      config.active_enviro,
+      'sftp',
+      "#{input_folder_name}_files.csv"
+    )
+  end
+
+  def input_folder_name
+    @input_folder_name ||= File.basename(input_base_folder)
+  end
+
+  def input_base_folder
+    options.dig(:input, :folder).tap do |folder|
+      next if File.directory?(folder)
+
+      msg = "Expecting '#{folder}' to be a directory, but it isn't."
+      raise ArgumentError, msg
+    end
+  end
+end

data/lib/eco/api/usecases/default/utils.rb

@@ -16,3 +16,5 @@ require_relative 'utils/sort_csv_case'
 require_relative 'utils/group_csv_case'
 require_relative 'utils/merge_csv_case'
 require_relative 'utils/entries_to_csv_case'
+require_relative 'utils/track_files_case'
+require_relative 'utils/add_page_id_case'

data/lib/eco/version.rb

@@ -1,3 +1,3 @@
 module Eco
-  VERSION = '3.2.13'.freeze
+  VERSION = '3.2.14'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eco-helpers
 version: !ruby/object:Gem::Version
-  version: 3.2.13
+  version: 3.2.14
 platform: ruby
 authors:
 - Oscar Segura
@@ -794,6 +794,8 @@ files:
 - lib/eco/api/usecases/default/people/utils/switch_supervisor_case.rb
 - lib/eco/api/usecases/default/people/utils/transfer_account_case.rb
 - lib/eco/api/usecases/default/utils.rb
+- lib/eco/api/usecases/default/utils/add_page_id_case.rb
+- lib/eco/api/usecases/default/utils/cli/add_page_id_cli.rb
 - lib/eco/api/usecases/default/utils/cli/entries_to_csv_cli.rb
 - lib/eco/api/usecases/default/utils/cli/group_csv_cli.rb
 - lib/eco/api/usecases/default/utils/cli/json_to_csv_cli.rb
@@ -801,13 +803,16 @@ files:
 - lib/eco/api/usecases/default/utils/cli/sort_csv_cli.rb
 - lib/eco/api/usecases/default/utils/cli/split_csv_cli.rb
 - lib/eco/api/usecases/default/utils/cli/split_json_cli.rb
+- lib/eco/api/usecases/default/utils/cli/track_files_cli.rb
 - lib/eco/api/usecases/default/utils/entries_to_csv_case.rb
 - lib/eco/api/usecases/default/utils/group_csv_case.rb
+- lib/eco/api/usecases/default/utils/group_csv_case/file_handler.rb
 - lib/eco/api/usecases/default/utils/json_to_csv_case.rb
 - lib/eco/api/usecases/default/utils/merge_csv_case.rb
 - lib/eco/api/usecases/default/utils/sort_csv_case.rb
 - lib/eco/api/usecases/default/utils/split_csv_case.rb
 - lib/eco/api/usecases/default/utils/split_json_case.rb
+- lib/eco/api/usecases/default/utils/track_files_case.rb
 - lib/eco/api/usecases/default_cases.rb
 - lib/eco/api/usecases/default_cases/create_case.rb
 - lib/eco/api/usecases/default_cases/delete_sync_case.rb