ecoportal-api-graphql 1.3.9 → 1.3.11

data/tests/validate_queries.rb

@@ -0,0 +1,127 @@
+require 'ecoportal/api-graphql'
+require 'json'
+require 'graphql'
+
+# Validate EVERY gem query against a GraphQL schema, offline — catches the whole class of
+# "field must have selections" (object field selected bare) and "selections can't be made on
+# scalars" (scalar over-selected) bugs before they reach a client runner.
+#
+# This is how the 2026-07-03 LocationStructure `updatedAt` prod failure (and a sibling
+# `createdAt` over-selection in the LocationDraft fragment) were found. Those queries had no
+# spec; this script would have flagged them.
+#
+# It renders each query's block offline (auth is stubbed — no network), assembles its fragments,
+# and validates the full document against a schema introspection JSON.
+#
+# Usage (run under bundler so the graphlient fork's #to_query_string is available):
+#   bundle exec ruby tests/validate_queries.rb [PATH_TO_SCHEMA_INTROSPECTION_JSON]
+#
+# Get a fresh schema JSON via an introspection query against the org's endpoint; the default
+# below points at the last captured dump. Prefer a fresh dump — a stale one yields false
+# "field doesn't exist" noise (harmless: this script only *fails* on the two structural classes).
+
+DEFAULT_SCHEMA = File.expand_path('../.ai-assistance/tmp/20260605T101224_live_ep_graphql_schema.graphql.json', __dir__)
+STRUCTURAL = ['must have selections', "can't be made on scalars"].freeze
+
+schema_path = ARGV[0] || DEFAULT_SCHEMA
+unless File.exist?(schema_path)
+  warn "Schema introspection JSON not found: #{schema_path}"
+  warn 'Pass a path: bundle exec ruby tests/validate_queries.rb <schema.json>'
+  exit 2
+end
+
+# Build a client offline — stub the session token so no network/creds are needed for rendering.
+Ecoportal::API::Common::GraphQL::Client.class_eval do
+  def session_token(*_args, **_kwargs)
+    'dummy'
+  end
+end
+client = Ecoportal::API::Common::GraphQL::Client.new(
+  email: 'validate@local', pass: 'x', org_id: 'validate', host: 'live.ecoportal.com', no_schema: true
+)
+schema = GraphQL::Schema.from_introspection(JSON.parse(File.read(schema_path)))
+
+# Collect every concrete query AND mutation class (recursively, incl. nested like
+# LocationStructure::Draft). Mutations are included because a dead fragment reference (e.g. the
+# removed `___Const__Fragment` convention) only surfaces when the operation is RENDERED — and
+# mutations were previously unscanned, which is exactly how the Action/ContractorEntity mutation
+# fragment breakage reached production undetected.
+op_classes = []
+collect = lambda do |mod|
+  mod.constants.each do |const|
+    obj = begin
+      mod.const_get(const)
+    rescue StandardError
+      next
+    end
+    next unless obj.is_a?(Module)
+
+    op_classes << obj if obj.is_a?(Class) && obj.private_method_defined?(:basic_block)
+    collect.call(obj)
+  end
+end
+collect.call(Ecoportal::API::GraphQL::Query)
+collect.call(Ecoportal::API::GraphQL::Mutation)
+op_classes.uniq!
+
+structural_bugs = {}
+other_errors    = {}
+render_failures = {}
+render_skips = []
+
+op_classes.sort_by(&:name).each do |klass|
+  inst = klass.new(client)
+  begin
+    query_str = client.to_query_string(&inst.send(:basic_block))
+  rescue NameError => e
+    # The operation cannot even RENDER — an unresolved constant / dead fragment reference
+    # (e.g. the removed `___Const__Fragment` convention pointing at a Fragment:: constant that
+    # no longer exists now that fragments are a registry). Same bug class that crashed the live
+    # LocationDraft / Action / ContractorEntity paths. HARD FAIL.
+    render_failures[klass.name] = ["#{e.class}: #{e.message}"]
+    next
+  end
+  fragments = begin
+    inst.send(:assemble_fragments, query_str)
+  rescue StandardError
+    ''
+  end
+  full = fragments.to_s.empty? ? query_str : "#{query_str}\n\n#{fragments}"
+  messages = schema.validate(full).map(&:message)
+  bugs  = messages.select { |m| STRUCTURAL.any? { |s| m.include?(s) } }
+  other = messages - bugs
+  structural_bugs[klass.name] = bugs  unless bugs.empty?
+  other_errors[klass.name]    = other unless other.empty?
+rescue StandardError => e
+  render_skips << "#{klass.name} — #{e.class}: #{e.message}"
+end
+
+puts "Validated #{op_classes.size} query + mutation classes against #{File.basename(schema_path)}\n\n"
+
+puts '## FRAGMENT / RENDER FAILURES (fail the build — operation could not render, e.g. dead fragment ref):'
+if render_failures.empty?
+  puts '  none ✅'
+else
+  render_failures.each { |name, msgs| puts "  #{name}\n    - #{msgs.join("\n    - ")}" }
+end
+
+puts "\n## STRUCTURAL BUGS (fail the build — bare object / over-selected scalar):"
+if structural_bugs.empty?
+  puts '  none ✅'
+else
+  structural_bugs.each { |name, msgs| puts "  #{name}\n    - #{msgs.join("\n    - ")}" }
+end
+
+puts "\n## OTHER validation findings (verify — may be schema-dump staleness or union handling):"
+if other_errors.empty?
+  puts '  none'
+else
+  other_errors.each { |name, msgs| puts "  #{name}\n    - #{msgs.first(3).join("\n    - ")}" }
+end
+
+unless render_skips.empty?
+  puts "\n## RENDER-SKIPS (could not auto-render — check manually):"
+  render_skips.each { |s| puts "  #{s}" }
+end
+
+exit(structural_bugs.empty? && render_failures.empty? ? 0 : 1)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ecoportal-api-graphql
 version: !ruby/object:Gem::Version
-  version: 1.3.9
+  version: 1.3.11
 platform: ruby
 authors:
 - Oscar Segura
@@ -160,7 +160,7 @@ dependencies:
         version: '3.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.3.2
+        version: 3.3.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -170,7 +170,7 @@ dependencies:
         version: '3.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.3.2
+        version: 3.3.3
 - !ruby/object:Gem::Dependency
   name: graphlient
   requirement: !ruby/object:Gem::Requirement
@@ -219,6 +219,7 @@ files:
 - ".ai-assistance/code/data_fields.md"
 - ".ai-assistance/code/dependencies.md"
 - ".ai-assistance/code/diff_as_input.md"
+- ".ai-assistance/code/diff_pairing_engine.md"
 - ".ai-assistance/code/diff_service_deep_dive.md"
 - ".ai-assistance/code/ecoPortal_architecture/00_overview_and_index.md"
 - ".ai-assistance/code/ecoPortal_architecture/01_terminology_dictionary.md"
@@ -241,6 +242,7 @@ files:
 - ".ai-assistance/code/schema_analysis.md"
 - ".ai-assistance/code/search_filters.md"
 - ".ai-assistance/code/spec_coverage.md"
+- ".ai-assistance/code/template_diff_pairing_domain.md"
 - ".ai-assistance/code/workflow-command-guide.md"
 - ".ai-assistance/code/workflow-space.md"
 - ".ai-assistance/conventions/CLAUDE.md"
@@ -267,15 +269,27 @@ files:
 - ".ai-assistance/projects/graphql-agent/GAP_ANALYSIS.md"
 - ".ai-assistance/projects/ooze-graphql-native-migration/DECISIONS.md"
 - ".ai-assistance/projects/ooze-graphql-native-migration/INTENT.md"
+- ".ai-assistance/projects/ooze-graphql-native-migration/INVENTORY.md"
 - ".ai-assistance/projects/ooze-graphql-native-migration/RISKS.md"
 - ".ai-assistance/projects/ooze-graphql-native-migration/TODO.md"
 - ".ai-assistance/projects/ooze-graphql-native-migration/analysis/2026-06-30-cutover-workflow-deep-review.md"
 - ".ai-assistance/projects/ooze-graphql-native-migration/analysis/2026-07-01-forces-via-workflow-commands-miss-rca.md"
 - ".ai-assistance/projects/page-model/DECISIONS.md"
 - ".ai-assistance/projects/page-model/TODO.md"
+- ".ai-assistance/projects/qa-services-delivery/DECISIONS.md"
+- ".ai-assistance/projects/qa-services-delivery/INTENT.md"
+- ".ai-assistance/projects/qa-services-delivery/PHASE3-SCOPE.md"
+- ".ai-assistance/projects/qa-services-delivery/ROADMAP.md"
+- ".ai-assistance/projects/qa-services-delivery/TODO.md"
 - ".ai-assistance/projects/search-filter-builder/INTENT.md"
 - ".ai-assistance/projects/search-filter-builder/TODO.md"
+- ".ai-assistance/projects/template-automatic-build-maintenance/INTENT.md"
+- ".ai-assistance/projects/template-automatic-build-maintenance/TODO.md"
+- ".ai-assistance/projects/template-diff-deploy/INTENT.md"
+- ".ai-assistance/projects/template-diff-deploy/TODO.md"
 - ".ai-assistance/projects/template-maintenance/DESIGN.md"
+- ".ai-assistance/projects/template-maintenance/PHASE0-FINDINGS.md"
+- ".ai-assistance/projects/template-maintenance/README.md"
 - ".ai-assistance/projects/workflow-space/TODO.md"
 - ".ai-assistance/reinstall-claude-desktop-windows.md"
 - ".ai-assistance/scripts/CLAUDE.md"
@@ -449,6 +463,7 @@ files:
 - lib/ecoportal/api/graphql/builder/register.rb
 - lib/ecoportal/api/graphql/builder/register/preset_view.rb
 - lib/ecoportal/api/graphql/builder/template.rb
+- lib/ecoportal/api/graphql/builder/template_builder.rb
 - lib/ecoportal/api/graphql/compat.rb
 - lib/ecoportal/api/graphql/compat/filter_translator.rb
 - lib/ecoportal/api/graphql/compat/page_reference.rb
@@ -473,6 +488,18 @@ files:
 - lib/ecoportal/api/graphql/connection/person_member.rb
 - lib/ecoportal/api/graphql/connection/preset_view.rb
 - lib/ecoportal/api/graphql/connection/preview_page.rb
+- lib/ecoportal/api/graphql/diff.rb
+- lib/ecoportal/api/graphql/diff/change.rb
+- lib/ecoportal/api/graphql/diff/command_synthesizer.rb
+- lib/ecoportal/api/graphql/diff/cross_object_diff.rb
+- lib/ecoportal/api/graphql/diff/deploy.rb
+- lib/ecoportal/api/graphql/diff/id_resolver.rb
+- lib/ecoportal/api/graphql/diff/pairing/candidate.rb
+- lib/ecoportal/api/graphql/diff/pairing/engine.rb
+- lib/ecoportal/api/graphql/diff/pairing/ledger.rb
+- lib/ecoportal/api/graphql/diff/pairing/signals.rb
+- lib/ecoportal/api/graphql/diff/strategy.rb
+- lib/ecoportal/api/graphql/diff/version_diff.rb
 - lib/ecoportal/api/graphql/error.rb
 - lib/ecoportal/api/graphql/error/locations_error.rb
 - lib/ecoportal/api/graphql/error/locations_error/fetch_nested.rb
@@ -826,10 +853,12 @@ files:
 - tests/contractor_entity_create.rb
 - tests/contractor_entity_udpate.rb
 - tests/dump_page_model.rb
+- tests/dump_template_model.rb
 - tests/loc_structure_get.rb
 - tests/loc_structure_update.rb
 - tests/loc_structures_get.rb
 - tests/local_libs.rb
+- tests/validate_queries.rb
 homepage: https://www.ecoportal.com
 licenses:
 - MIT