ecoportal-api-graphql 1.3.13 → 1.3.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fba9a366d06303f179c6b7d841930a66a29b6cc3fe836e06b218b95873bbe77e
-  data.tar.gz: 6114ba779317ec55b649e1f7df685c0140573cea073aa07c04b9e4cfa20b433a
+  metadata.gz: 5cbeb13326afff8c35946fd492b9bd6cd050e28819497b643bb4ea6c4b41caca
+  data.tar.gz: ad4660f8fa032e08d0c5f09b199f280d8b42a4e234144ad2fab4041b154fe835
 SHA512:
-  metadata.gz: d867c896796e9107870a2a49e3cdc75275b0a96559a9b8fe47fedea407ef639f7ff558ce22de798f79f3f011c7d4464a3eacd01a63e764778d2e0359cd8ed4ad
-  data.tar.gz: c29f555f19fc3d679f51cb512c417caca1e7e5f0006e9ac35a7ccf4d7f074095011ad4a59128a458b69c178dd538d79bf952d1b26b1557397e0d5fc4c41274d4
+  metadata.gz: 7337308796e0a6800e9dd678d8b9317978d4cf13f6514b2ba95e5d6eaac95b9833be786ca573b7e59613660077aaa78c808a62c4bbef0c9e2f1a08e0c752e857
+  data.tar.gz: 602edaca4d582eeb876549bba42735fc17fc07d832de713fd3ba84234cc2a876aea876beb51c4fb54eef3faf5a334b889443d922d9c6debe196545389b2715e6

data/.ai-assistance/bridge/archive/oscar-a1b2c3d-gitlab-mcp-doc-update.inbox.md

@@ -1,29 +1,29 @@
-# TASK: Update gitlab-mcp.md with new PAT scopes and rotation info
-
-STATUS: PENDING
-CREATED: 2026-06-04T00:00:00Z
-FROM: cowork
-TO: code
-
-## File to update
-
-`.claude/integrations/gitlab-mcp.md`
-
-## Changes
-
-### Scopes table — replace entirely
-
-| `read_api`       | Read MRs, issues, diffs, repository metadata |
-| `read_repository`| Clone and read repository contents           |
-| `create_runner`  | Register GitLab CI runners                   |
-| `ai_features`    | Access GitLab AI/Duo endpoints               |
-
-### PAT creation note — replace
-
-Enable **rotation** at creation time.
-**Token rotation:** Current token expires **April 2027**. When rotating, update
-in both `.env` and `claude_desktop_config.json`.
-
-### "What it doesn't provide" — remove pipeline management item
-
-`create_runner` + `ai_features` scopes now partially cover CI and AI capabilities.
+# TASK: Update gitlab-mcp.md with new PAT scopes and rotation info
+
+STATUS: PENDING
+CREATED: 2026-06-04T00:00:00Z
+FROM: cowork
+TO: code
+
+## File to update
+
+`.claude/integrations/gitlab-mcp.md`
+
+## Changes
+
+### Scopes table — replace entirely
+
+| `read_api`       | Read MRs, issues, diffs, repository metadata |
+| `read_repository`| Clone and read repository contents           |
+| `create_runner`  | Register GitLab CI runners                   |
+| `ai_features`    | Access GitLab AI/Duo endpoints               |
+
+### PAT creation note — replace
+
+Enable **rotation** at creation time.
+**Token rotation:** Current token expires **April 2027**. When rotating, update
+in both `.env` and `claude_desktop_config.json`.
+
+### "What it doesn't provide" — remove pipeline management item
+
+`create_runner` + `ai_features` scopes now partially cover CI and AI capabilities.

data/.ai-assistance/bridge/archive/oscar-c912c25-gemini-design-review.inbox.md

@@ -1,42 +1,42 @@
-# TASK: Gemini design review of CoWork↔Code bridge architecture
-STATUS: PENDING
-CREATED: 2026-06-03T00:00:00Z
-FROM: cowork
-TO: code
-
-## Context
-We have designed a file-based bridge system for bidirectional communication between
-Claude in CoWork and Claude Code. The bridge lives in .claude/bridge/ inside a git repo.
-
-Architecture summary:
-- Inbox/outbox pattern with UUID+username prefixed filenames (no merge conflicts)
-- Scripts (bash + TypeScript) handle file ops, env detection, UUID gen — offloading work from AI tokens
-- CLAUDE.md files in each subfolder give each agent scoped instructions
-- capabilities/ folder tracks what each environment can do, with a dated assumptions log
-- conventions/ folder defines gitignore rules and instruction file structure
-- capabilities-check.ts runs periodically using Haiku to flag stale assumptions
-
-Key design decisions:
-- Each agent checks capabilities before bridging (only bridge what you can't do yourself)
-- Archive is committed to git — it's the audit trail
-- Draft tasks (.draft.md) are gitignored — local-only until pushed
-- Code processes only its own username-prefixed tasks
-
-## Request
-Use the Gemini connector (or Gemini API if available) to get an independent review of
-this architecture. Ask Gemini:
-
-1. What are the weaknesses or failure modes of this design?
-2. Is the token-offloading strategy (scripts vs AI prose) well-scoped, or are there gaps?
-3. Are there simpler or more robust alternatives for any part of this?
-4. Anything we haven't considered — especially around git workflows, multi-agent coordination,
-   or long-term maintenance?
-
-If Gemini connector is not available, use web search to find prior art on
-file-based agent coordination patterns and report what you find.
-
-## Expected output
-- Gemini's (or research-based) critique: weaknesses, gaps, alternatives
-- Your own assessment: do you agree with the critique? What would you change?
-- Specific suggested amendments to the design (if any)
-- Update capabilities/connectors.md with Gemini connector status after attempting this
+# TASK: Gemini design review of CoWork↔Code bridge architecture
+STATUS: PENDING
+CREATED: 2026-06-03T00:00:00Z
+FROM: cowork
+TO: code
+
+## Context
+We have designed a file-based bridge system for bidirectional communication between
+Claude in CoWork and Claude Code. The bridge lives in .claude/bridge/ inside a git repo.
+
+Architecture summary:
+- Inbox/outbox pattern with UUID+username prefixed filenames (no merge conflicts)
+- Scripts (bash + TypeScript) handle file ops, env detection, UUID gen — offloading work from AI tokens
+- CLAUDE.md files in each subfolder give each agent scoped instructions
+- capabilities/ folder tracks what each environment can do, with a dated assumptions log
+- conventions/ folder defines gitignore rules and instruction file structure
+- capabilities-check.ts runs periodically using Haiku to flag stale assumptions
+
+Key design decisions:
+- Each agent checks capabilities before bridging (only bridge what you can't do yourself)
+- Archive is committed to git — it's the audit trail
+- Draft tasks (.draft.md) are gitignored — local-only until pushed
+- Code processes only its own username-prefixed tasks
+
+## Request
+Use the Gemini connector (or Gemini API if available) to get an independent review of
+this architecture. Ask Gemini:
+
+1. What are the weaknesses or failure modes of this design?
+2. Is the token-offloading strategy (scripts vs AI prose) well-scoped, or are there gaps?
+3. Are there simpler or more robust alternatives for any part of this?
+4. Anything we haven't considered — especially around git workflows, multi-agent coordination,
+   or long-term maintenance?
+
+If Gemini connector is not available, use web search to find prior art on
+file-based agent coordination patterns and report what you find.
+
+## Expected output
+- Gemini's (or research-based) critique: weaknesses, gaps, alternatives
+- Your own assessment: do you agree with the critique? What would you change?
+- Specific suggested amendments to the design (if any)
+- Update capabilities/connectors.md with Gemini connector status after attempting this

data/.gitignore

@@ -1,37 +1,37 @@
-# it's a gem, ignore the lockfile
-Gemfile.lock
-
-.env
-.ai-assistance/local_paths.md
-# build artifacts
-*.gem
-/.bundle/
-/vendor/bundle
-/spec/reports/
-/tmp/
-/pkg/
-
-# docs
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-
-# rspec failure tracking
-.rspec_status
-scratch.rb
-tests/.byebug_history
-
-.solargraph.yml
-
-# AI assistance — local-only files
-.ai-assistance/code/dep-graph.json
-.ai-assistance/tmp/
-.ai-assistance/local/
-.ai-assistance/bridge/inbox/*.draft.md
-.ai-assistance/bridge/inbox/*.local.md
-.ai-assistance/bridge/LOCK
-.ai-assistance/bridge/STATUS
-.ai-assistance/capabilities/.env
-.ai-assistance/scripts/*.env
-.ai-assistance/scripts/node_modules/
+# it's a gem, ignore the lockfile
+Gemfile.lock
+
+.env
+.ai-assistance/local_paths.md
+# build artifacts
+*.gem
+/.bundle/
+/vendor/bundle
+/spec/reports/
+/tmp/
+/pkg/
+
+# docs
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+
+# rspec failure tracking
+.rspec_status
+scratch.rb
+tests/.byebug_history
+
+.solargraph.yml
+
+# AI assistance — local-only files
+.ai-assistance/code/dep-graph.json
+.ai-assistance/tmp/
+.ai-assistance/local/
+.ai-assistance/bridge/inbox/*.draft.md
+.ai-assistance/bridge/inbox/*.local.md
+.ai-assistance/bridge/LOCK
+.ai-assistance/bridge/STATUS
+.ai-assistance/capabilities/.env
+.ai-assistance/scripts/*.env
+.ai-assistance/scripts/node_modules/

data/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.3.14] - 2026-07-16
+
+Re-issue of the **1.3.13 HttpClient resilience fix** under a fresh version. The `1.3.13`
+artifact published to the gem server (2026-07-11) could not be relied upon to contain the
+fix below — RubyGems versions are immutable and cannot be re-pushed, so the fix ships here
+as `1.3.14`. Functionally identical to the *intended* `1.3.13` (this is `1.3.12` + the
+resilience fix, nothing else). **Backwards-compatible.**
+
+Consumers that need the 429/1015 resilience (e.g. bulk `cans-upsert` live runs) must floor
+`ecoportal-api-graphql >= 1.3.14` — a `>= 1.3.13` floor is not sufficient.
+
+### Fixed
+
+- Same fix as documented under `[1.3.13]` below: `Common::GraphQL::HttpClient#execute` routes
+  through the inherited `instrument → with_retry { rate_throttling }` pipeline, so a single
+  HTTP 429 (Cloudflare edge rate-limit `1015`) no longer aborts the run.
+
 ## [1.3.13] - 2026-07-12
 
 Reliability: the GraphQL `HttpClient` now inherits the **same request-resilience

data/docs/worklog.md

@@ -8,24 +8,6 @@ This file tracks cross-project session state and the overall repo status.
 
 ---
 
-## ▶ SESSION 2026-07-10 — OD-001 decision-support delivered to ep-ai-standards (breadcrumb)
-
-Produced a decision-support doc mapping this repo's REAL GraphQL mutation surface onto
-ep-ai-standards' operation-class ladder for OD-001 (the GraphQL gateway PROD "low-risk"
-auto-approval threshold / provisional Dial A). Evidence-based from live introspection
-(`.ai-assistance/tmp/20260605T101224_live_ep_graphql_schema.graphql.json` -- 190 mutations)
-+ code-specs + `lib/ecoportal/api/graphql/mutation/**`. Key findings: register-type axis is
-real + in-schema (`Register.registerStatus: TESTING|LIVE`, `base/register.rb:7`); org-type
-(sandpit/uat/demo/PROD) is NOT a schema field (infra/credential-level, `base/organization.rb`
-exposes only id/name/companyName/logoUrl); several mutations do not map cleanly (payload-hidden
-deletions in `updatePage`, bulk/cascade, cross-env UAT->PROD deploy, egress/email/credential
-mints). Delivered to ep-ai-standards' bridge inbox as
-`ecoportal-api-graphql-od001-mutation-mapping.md` (STATUS: PENDING) -- a PROPOSAL for the graphql
-team + Oscar to validate via an ep-ai-standards MR. NO code changed in this repo. Does not change
-OD-001's ruling. (OD-007 breadcrumb convention.)
-
----
-
 ## ▶ SESSION 2026-07-05 — 3 live act-gov crashes = ONE root cause (stale released gems); fixed-stack floors
 
 Three live crashes on act-gov (`-toocs-coding` + org-structure sync), all the **same class**: the

data/lib/ecoportal/api/common/graphql/client.rb

@@ -29,8 +29,6 @@ module Ecoportal
 
             puts "Configuring GraphQL Client onto '#{url}'"
 
-            pp email
-
             super(
               url,
               headers:      {

data/lib/ecoportal/api/graphql/base/location_classification_type.rb

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class LocationClassificationType < Logic::BaseModel
-          root!
-
-          passkey :id
-          passthrough :name
-          passboolean :active
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class LocationClassificationType < Logic::BaseModel
+          root!
+
+          passkey :id
+          passthrough :name
+          passboolean :active
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/location_structure.rb

@@ -1,27 +1,27 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class LocationStructure < Interface::LocationStructure::Nodes
-          read_only!
-
-          class_resolver :location_node_class, Base::LocationNode
-          class_resolver :draft_class, "Base::LocationStructure::Draft"
-
-          passkey :id
-          passthrough :name, :weight
-          passboolean :archived, :published, :visitorManagementEnabled
-          embeds_one :updatedAt, klass: Base::DateTime
-
-          embeds_many :drafts, klass: :draft_class, order_key: :createdAt
-
-          def draft?
-            false
-          end
-        end
-      end
-    end
-  end
-end
-
-require_relative 'location_structure/draft'
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class LocationStructure < Interface::LocationStructure::Nodes
+          read_only!
+
+          class_resolver :location_node_class, Base::LocationNode
+          class_resolver :draft_class, "Base::LocationStructure::Draft"
+
+          passkey :id
+          passthrough :name, :weight
+          passboolean :archived, :published, :visitorManagementEnabled
+          embeds_one :updatedAt, klass: Base::DateTime
+
+          embeds_many :drafts, klass: :draft_class, order_key: :createdAt
+
+          def draft?
+            false
+          end
+        end
+      end
+    end
+  end
+end
+
+require_relative 'location_structure/draft'

data/lib/ecoportal/api/graphql/base/organization.rb

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class Organization < Logic::BaseModel
-          root!
-
-          passkey :id
-          passthrough :name, :companyName
-          passthrough :logoUrl, read_only: true
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class Organization < Logic::BaseModel
+          root!
+
+          passkey :id
+          passthrough :name, :companyName
+          passthrough :logoUrl, read_only: true
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base.rb

@@ -1,35 +1,35 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-      end
-    end
-  end
-end
-
-require_relative 'base/date_time'
-require_relative 'base/page_info'
-require_relative 'base/location_classification_type'
-require_relative 'base/location_node'
-require_relative 'base/location_structure'
-require_relative 'base/person_member'
-require_relative 'base/file_attachment'
-require_relative 'base/file_container'
-require_relative 'base/field'
-require_relative 'base/page'
-require_relative 'base/resource'
-require_relative 'base/action_category'
-require_relative 'base/action'
-require_relative 'base/contractor_entity'
-require_relative 'base/preview_page'
-require_relative 'base/delta_result'
-require_relative 'base/organization'
-
-require_relative 'base/register'
-require_relative 'base/preset_view'
-
-require_relative 'base/ai_summary_version'
-
-require_relative 'base/force'
-require_relative 'base/pages_workflow'
-require_relative 'base/kickstand'
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+      end
+    end
+  end
+end
+
+require_relative 'base/date_time'
+require_relative 'base/page_info'
+require_relative 'base/location_classification_type'
+require_relative 'base/location_node'
+require_relative 'base/location_structure'
+require_relative 'base/person_member'
+require_relative 'base/file_attachment'
+require_relative 'base/file_container'
+require_relative 'base/field'
+require_relative 'base/page'
+require_relative 'base/resource'
+require_relative 'base/action_category'
+require_relative 'base/action'
+require_relative 'base/contractor_entity'
+require_relative 'base/preview_page'
+require_relative 'base/delta_result'
+require_relative 'base/organization'
+
+require_relative 'base/register'
+require_relative 'base/preset_view'
+
+require_relative 'base/ai_summary_version'
+
+require_relative 'base/force'
+require_relative 'base/pages_workflow'
+require_relative 'base/kickstand'

data/lib/ecoportal/api/graphql/builder/contractor_entity.rb

@@ -1,41 +1,41 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class ContractorEntity
-          attr_reader :client
-
-          def initialize(client)
-            @client = client
-          end
-
-          def create(**kargs, &block)
-            createMutation.query(**kargs, &block)
-          end
-
-          def update(**kargs, &block)
-            updateMutation.query(**kargs, &block)
-          end
-
-          def destroy(**kargs, &block)
-            destroyMutation.query(**kargs, &block)
-          end
-
-          private
-
-          def createMutation
-            Mutation::ContractorEntity::Create.new(client)
-          end
-
-          def updateMutation
-            Mutation::ContractorEntity::Update.new(client)
-          end
-
-          def destroyMutation
-            Mutation::ContractorEntity::Destroy.new(client)
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class ContractorEntity
+          attr_reader :client
+
+          def initialize(client)
+            @client = client
+          end
+
+          def create(**kargs, &block)
+            createMutation.query(**kargs, &block)
+          end
+
+          def update(**kargs, &block)
+            updateMutation.query(**kargs, &block)
+          end
+
+          def destroy(**kargs, &block)
+            destroyMutation.query(**kargs, &block)
+          end
+
+          private
+
+          def createMutation
+            Mutation::ContractorEntity::Create.new(client)
+          end
+
+          def updateMutation
+            Mutation::ContractorEntity::Update.new(client)
+          end
+
+          def destroyMutation
+            Mutation::ContractorEntity::Destroy.new(client)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/action.rb

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class Action < Logic::Connection
-          class_resolver :node_class, Model::Action
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class Action < Logic::Connection
+          class_resolver :node_class, Model::Action
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/action_category.rb

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class ActionCategory < Logic::Connection
-          class_resolver :node_class, Base::ActionCategory
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class ActionCategory < Logic::Connection
+          class_resolver :node_class, Base::ActionCategory
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/contractor_entity.rb

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class ContractorEntity < Logic::Connection
-          class_resolver :node_class, Model::ContractorEntity
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class ContractorEntity < Logic::Connection
+          class_resolver :node_class, Model::ContractorEntity
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/page.rb

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class Page < Logic::Connection
-          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class Page < Logic::Connection
+          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+        end
+      end
+    end
+  end
+end