ecoportal-api-graphql 1.3.5 → 1.3.9

data/.ai-assistance/version.json

@@ -0,0 +1,39 @@
+{
+  "schema": "1.0",
+  "note": "Tracks which features are installed in THIS .ai-assistance/ directory. Updated by install.sh on each deployment. Do NOT confuse with standards-version.json (ep-ai-standards compliance) — this is .ai-assistance/ infrastructure versioning.",
+
+  "installed_at": "2026-06-09",
+  "installed_from": "ep-ai-standards",
+
+  "features": {
+    "bridge_protocol": {
+      "version": "1.1.0",
+      "scripts": ["bridge-init.sh", "lock-acquire.sh", "lock-multi.sh", "lock-queue.sh", "bridge-status.sh", "check-outbox.sh"],
+      "directories": ["bridge/inbox", "bridge/outbox", "bridge/archive", "bridge/queue"],
+      "note": "v1.1.0 adds cross-repo locking (lock-multi.sh) and turn-request queue (lock-queue.sh, bridge/queue/)"
+    },
+    "token_budget": {
+      "version": "1.0.0",
+      "scripts": ["token-logger.js", "token-session-start.js", "token-report.ts"],
+      "config": "token-budget.json",
+      "hooks": ["Stop", "SessionStart"],
+      "note": "Automatic token tracking via Claude Code hooks. Requires Node.js."
+    },
+    "skills": {
+      "version": "1.0.0",
+      "directory": "skills/",
+      "note": "See skills/ for available SKILL.md files"
+    },
+    "capabilities_registry": {
+      "version": "1.0.0",
+      "directory": "capabilities/",
+      "files": ["code.md", "cowork.md", "connectors.md", "assumptions-log.md"]
+    },
+    "conventions": {
+      "version": "1.0.0",
+      "directory": "conventions/"
+    }
+  },
+
+  "how_agents_should_use_this": "Before invoking any feature, check features.<name> exists and is not null. If a feature is missing or null, the capability is not installed — do not assume it exists. Example: if features.token_budget is null, do not reference token logging commands."
+}

data/.claude/settings.json

@@ -0,0 +1,146 @@
+{
+  "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)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git status*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git log*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git diff*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git show*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git branch*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git fetch*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git checkout*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git switch*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git add*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git commit*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git rev-parse*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git merge-base*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git ls-remote*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && git stash*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && bundle exec rspec*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && bundle exec rake test*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && bundle exec rubocop*)",
+      "Bash(cd C:/ruby_scripts/git/graphlient && bundle install*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git status*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git log*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git diff*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git show*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git branch*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git fetch*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git checkout*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git switch*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git add*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git commit*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git rev-parse*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git merge-base*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git ls-remote*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && git stash*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && bundle exec rake test*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && bundle exec rubocop*)",
+      "Bash(cd C:/ruby_scripts/git/graphql-client && bundle install*)"
+    ],
+    "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": "bash .ai-assistance/scripts/bridge-init.sh 2>/dev/null || true"
+          },
+          {
+            "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"
+          },
+          {
+            "type": "command",
+            "command": "bash scripts/auto-worker-scheduler.sh 2>/dev/null || true"
+          }
+        ]
+      }
+    ]
+  }
+}

data/.env.example

@@ -0,0 +1,18 @@
+# Copy this file to .env and fill in your values.
+# .env is git-ignored — never commit real keys.
+
+# Gemini API key — get from https://aistudio.google.com/app/apikey
+GEMINI_API_KEY=your-key-here
+
+# Gemini model override — default is gemini-2.5-pro (best for large codebase analysis)
+# Cheaper/faster alternatives:
+#   gemini-2.5-flash       — good balance of speed and quality
+#   gemini-2.0-flash       — fast, lower cost
+# Run --list-models to see all available models for your key.
+# GEMINI_MODEL=gemini-2.5-flash
+
+# GitLab personal access token
+# Create at: https://gitlab.ecoportal.co.nz/-/user_settings/personal_access_tokens
+# Required scopes: read_api
+GITLAB_TOKEN=your-token-here
+GITLAB_URL=https://gitlab.ecoportal.co.nz

data/.gitattributes

@@ -0,0 +1,15 @@
+# Normalize all text files to LF in git and on checkout.
+# Claude Code writes LF; this prevents git from converting or warning.
+* text=auto eol=lf
+
+# Windows-only executables that genuinely need CRLF
+*.bat  text eol=crlf
+*.cmd  text eol=crlf
+*.ps1  text eol=crlf
+
+# Binary files — never touch line endings
+*.png  binary
+*.jpg  binary
+*.pdf  binary
+*.docx binary
+*.gem  binary

data/.gitignore

@@ -2,6 +2,7 @@
 Gemfile.lock
 
 .env
+.ai-assistance/local_paths.md
 # build artifacts
 *.gem
 /.bundle/
@@ -22,3 +23,15 @@ 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/.rubocop.yml

@@ -1,97 +1,121 @@
-AllCops:
-  TargetRubyVersion: 3.2
-  Exclude:
-    - 'config/routes.rb'
-  NewCops: enable
-
-Metrics/ClassLength:
-  Max: 350
-Metrics/ModuleLength:
-  Max: 400
-Metrics/MethodLength:
-  Max: 100
-Metrics/BlockLength:
-  CountAsOne: ['array', 'heredoc', 'method_call']
-  Max: 50
-Metrics/AbcSize:
-  Max: 30
-Metrics/ParameterLists:
-  Max: 5
-  CountKeywordArgs: false
-Metrics/CyclomaticComplexity:
-  Max: 30
-Metrics/PerceivedComplexity:
-  Max: 30
-
-Layout/HashAlignment:
-  EnforcedColonStyle: table
-  EnforcedHashRocketStyle: table
-
-Style/BlockDelimiters:
-  BracesRequiredMethods: ['log']
-  AllowedMethods: ['proc', 'new']
-  Enabled: false
-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/Documentation:
-  Enabled: false
-Style/CommentedKeyword:
-  Enabled: false
-Layout/LeadingCommentSpace:
-  Enabled: false
-  AllowGemfileRubyComment: true
-Style/MultilineBlockChain:
-  Enabled: false
-Style/StringLiteralsInInterpolation:
-  Enabled: false
-Style/AndOr:
-  Enabled: false
-Style/Alias:
-  EnforcedStyle: prefer_alias_method
-Style/FetchEnvVar:
-  Enabled: false
-Style/RegexpLiteral:
-  EnforcedStyle: mixed
-  AllowInnerSlashes: true
-
-Layout/LineLength:
-  Enabled: false
-Layout/SpaceInsideHashLiteralBraces:
-  Enabled: false
-Layout/SpaceInsideBlockBraces:
-  Enabled: false
-Layout/SpaceAroundOperators:
-  Enabled: false
-Layout/ExtraSpacing:
-  AllowForAlignment: 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']
-Naming/RescuedExceptionsVariableName:
-  Enabled: false
-Naming/MethodName:
-  Enabled: false
-Naming/BlockForwarding:
-  Enabled: false
+AllCops:
+  TargetRubyVersion: 3.2
+  Exclude:
+    - 'config/routes.rb'
+  NewCops: enable
+
+Metrics/ClassLength:
+  Max: 350
+Metrics/ModuleLength:
+  Max: 400
+Metrics/MethodLength:
+  Max: 100
+Metrics/BlockLength:
+  CountAsOne: ['array', 'heredoc', 'method_call']
+  Max: 50
+Metrics/AbcSize:
+  Max: 30
+Metrics/ParameterLists:
+  Max: 5
+  CountKeywordArgs: false
+Metrics/CyclomaticComplexity:
+  Max: 30
+Metrics/PerceivedComplexity:
+  Max: 30
+
+Layout/HashAlignment:
+  EnforcedColonStyle: table
+  EnforcedHashRocketStyle: table
+
+Style/BlockDelimiters:
+  BracesRequiredMethods: ['log']
+  AllowedMethods: ['proc', 'new']
+  Enabled: false
+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/Documentation:
+  Enabled: false
+Style/CommentedKeyword:
+  Enabled: false
+Layout/LeadingCommentSpace:
+  Enabled: false
+  AllowGemfileRubyComment: true
+Style/MultilineBlockChain:
+  Enabled: false
+Style/StringLiteralsInInterpolation:
+  Enabled: false
+Style/AndOr:
+  Enabled: false
+Style/Alias:
+  EnforcedStyle: prefer_alias_method
+Style/FetchEnvVar:
+  Enabled: false
+Style/RegexpLiteral:
+  EnforcedStyle: mixed
+  AllowInnerSlashes: true
+
+Layout/LineLength:
+  Enabled: false
+Layout/SpaceInsideHashLiteralBraces:
+  Enabled: false
+Layout/SpaceInsideBlockBraces:
+  Enabled: false
+Layout/SpaceAroundOperators:
+  Enabled: false
+Layout/ExtraSpacing:
+  AllowForAlignment: true
+Layout/AccessModifierIndentation:
+  EnforcedStyle: indent
+Layout/DotPosition:
+  EnforcedStyle: trailing
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+Layout/FirstHashElementIndentation:
+  Enabled: false
+Layout/EmptyLineAfterGuardClause:
+  Enabled: false
+Layout/EndOfLine:
+  Enabled: false
+
+Naming/VariableNumber:
+  EnforcedStyle: snake_case
+  CheckSymbols: false
+Naming/MethodParameterName:
+  # id/ids are standard entity identifiers; clientMutationId is the canonical
+  # GraphQL/Relay mutation field name (camelCase by design — see Naming/MethodName).
+  AllowedNames: ['x', 'y', 'i', 'j', 'id', 'ids', 'clientMutationId']
+Naming/VariableName:
+  # clientMutationId mirrors the GraphQL schema field name verbatim.
+  AllowedIdentifiers: ['clientMutationId']
+Naming/RescuedExceptionsVariableName:
+  Enabled: false
+Naming/MethodName:
+  Enabled: false
+Naming/BlockForwarding:
+  Enabled: false
+
+# fragment.rb intentionally defines a top-level `Fragment` namespace (for client
+# scripts) alongside the gem's `Ecoportal::API::GraphQL::Fragment`.
+Style/OneClassPerFile:
+  Exclude:
+    - 'lib/ecoportal/api/graphql/fragment.rb'
+
+# Gem entry point mirrors the hyphenated gem name `ecoportal-api-graphql`.
+Naming/FileName:
+  Exclude:
+    - 'lib/ecoportal/api-graphql.rb'
+
+# QueryArray#each intentionally re-enters the enumerator with connection_block,
+# not the verbatim method arguments.
+Lint/ToEnumArguments:
+  Exclude:
+    - 'lib/ecoportal/api/graphql/logic/query_array.rb'