lex-aha 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4edcbc42b570b10bda7fa2491a1ec5086d3952c26849607f282ef1494aaf40f6
+  data.tar.gz: 5b1da0f466468dee0781f175f076784fa9eb1409cd25569e564fce5dee62c72d
+SHA512:
+  metadata.gz: b5e74963b6182b339137cb5d6d3b8e87c39583900ce1c2ad3409a2036b5a1e935ac7c44e0f40f0caaef8645678b1fde17f540fa9dd6acc03f7c9986aa683f723
+  data.tar.gz: 5a7ef453860736c3477a0de40c8be57c2c68648cbcba2b427dc21605f0479512e5fec9bf740f46505e8863690667f839b614e1c6d147cb57385ced8d8495676c

data/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ci:
+    uses: LegionIO/.github/.github/workflows/ci.yml@main
+
+  release:
+    needs: ci
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    uses: LegionIO/.github/.github/workflows/release.yml@main
+    secrets:
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+Gemfile.lock
+
+# rspec failure tracking
+.rspec_status

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,66 @@
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+
+Layout/LineLength:
+  Max: 160
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: space
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
+Metrics/MethodLength:
+  Max: 50
+
+Metrics/ClassLength:
+  Max: 1500
+
+Metrics/ModuleLength:
+  Max: 1500
+
+Metrics/BlockLength:
+  Max: 40
+  Exclude:
+    - 'spec/**/*'
+
+Metrics/AbcSize:
+  Max: 60
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/PerceivedComplexity:
+  Max: 17
+
+Metrics/ParameterLists:
+  Max: 10
+
+Style/Documentation:
+  Enabled: false
+
+Style/SymbolArray:
+  Enabled: true
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+Naming/FileName:
+  Enabled: false
+
+Naming/PredicateMethod:
+  Enabled: false
+
+Naming/PredicatePrefix:
+  Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+Lint/EmptyClass:
+  Exclude:
+    - 'spec/**/*'

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## [0.1.0] - 2026-04-02
+
+### Added
+
+- Initial release with 4 sub-modules: Roadmaps, Ideas, Knowledge, Core
+- 39 runner modules covering 198 Aha! API v1 endpoints
+- Shared Helpers::Client with Bearer token auth and subdomain-based URL
+- BaseClient for sub-module client inheritance
+- Standalone Client classes for each sub-module
+- Full RSpec test suite

data/CLAUDE.md

@@ -0,0 +1,88 @@
+# lex-aha: Aha! Integration for LegionIO
+
+**Repository Level 3 Documentation**
+- **Category**: `/Users/miverso2/rubymine/legion/extensions-other/CLAUDE.md`
+
+## Purpose
+
+Legion Extension that connects LegionIO to the Aha! product management platform. Monolith-style extension with 4 sub-modules covering 198 API endpoints across 39 runners.
+
+**GitHub**: https://github.com/LegionIO/lex-aha
+**License**: MIT
+
+## Architecture
+
+```
+Legion::Extensions::Aha
+├── Helpers::Client              # Shared Faraday connection (Bearer auth, subdomain-based URL)
+├── BaseClient                   # Shared base class for sub-module clients
+├── Roadmaps/                    # Aha! Roadmaps product
+│   ├── Runners::Products        # Product CRUD
+│   ├── Runners::Releases        # Release management + phases + roll-ups
+│   ├── Runners::Features        # Feature CRUD + convert to epic
+│   ├── Runners::Epics           # Epic CRUD
+│   ├── Runners::Requirements    # Requirement CRUD + convert to feature
+│   ├── Runners::Initiatives     # Initiative CRUD
+│   ├── Runners::Goals           # Goal CRUD
+│   ├── Runners::KeyResults      # Key result CRUD
+│   ├── Runners::Strategy        # Strategic models, positionings, visions
+│   ├── Runners::Competitors     # Competitor analysis
+│   ├── Runners::Personas        # Product personas
+│   ├── Runners::Capacity        # Capacity planning (scenarios, investments, estimates)
+│   └── Client                   # Standalone Roadmaps client (< BaseClient)
+├── Ideas/                       # Aha! Ideas product
+│   ├── Runners::Ideas           # Idea CRUD + promote + related
+│   ├── Runners::IdeaComments    # Portal-visible comments
+│   ├── Runners::IdeaPortals     # Portal configuration
+│   ├── Runners::IdeaOrganizations # Organization management
+│   ├── Runners::IdeaUsers       # Idea portal users
+│   ├── Runners::IdeaVotes       # Endorsements/votes
+│   ├── Runners::IdeaSubscriptions # Subscription management
+│   ├── Runners::IdeaCategories  # Category listing
+│   └── Client                   # Standalone Ideas client (< BaseClient)
+├── Knowledge/                   # Aha! Knowledge product
+│   ├── Runners::KnowledgeBases  # Knowledge base listing
+│   ├── Runners::Pages           # Knowledge base page CRUD
+│   ├── Runners::Notes           # Product note CRUD
+│   └── Client                   # Standalone Knowledge client (< BaseClient)
+└── Core/                        # Cross-product resources
+    ├── Runners::Users           # User management + product roles
+    ├── Runners::Teams           # Team CRUD + memberships
+    ├── Runners::Me              # Current user profile + assigned records
+    ├── Runners::Comments        # Comments on any record type
+    ├── Runners::Attachments     # Attachment management
+    ├── Runners::Todos           # To-do/task management
+    ├── Runners::RecordLinks     # Cross-record linking
+    ├── Runners::CustomFields    # Custom field definitions + options + layouts
+    ├── Runners::CustomTableRecords # Custom table record CRUD
+    ├── Runners::Integrations    # Integration management
+    ├── Runners::Workflows       # Workflow listing
+    ├── Runners::Audits          # Audit trail + historical search
+    ├── Runners::Webhooks        # Webhook validation
+    ├── Runners::Admin           # Account backups, deletions, identity providers, paid seats, schedules
+    └── Client                   # Standalone Core client (< BaseClient)
+```
+
+## Authentication
+
+- Bearer token via `Authorization` header
+- Base URL: `https://{subdomain}.aha.io/api/v1`
+- API keys generated at `https://secure.aha.io/settings/api_keys`
+
+## Dependencies
+
+| Gem | Purpose |
+|-----|---------|
+| `faraday` >= 2.0 | HTTP client for Aha! REST API |
+
+## Testing
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

data/Dockerfile

@@ -0,0 +1,6 @@
+FROM legionio/legion
+
+COPY . /usr/src/app/lex-aha
+
+WORKDIR /usr/src/app/lex-aha
+RUN bundle install

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+gemspec
+
+group :test do
+  gem 'rake'
+  gem 'rspec'
+  gem 'rspec_junit_formatter'
+  gem 'rubocop'
+  gem 'simplecov'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Esity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,62 @@
+# lex-aha
+
+Aha! product management integration for [LegionIO](https://github.com/LegionIO/LegionIO). Provides runners for the full Aha! REST API v1 across four sub-modules matching Aha! product lines.
+
+## Installation
+
+```bash
+gem install lex-aha
+```
+
+## Sub-modules
+
+### Roadmaps (`Legion::Extensions::Aha::Roadmaps::Client`)
+
+Products, Releases, Release Phases, Roll-up Releases, Features, Epics, Requirements, Initiatives, Goals, Key Results, Strategy, Competitors, Personas, Capacity
+
+### Ideas (`Legion::Extensions::Aha::Ideas::Client`)
+
+Ideas, Idea Comments, Idea Portals, Idea Organizations, Idea Users, Idea Votes, Idea Subscriptions, Idea Categories
+
+### Knowledge (`Legion::Extensions::Aha::Knowledge::Client`)
+
+Knowledge Bases, Pages, Notes
+
+### Core (`Legion::Extensions::Aha::Core::Client`)
+
+Users, Teams, Me, Comments, Attachments, To-dos, Record Links, Custom Fields, Custom Table Records, Integrations, Workflows, Audits, Webhooks, Admin
+
+## Standalone Usage
+
+```ruby
+require 'legion/extensions/aha'
+
+roadmaps = Legion::Extensions::Aha::Roadmaps::Client.new(
+  subdomain: 'yourcompany',
+  api_key: 'your-api-key'
+)
+
+products = roadmaps.list_products
+features = roadmaps.list_features_in_product(product_id: 'PROD-1')
+
+ideas = Legion::Extensions::Aha::Ideas::Client.new(
+  subdomain: 'yourcompany',
+  api_key: 'your-api-key'
+)
+
+all_ideas = ideas.list_ideas
+```
+
+## Authentication
+
+Aha! supports Bearer token authentication. Generate API keys at `https://secure.aha.io/settings/api_keys`.
+
+## Requirements
+
+- Ruby >= 3.4
+- [LegionIO](https://github.com/LegionIO/LegionIO) framework (optional, for runner/actor integration)
+- Aha! account with API access
+
+## License
+
+MIT

data/lex-aha.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative 'lib/legion/extensions/aha/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-aha'
+  spec.version       = Legion::Extensions::Aha::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'LEX Aha'
+  spec.description   = 'Connects LegionIO to the Aha! product management platform'
+  spec.homepage      = 'https://github.com/LegionIO/lex-aha'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/LegionIO/lex-aha'
+  spec.metadata['documentation_uri'] = 'https://github.com/LegionIO/lex-aha'
+  spec.metadata['changelog_uri'] = 'https://github.com/LegionIO/lex-aha/blob/main/CHANGELOG.md'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/LegionIO/lex-aha/issues'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday', '>= 2.0'
+end

data/lib/legion/extensions/aha/base_client.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'helpers/client'
+
+module Legion
+  module Extensions
+    module Aha
+      class BaseClient
+        include Helpers::Client
+
+        attr_reader :opts
+
+        def initialize(subdomain:, api_key:, **)
+          @opts = { subdomain: subdomain, api_key: api_key }.compact
+        end
+
+        def client(**override)
+          super(**@opts, **override)
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/aha/core/client.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative '../base_client'
+require_relative 'runners/users'
+require_relative 'runners/teams'
+require_relative 'runners/me'
+require_relative 'runners/comments'
+require_relative 'runners/attachments'
+require_relative 'runners/todos'
+require_relative 'runners/record_links'
+require_relative 'runners/custom_fields'
+require_relative 'runners/custom_table_records'
+require_relative 'runners/integrations'
+require_relative 'runners/workflows'
+require_relative 'runners/audits'
+require_relative 'runners/webhooks'
+require_relative 'runners/admin'
+
+module Legion
+  module Extensions
+    module Aha
+      module Core
+        class Client < Legion::Extensions::Aha::BaseClient
+          include Runners::Users
+          include Runners::Teams
+          include Runners::Me
+          include Runners::Comments
+          include Runners::Attachments
+          include Runners::Todos
+          include Runners::RecordLinks
+          include Runners::CustomFields
+          include Runners::CustomTableRecords
+          include Runners::Integrations
+          include Runners::Workflows
+          include Runners::Audits
+          include Runners::Webhooks
+          include Runners::Admin
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/aha/core/runners/admin.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/aha/helpers/client'
+
+module Legion
+  module Extensions
+    module Aha
+      module Core
+        module Runners
+          module Admin
+            extend Legion::Extensions::Aha::Helpers::Client
+
+            def list_account_backups(**)
+              response = client(**).get('/account_backups')
+              { result: response.body, status: response.status }
+            end
+
+            def create_account_backup(**)
+              response = client(**).post('/account_backups')
+              { result: response.body, status: response.status }
+            end
+
+            def get_account_backup(id:, **)
+              response = client(**).get("/account_backups/#{id}")
+              { result: response.body, status: response.status }
+            end
+
+            def list_deletions(**)
+              response = client(**).get('/deletions')
+              { result: response.body, status: response.status }
+            end
+
+            def restore_deletion(id:, **)
+              response = client(**).post("/deletions/#{id}/restore")
+              { result: response.body, status: response.status }
+            end
+
+            def list_identity_providers(**)
+              response = client(**).get('/identity_providers')
+              { result: response.body, status: response.status }
+            end
+
+            def get_identity_provider(id:, **)
+              response = client(**).get("/identity_providers/#{id}")
+              { result: response.body, status: response.status }
+            end
+
+            def list_paid_seat_groups(**)
+              response = client(**).get('/paid_seat_groups')
+              { result: response.body, status: response.status }
+            end
+
+            def list_schedules(**)
+              response = client(**).get('/schedules')
+              { result: response.body, status: response.status }
+            end
+
+            include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                        Legion::Extensions::Helpers.const_defined?(:Lex)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/aha/core/runners/attachments.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/aha/helpers/client'
+
+module Legion
+  module Extensions
+    module Aha
+      module Core
+        module Runners
+          module Attachments
+            extend Legion::Extensions::Aha::Helpers::Client
+
+            def create_attachment_on_comment(comment_id:, attachment:, **)
+              response = client(**).post("/comments/#{comment_id}/attachments") do |req|
+                req.body = attachment
+              end
+              { result: response.body, status: response.status }
+            end
+
+            def create_attachment_on_note(note_id:, attachment:, **)
+              response = client(**).post("/notes/#{note_id}/attachments") do |req|
+                req.body = attachment
+              end
+              { result: response.body, status: response.status }
+            end
+
+            def delete_attachment(attachment_id:, **)
+              response = client(**).delete("/attachments/#{attachment_id}")
+              { result: response.body, status: response.status }
+            end
+
+            include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                        Legion::Extensions::Helpers.const_defined?(:Lex)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/aha/core/runners/audits.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/aha/helpers/client'
+
+module Legion
+  module Extensions
+    module Aha
+      module Core
+        module Runners
+          module Audits
+            extend Legion::Extensions::Aha::Helpers::Client
+
+            def list_audits(**)
+              response = client(**).get('/audits')
+              { result: response.body, status: response.status }
+            end
+
+            def list_historical_audits(**)
+              response = client(**).get('/historical_audits')
+              { result: response.body, status: response.status }
+            end
+
+            def create_historical_audit_search(historical_audit:, **)
+              response = client(**).post('/historical_audits') do |req|
+                req.body = { historical_audit: historical_audit }
+              end
+              { result: response.body, status: response.status }
+            end
+
+            include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                        Legion::Extensions::Helpers.const_defined?(:Lex)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/aha/core/runners/comments.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/aha/helpers/client'
+
+module Legion
+  module Extensions
+    module Aha
+      module Core
+        module Runners
+          module Comments
+            extend Legion::Extensions::Aha::Helpers::Client
+
+            def list_comments_on_feature(feature_id:, **)
+              response = client(**).get("/features/#{feature_id}/comments")
+              { result: response.body, status: response.status }
+            end
+
+            def create_comment_on_feature(feature_id:, comment:, **)
+              response = client(**).post("/features/#{feature_id}/comments") do |req|
+                req.body = { comment: comment }
+              end
+              { result: response.body, status: response.status }
+            end
+
+            def list_comments_on_idea(idea_id:, **)
+              response = client(**).get("/ideas/#{idea_id}/comments")
+              { result: response.body, status: response.status }
+            end
+
+            def create_comment_on_idea(idea_id:, comment:, **)
+              response = client(**).post("/ideas/#{idea_id}/comments") do |req|
+                req.body = { comment: comment }
+              end
+              { result: response.body, status: response.status }
+            end
+
+            def list_comments_in_product(product_id:, **)
+              response = client(**).get("/products/#{product_id}/comments")
+              { result: response.body, status: response.status }
+            end
+
+            def get_comment(id:, **)
+              response = client(**).get("/comments/#{id}")
+              { result: response.body, status: response.status }
+            end
+
+            def update_comment(id:, comment:, **)
+              response = client(**).put("/comments/#{id}") do |req|
+                req.body = { comment: comment }
+              end
+              { result: response.body, status: response.status }
+            end
+
+            def delete_comment(id:, **)
+              response = client(**).delete("/comments/#{id}")
+              { result: response.body, status: response.status }
+            end
+
+            include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
+                                                        Legion::Extensions::Helpers.const_defined?(:Lex)
+          end
+        end
+      end
+    end
+  end
+end