collavre_linear 0.1.0

data/db/migrate/20260701000006_add_lookup_indexes_to_linear_project_links.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Inbound webhooks resolve the ProjectLink by team_id and by linear_project_id
+# on every delivery. The pre-existing composite [creative_id, linear_project_id]
+# index can't serve a team_id lookup and doesn't lead with linear_project_id, so
+# both hot-path lookups full-scanned. Add covering single-column indexes.
+class AddLookupIndexesToLinearProjectLinks < ActiveRecord::Migration[8.0]
+  def change
+    add_index :linear_project_links, :team_id
+    # UNIQUE: one Linear project maps to exactly one Collavre root. Inbound
+    # webhooks resolve the project via an unscoped find_by(linear_project_id:),
+    # so a second link on a disjoint creative would route imports to whichever
+    # row the DB returns. The controller's check-then-save can't stop two
+    # concurrent link requests from both inserting; enforce it at the DB layer.
+    add_index :linear_project_links, :linear_project_id, unique: true
+  end
+end

data/db/migrate/20260701000007_enforce_one_project_link_per_creative.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# One Collavre root maps to exactly one Linear project. The controller's
+# origin_conflict check is check-then-save, so two concurrent link requests for
+# the SAME root to DIFFERENT projects can both pass it and insert — the existing
+# unique indexes don't stop it: linear_project_id is unique per project (not per
+# root) and the composite [creative_id, linear_project_id] permits two different
+# projects on one creative. resolve_project_link then does find_by(creative_id:)
+# and would sync against an arbitrary project. Enforce the invariant at the DB
+# layer: promote the creative_id index to UNIQUE (which subsumes and replaces the
+# now-redundant composite).
+class EnforceOneProjectLinkPerCreative < ActiveRecord::Migration[8.0]
+  def change
+    remove_index :linear_project_links,
+                 name: "index_linear_project_links_on_creative_and_project"
+    remove_index :linear_project_links, :creative_id
+    add_index :linear_project_links, :creative_id, unique: true
+  end
+end

data/db/migrate/20260701000008_allow_null_webhook_secret_on_linear_project_links.rb

@@ -0,0 +1,8 @@
+class AllowNullWebhookSecretOnLinearProjectLinks < ActiveRecord::Migration[8.0]
+  # Linear generates the webhook signing secret when the webhook is created and
+  # won't let us pick it, so a ProjectLink is created without one and the admin
+  # pastes Linear's value in afterward. Relax the original NOT NULL accordingly.
+  def change
+    change_column_null :linear_project_links, :webhook_secret, true
+  end
+end

data/lib/collavre_linear/engine.rb

@@ -0,0 +1,122 @@
+module CollavreLinear
+  class Engine < ::Rails::Engine
+    isolate_namespace CollavreLinear
+
+    # Path this engine is mounted at in the host app (see the
+    # `collavre_linear.routes` initializer below). Because the engine is
+    # `isolate_namespace`d and detached, its own `url_helpers` generate
+    # engine-internal paths WITHOUT this prefix. Anything that needs a URL the
+    # host (or an external service like Linear) will actually reach must fold
+    # this prefix back in — pass it as `script_name:` to the engine url_helper.
+    MOUNT_PATH = "/linear"
+
+    config.generators do |g|
+      g.test_framework :minitest
+    end
+
+    def self.javascript_path
+      root.join("app/javascript")
+    end
+
+    def self.stylesheet_path
+      root.join("app/assets/stylesheets")
+    end
+
+    config.i18n.load_path += Dir[root.join("config", "locales", "*.yml")]
+
+    initializer "collavre_linear.routes", before: :add_routing_paths do |app|
+      app.routes.append do
+        mount CollavreLinear::Engine => CollavreLinear::Engine::MOUNT_PATH, as: :linear_engine
+      end
+    end
+
+    initializer "collavre_linear.assets" do |app|
+      if app.config.respond_to?(:assets) && app.config.assets.respond_to?(:paths)
+        app.config.assets.paths << root.join("app/assets/stylesheets")
+      end
+    end
+
+    initializer "collavre_linear.migrations" do |app|
+      unless app.root.to_s.match?(root.to_s)
+        config.paths["db/migrate"].expanded.each do |expanded_path|
+          app.config.paths["db/migrate"] << expanded_path
+        end
+      end
+    end
+
+    initializer "collavre_linear.register_integration", after: :load_config_initializers do
+      Rails.application.config.to_prepare do
+        if defined?(Collavre::IntegrationRegistry)
+          Collavre::IntegrationRegistry.register(:linear, {
+            label: I18n.t("collavre_linear.integration.label", default: "Linear"),
+            icon: "linear",
+            description: I18n.t("collavre_linear.integration.description", default: "Two-way sync of projects, issues and comments"),
+            routes: CollavreLinear::Engine.routes.url_helpers,
+            creative_menu_partial: "collavre_linear/integrations/modal"
+          })
+        end
+      end
+    end
+
+    initializer "collavre_linear.user_associations", after: :load_config_initializers do
+      Rails.application.config.to_prepare do
+        user_class = Collavre.user_class rescue nil
+        next unless user_class
+
+        unless user_class.reflect_on_association(:linear_account)
+          user_class.has_one :linear_account,
+                             class_name: "CollavreLinear::Account",
+                             foreign_key: :user_id,
+                             dependent: :destroy
+        end
+      end
+    end
+
+    initializer "collavre_linear.creative_associations", after: :load_config_initializers do
+      Rails.application.config.to_prepare do
+        creative_class = Collavre::Creative rescue nil
+        next unless creative_class
+
+        unless creative_class.reflect_on_association(:linear_project_links)
+          creative_class.has_many :linear_project_links,
+                                  class_name: "CollavreLinear::ProjectLink",
+                                  foreign_key: :creative_id,
+                                  dependent: :destroy
+        end
+
+        unless creative_class.reflect_on_association(:linear_issue_links)
+          creative_class.has_many :linear_issue_links,
+                                  class_name: "CollavreLinear::IssueLink",
+                                  foreign_key: :creative_id,
+                                  dependent: :destroy
+        end
+
+        if creative_class.respond_to?(:register_reserved_metadata_key)
+          creative_class.register_reserved_metadata_key("linear")
+        end
+      end
+    end
+
+    initializer "collavre_linear.creative_sync_observer", after: :load_config_initializers do
+      Rails.application.config.to_prepare do
+        creative_class = Collavre::Creative rescue nil
+        next unless creative_class
+
+        unless creative_class.include?(CollavreLinear::CreativeSyncObserver)
+          creative_class.include CollavreLinear::CreativeSyncObserver
+        end
+      end
+    end
+
+    initializer "collavre_linear.comment_sync_observer", after: :load_config_initializers do
+      Rails.application.config.to_prepare do
+        comment_class = Collavre::Comment rescue nil
+        next unless comment_class
+
+        unless comment_class.include?(CollavreLinear::CommentSyncObserver)
+          comment_class.include CollavreLinear::CommentSyncObserver
+        end
+      end
+    end
+  end
+end

data/lib/collavre_linear/version.rb

@@ -0,0 +1,3 @@
+module CollavreLinear
+  VERSION = "0.1.0"
+end

data/lib/collavre_linear.rb

@@ -0,0 +1,5 @@
+require "collavre_linear/version"
+require "collavre_linear/engine"
+
+module CollavreLinear
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: collavre_linear
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Collavre
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: collavre
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Plugin engine to connect Collavre creatives with Linear projects, issues
+  and comments.
+email:
+- support@collavre.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- app/controllers/collavre_linear/application_controller.rb
+- app/controllers/collavre_linear/auth_controller.rb
+- app/controllers/collavre_linear/creatives/integrations_controller.rb
+- app/controllers/collavre_linear/webhooks_controller.rb
+- app/javascript/collavre_linear.js
+- app/jobs/collavre_linear/inbound_apply_job.rb
+- app/jobs/collavre_linear/outbound_archive_job.rb
+- app/jobs/collavre_linear/outbound_comment_delete_job.rb
+- app/jobs/collavre_linear/outbound_comment_sync_job.rb
+- app/jobs/collavre_linear/outbound_comment_update_job.rb
+- app/jobs/collavre_linear/outbound_sync_job.rb
+- app/models/collavre_linear/account.rb
+- app/models/collavre_linear/application_record.rb
+- app/models/collavre_linear/comment_link.rb
+- app/models/collavre_linear/issue_link.rb
+- app/models/collavre_linear/project_link.rb
+- app/observers/collavre_linear/comment_sync_observer.rb
+- app/observers/collavre_linear/creative_sync_observer.rb
+- app/services/collavre_linear/client.rb
+- app/services/collavre_linear/comment_formatter.rb
+- app/services/collavre_linear/comment_syncability.rb
+- app/services/collavre_linear/creative_exporter.rb
+- app/services/collavre_linear/echo_guard.rb
+- app/services/collavre_linear/field_mapper.rb
+- app/services/collavre_linear/inbound_applier.rb
+- app/services/collavre_linear/o_auth_token_service.rb
+- app/views/collavre_linear/auth/setup.html.erb
+- app/views/collavre_linear/integrations/_modal.html.erb
+- config/initializers/integration_settings.rb
+- config/locales/en.yml
+- config/locales/ko.yml
+- config/routes.rb
+- db/migrate/20260701000000_create_linear_accounts.rb
+- db/migrate/20260701000001_create_collavre_linear_project_links.rb
+- db/migrate/20260701000002_create_collavre_linear_issue_links.rb
+- db/migrate/20260701000003_create_collavre_linear_comment_links.rb
+- db/migrate/20260701000004_add_last_outbound_at_to_linear_links.rb
+- db/migrate/20260701000005_add_webhook_id_to_linear_project_links.rb
+- db/migrate/20260701000006_add_lookup_indexes_to_linear_project_links.rb
+- db/migrate/20260701000007_enforce_one_project_link_per_creative.rb
+- db/migrate/20260701000008_allow_null_webhook_secret_on_linear_project_links.rb
+- lib/collavre_linear.rb
+- lib/collavre_linear/engine.rb
+- lib/collavre_linear/version.rb
+homepage: https://collavre.com
+licenses:
+- AGPL
+metadata:
+  homepage_uri: https://collavre.com
+  source_code_uri: https://github.com/sh1nj1/plan42
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Linear integration for Collavre
+test_files: []