eco-helpers 3.2.16 → 3.2.22

data/.claude/settings.json

@@ -1,103 +0,0 @@
-{
-  "permissions": {
-    "defaultMode": "auto",
-    "allowedTools": [
-      "Read"
-    ],
-    "permissionRules": [
-      {
-        "tool": "Write",
-        "pattern": "/**",
-        "action": "allow"
-      },
-      {
-        "tool": "StrReplace",
-        "pattern": "/**",
-        "action": "allow"
-      }
-    ],
-    "allow": [
-      "WebFetch(domain:anthropic.com)",
-      "WebFetch(domain:npmjs.com)",
-      "Write(.glaudeignore)",
-      "Update(.glaudeignore)",
-      "Bash(rm .ai-assistance/bridge/LOCK)",
-      "Read(.git/**)",
-      "Read(**/rubygems/**)",
-      "Write(*.md)",
-      "Edit(.ai-assistance/**)",
-      "Update(.ai-assistance/**)",
-      "Write(.ai-assistance/**)",
-      "Write(lib/**)",
-      "Write(spec/**)",
-      "Bash(git status)",
-      "Bash(git diff *)",
-      "Bash(git log *)",
-      "Bash(git add *)",
-      "Bash(git commit *)",
-      "PowerShell(git status)",
-      "PowerShell(git diff *)",
-      "PowerShell(git log *)",
-      "PowerShell(git add *)",
-      "PowerShell(git commit *)",
-      "Bash(npm test)",
-      "Bash(npm run lint)",
-      "Bash(npm run build)",
-      "Bash(vitest *)",
-      "Bash(jest *)",
-      "PowerShell(npm test)",
-      "PowerShell(npm run lint)",
-      "PowerShell(npm run build)",
-      "Bash(black .)",
-      "Bash(pytest)",
-      "Bash(python -m unittest)",
-      "Bash(ruff check *)",
-      "Bash(bundle exec rspec *)",
-      "Bash(bundle exec rubocop *)",
-      "PowerShell(pytest)",
-      "PowerShell(python -m unittest)",
-      "PowerShell(ruff check *)",
-      "PowerShell(bundle exec rspec *)",
-      "PowerShell(bundle exec rubocop *)",
-      "Bash(node .ai-assistance/scripts/token-logger.js)",
-      "Bash(node .ai-assistance/scripts/token-session-start.js)"
-    ],
-    "deny": [
-      "Read(*.env)",
-      "Read(./.env*)",
-      "Read(./secrets/**)",
-      "Bash(*cat *.env*)",
-      "Bash(*grep *.env*)",
-      "Bash(printenv*)",
-      "Bash(env)",
-      "Write(.git/*)",
-      "Edit(.git/*)",
-      "Bash(git push *)",
-      "Bash(rm -rf *)"
-    ]
-  },
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .ai-assistance/scripts/token-session-start.js 2>/dev/null || true"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .ai-assistance/scripts/token-logger.js 2>/dev/null || true"
-          }
-        ]
-      }
-    ]
-  }
-}

data/.gitignore

@@ -1,25 +0,0 @@
-# it's a gem, ignore the lockfile
-Gemfile.lock
-
-# build artifacts
-*.gem
-/.bundle
-/.vscode
-.solargraph.yml
-/vendor/bundle
-/spec/reports/
-/tmp/
-/pkg/
-
-# docs
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-
-# rspec failure tracking
-.rspec_status
-scratch.rb
-.byebug_history
-
-.ai-assistance/local/

data/.idea/.gitignore

@@ -1,10 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml
-# Editor-based HTTP Client requests
-/httpRequests/
-# Datasource local storage ignored files
-/dataSources/
-/dataSources.local.xml
-# jetbrains IDE
-.idea

data/.markdownlint.json

@@ -1,4 +0,0 @@
-{
-  "MD013": false,
-  "MD024": false
-}

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper

data/.rubocop.yml

@@ -1,103 +0,0 @@
-AllCops:
-  TargetRubyVersion: 3.2
-  Exclude:
-    - 'config/routes.rb'
-  NewCops: enable
-
-Metrics/ClassLength:
-  Max: 500
-Metrics/ModuleLength:
-  Max: 300
-Metrics/MethodLength:
-  Max: 50
-Metrics/AbcSize:
-  Max: 30
-Metrics/ParameterLists:
-  Max: 5
-  CountKeywordArgs: false
-Metrics/BlockLength:
-  CountAsOne: ['array', 'heredoc', 'method_call']
-  Max: 50
-Metrics/CyclomaticComplexity:
-  Max: 30
-Metrics/PerceivedComplexity:
-  Max: 30
-
-Style/AccessorGrouping:
-  Enabled: false
-Style/ConditionalAssignment:
-  Enabled: false
-Style/BlockDelimiters:
-  BracesRequiredMethods: ['log']
-  AllowedPatterns: ['proc', 'new']
-Style/HashSyntax:
-  EnforcedShorthandSyntax: either
-  EnforcedStyle: no_mixed_keys
-
-Style/ArgumentsForwarding:
-  UseAnonymousForwarding: false
-Style/ClassAndModuleChildren:
-  Enabled: false
-Style/FrozenStringLiteralComment:
-  Enabled: false
-Style/StringLiterals:
-  Enabled: false
-Style/StringLiteralsInInterpolation:
-  Enabled: false
-Style/Documentation:
-  Enabled: false
-Style/CommentedKeyword:
-  Enabled: false
-Style/MultilineBlockChain:
-  Enabled: false
-Style/AndOr:
-  Enabled: false
-Style/Alias:
-  EnforcedStyle: prefer_alias_method
-Style/FetchEnvVar:
-  Enabled: false
-Style/RegexpLiteral:
-  EnforcedStyle: mixed
-  AllowInnerSlashes: true
-
-Layout/HashAlignment:
-  EnforcedColonStyle: table
-  EnforcedHashRocketStyle: table
-Layout/LeadingCommentSpace:
-  Enabled: false
-  AllowGemfileRubyComment: true
-Layout/ParameterAlignment:
-  Enabled: false
-Layout/MultilineMethodDefinitionBraceLayout:
-  EnforcedStyle: symmetrical
-Layout/LineLength:
-  Enabled: true
-Layout/SpaceInsideHashLiteralBraces:
-  Enabled: false
-Layout/SpaceInsideBlockBraces:
-  Enabled: false
-Layout/SpaceAroundOperators:
-  Enabled: false
-Layout/ExtraSpacing:
-  AllowForAlignment: true
-  AllowBeforeTrailingComments: true
-Layout/AccessModifierIndentation:
-  EnforcedStyle: indent
-Layout/DotPosition:
-  EnforcedStyle: trailing
-Layout/MultilineMethodCallIndentation:
-  EnforcedStyle: indented
-Layout/FirstHashElementIndentation:
-  Enabled: false
-Layout/EmptyLineAfterGuardClause:
-  Enabled: false
-
-Naming/VariableNumber:
-  EnforcedStyle: snake_case
-  CheckSymbols: false
-Naming/MethodParameterName:
-  AllowedNames: ['x', 'y', 'i', 'j', 'id', 'io', 'to']
-Naming/RescuedExceptionsVariableName:
-  Enabled: false
-Naming/BlockForwarding:
-  Enabled: false

data/.ruby-version

@@ -1 +0,0 @@
-3.2.2

data/.yardopts

@@ -1,10 +0,0 @@
---readme README.md
---charset utf-8
---markup-provider=redcarpet
---markup=markdown
---no-private
---output-dir ./doc
-'lib/**/*.rb'
-CHANGELOG.md
--
-LICENSE

data/CLAUDE.md

@@ -1,83 +0,0 @@
-# CLAUDE.md — eco-helpers
-
-AI agent instructions for this repository.
-
-**Cross-cutting architecture context lives in `ecoportal-api-graphql` — see its `CLAUDE.md` and `.claude/` folder for the full dependency map, project history, and shared skills.**
-
----
-
-## Repository Role
-
-`eco-helpers` is the **primary downstream consumer** of the EcoPortal API gem stack. It provides a scripting and automation framework for interacting with EcoPortal — CLI tooling, use-case orchestration, data transformation, and batch operations.
-
-**Position in chain:**
-```
-ecoportal-api
-ecoportal-api-v2
-ecoportal-api-graphql
-      ↓
-eco-helpers            ← THIS REPO
-```
-
-**Remote:** https://gitlab.ecoportal.co.nz/oscar/script_api_helpers.git
-
-**Gem dependencies on the stack:**
-- `ecoportal-api ~> 0.10, >= 0.10.14`
-- `ecoportal-api-v2 ~> 3.3, >= 3.3.1`
-- `ecoportal-api-graphql ~> 1.3, >= 1.3.4`
-
----
-
-## Key Folder Layout
-
-```
-lib/eco/
-  api/                 API integration layer
-    common/            Shared helpers
-    microcases/        Fine-grained reusable operations
-    organization/      Org-level resources
-    session.rb         Session management (entry point for scripting)
-    usecases.rb        Use-case registry
-    policies.rb        Access policies
-  cli/                 CLI framework
-  cli_default/         Default CLI options, filters, people workflows
-  common/              Cross-cutting utilities
-  csv/                 CSV reading, streaming, splitting
-  data/                Data utilities (fuzzy match, hashes, locations, strings, files)
-  language/            Logging, curry, auxiliar utilities
-  assets/              Static assets (language files etc.)
-```
-
----
-
-## Namespace
-
-`Eco::` — entirely separate namespace from `Ecoportal::`. Does not reopen upstream gem namespaces.
-
----
-
-## Key Concerns
-
-- This gem is the **backwards-compatibility target** for all upstream gems. When `ecoportal-api-graphql` changes its public interface, check usage here first.
-- `Eco::API::Session` is the main consumer of `Ecoportal::API::GraphQL` — it's the first place to look when checking how GraphQL features are used downstream.
-- The CLI layer (`Eco::CLI`) uses Thor-style commands — changes to API interfaces may silently break CLI workflows if not tested end-to-end.
-- Many operations are batch-oriented with progress logging — error handling and partial-failure behaviour matters.
-
----
-
-## How to Find GraphQL Usage
-
-```bash
-grep -r "GraphQL\|graphql\|ecoportal-api-graphql" lib/ --include="*.rb" -l
-```
-
-This shows which files directly use the GraphQL gem — useful when assessing impact of upstream changes.
-
----
-
-## Running Tests
-
-```bash
-bundle install
-bundle exec rspec
-```

data/Gemfile

@@ -1,8 +0,0 @@
-source "https://rubygems.org"
-
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
-
-# Specify your gem's dependencies in eco-helpers.gemspec
-gemspec
-
-# gem 'rubocop-rake', require: false

data/Rakefile

@@ -1,38 +0,0 @@
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-require 'rubocop/rake_task'
-require 'yard'
-require 'redcarpet'
-
-desc "run the specs"
-RSpec::Core::RakeTask.new(:spec)
-
-desc "run rspec showing backtrace"
-RSpec::Core::RakeTask.new(:spec_trace) do |task|
-  task.rspec_opts = ['--backtrace']
-end
-task(rspec_trace: :spec_trace)
-
-desc "run rspec stopping on first fail, and show backtrace"
-RSpec::Core::RakeTask.new(:spec_fast) do |task|
-  task.rspec_opts = ['--fail-fast', '--backtrace']
-end
-task(rspec_fast: :spec_fast)
-
-desc "run rubocop diaplying cop names"
-RuboCop::RakeTask.new(:rubocop) do |t|
-  t.options = ['--display-cop-names']
-end
-
-# default task name is yard
-desc "Yard: generate all the documentation"
-YARD::Rake::YardocTask.new(:doc) do |t|
-  #t.files = ['lib/**/*.rb']
-end
-
-desc "default task: runs rubocop and rspec"
-task :default do
-  Rake::Task[:rubocop].invoke
-ensure
-  Rake::Task[:spec].invoke
-end

data/eco-helpers.gemspec

@@ -1,63 +0,0 @@
-# rubocop:disable Gemspec/DevelopmentDependencies
-lib = File.expand_path('lib', __dir__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-
-require './lib/eco/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = 'eco-helpers'
-  spec.version       = Eco::VERSION
-  spec.platform      = Gem::Platform::RUBY
-  spec.authors       = ['Oscar Segura']
-  spec.email         = ['oscar@ecoportal.co.nz']
-
-  spec.summary       = "eco-helpers to manage people api cases"
-  spec.homepage      = "https://www.ecoportal.com"
-  spec.licenses      = %w[MIT]
-
-  spec.metadata['rubygems_mfa_required'] = 'true'
-
-  spec.required_ruby_version = '>= 3.2.2'
-
-  spec.files = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(/^(test|spec|features)\//)
-  end
-
-  #spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  #spec.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  spec.require_paths = ['lib']
-
-  spec.add_development_dependency 'byebug'
-  spec.add_development_dependency 'rake',      '>= 13.0.3', '< 14'
-  spec.add_development_dependency 'redcarpet', '>= 3.6.0',  '< 4'
-  spec.add_development_dependency 'rspec',     '>= 3.12.0', '< 4'
-  spec.add_development_dependency 'rubocop',   '~> 1'
-  spec.add_development_dependency 'rubocop-rake', '~> 0'
-  spec.add_development_dependency 'yard',         '~> 0.9'
-
-  spec.add_dependency 'amatch',        '>= 0.4.1', '< 0.5'
-  spec.add_dependency 'aws-sdk-s3',    '>= 1.142.0', '< 2'
-  spec.add_dependency 'aws-sdk-ses',   '>= 1.58.0', '< 2'
-  spec.add_dependency 'bcrypt_pbkdf',  '~> 1.0'
-  spec.add_dependency 'docx',          '>= 0.8.0', '< 0.9'
-  spec.add_dependency 'dotenv',        '~> 3'
-  spec.add_dependency 'ecoportal-api',         '~> 0.10', '>= 0.10.14'
-  spec.add_dependency 'ecoportal-api-graphql', '~> 1.3',  '>= 1.3.9'
-  spec.add_dependency 'ecoportal-api-v2',      '~> 3.3',  '>= 3.3.1'
-  spec.add_dependency 'ed25519',       '~> 1.2'
-  spec.add_dependency 'fast_excel',    '>= 0.5.0',  '< 0.6'
-  spec.add_dependency 'fuzzy_match',   '>= 2.1.0',  '< 2.2'
-  spec.add_dependency 'hashdiff',      '>= 1.1.0',  '< 1.2'
-  spec.add_dependency 'jaro_winkler',  '>= 1.5.6',  '< 1.6'
-  spec.add_dependency 'net-http',      '~> 0.6.0'
-  spec.add_dependency 'net-sftp',      '>= 4.0.0',  '< 5'
-  spec.add_dependency 'net-ssh',       '>= 7.2.1',  '< 8'
-  spec.add_dependency 'nokogiri',      '>= 1.13',   '< 1.17'
-  spec.add_dependency 'roo',           '>= 2.10.1', '< 2.11'
-  spec.add_dependency 'roo-xls',       '>= 1.2.0',  '< 1.3'
-  spec.add_dependency 'rubyzip',       '>= 2.3.2',  '< 2.4'
-  spec.add_dependency 'sendgrid-ruby', '~> 6.7.0'
-  # spec.add_dependency 'uri',           '~> 1.0', '>= 1.0.3'
-end
-
-# rubocop:enable Gemspec/DevelopmentDependencies