collavre_github 0.2.0

data/app/services/collavre_github/webhook_provisioner.rb

@@ -0,0 +1,128 @@
+module CollavreGithub
+  class WebhookProvisioner
+    EVENTS = %w[pull_request].freeze
+    CONTENT_TYPE = "json".freeze
+
+    def self.ensure_for_links(account:, links:, webhook_url:)
+      new(account: account, webhook_url: webhook_url).ensure_for_links(Array(links))
+    end
+
+    def self.remove_for_repositories(account:, repositories:, webhook_url:)
+      new(account: account, webhook_url: webhook_url).remove_for_repositories(Array(repositories))
+    end
+
+    def initialize(account:, webhook_url:, client: CollavreGithub::Client.new(account))
+      @client = client
+      @webhook_url = webhook_url
+    end
+
+    def ensure_for_links(links)
+      links.each do |link|
+        ensure_webhook(link)
+      end
+    end
+
+    def remove_for_repositories(repositories)
+      repositories.each do |repository_full_name|
+        next if CollavreGithub::RepositoryLink.where(repository_full_name: repository_full_name).exists?
+
+        remove_webhook(repository_full_name)
+      end
+    end
+
+    private
+
+    attr_reader :client, :webhook_url
+
+    def ensure_webhook(link)
+      repository_full_name = link.repository_full_name
+      primary_link = primary_link_for(repository_full_name)
+      hook = find_existing_hook(repository_full_name)
+
+      if hook
+        if primary_link && primary_link != link
+          align_link_secret(link, primary_link.webhook_secret)
+        else
+          update_webhook(repository_full_name, hook.id, link.webhook_secret)
+        end
+      else
+        secret = link.webhook_secret
+
+        if primary_link && primary_link != link
+          secret = primary_link.webhook_secret
+          align_link_secret(link, secret)
+        end
+
+        create_webhook(repository_full_name, secret)
+      end
+    rescue Octokit::Error => e
+      Rails.logger.warn(
+        "GitHub webhook provisioning failed for #{repository_full_name}: #{e.message}"
+      )
+    end
+
+    def remove_webhook(repository_full_name)
+      hook = find_existing_hook(repository_full_name)
+      return unless hook
+
+      client.delete_repository_webhook(repository_full_name, hook.id)
+    rescue Octokit::Error => e
+      Rails.logger.warn(
+        "GitHub webhook removal failed for #{repository_full_name}: #{e.message}"
+      )
+    end
+
+    def find_existing_hook(repository_full_name)
+      client.repository_hooks(repository_full_name).find do |hook|
+        config = normalize_config(hook.config)
+        config["url"] == webhook_url
+      end
+    end
+
+    def create_webhook(repository_full_name, secret)
+      client.create_repository_webhook(
+        repository_full_name,
+        url: webhook_url,
+        secret: secret,
+        events: EVENTS,
+        content_type: CONTENT_TYPE
+      )
+    end
+
+    def update_webhook(repository_full_name, hook_id, secret)
+      client.update_repository_webhook(
+        repository_full_name,
+        hook_id,
+        url: webhook_url,
+        secret: secret,
+        events: EVENTS,
+        content_type: CONTENT_TYPE
+      )
+    end
+
+    def primary_link_for(repository_full_name)
+      CollavreGithub::RepositoryLink
+        .where(repository_full_name: repository_full_name)
+        .order(:id)
+        .first
+    end
+
+    def align_link_secret(link, secret)
+      return if secret.blank? || link.webhook_secret == secret
+
+      link.update!(webhook_secret: secret)
+    end
+
+    def normalize_config(config)
+      hash =
+        case config
+        when Hash
+          config
+        else
+          config.respond_to?(:to_h) ? config.to_h : {}
+        end
+
+      hash.with_indifferent_access
+    end
+  end
+end

data/app/views/collavre_github/integrations/_modal.html.erb

@@ -0,0 +1,77 @@
+<div id="github-integration-modal"
+     data-success-message="<%= t('collavre_github.integration.saved', default: 'Github integration saved successfully.') %>"
+     data-login-required="<%= t('collavre_github.integration.login_required', default: 'Sign in with your Github account to start the integration.') %>"
+     data-no-creative="<%= t('collavre_github.integration.missing_creative', default: 'No Creative selected for integration.') %>"
+     data-webhook-url-label="<%= t('collavre_github.integration.webhook_url_label', default: 'Webhook URL') %>"
+     data-webhook-secret-label="<%= t('collavre_github.integration.webhook_secret_label', default: 'Webhook secret') %>"
+     data-existing-message="<%= t('collavre_github.integration.existing_message', default: 'You\'re already connected to the repositories below.') %>"
+     data-delete-confirm="<%= t('collavre_github.integration.delete_confirm', default: 'Do you want to remove the Github integration?') %>"
+     data-delete-success="<%= t('collavre_github.integration.delete_success', default: 'Github integration removed successfully.') %>"
+     data-delete-error="<%= t('collavre_github.integration.delete_error', default: 'Failed to remove the Github integration.') %>"
+     data-delete-button-label="<%= t('collavre_github.integration.delete_button', default: 'Remove integration') %>"
+     data-delete-select-warning="<%= t('collavre_github.integration.delete_select_warning', default: 'Select repositories to delete.') %>"
+     style="display:none;position:fixed;top:0;left:0;width:100vw;height:100vh;z-index:10000;align-items:center;justify-content:center;">
+  <div class="popup-box" style="min-width:360px;max-width:90vw;">
+    <button type="button" id="close-github-modal" class="popup-close-btn">&times;</button>
+    <h2><%= t('collavre_github.integration.title', default: 'Configure Github integration') %></h2>
+    <p id="github-integration-status" class="github-modal-status"></p>
+
+    <div class="github-wizard-step" id="github-step-connect">
+      <p id="github-connect-message" class="github-modal-subtext"><%= t('collavre_github.integration.connect', default: 'Sign in with your Github account to start linking.') %></p>
+      <form id="github-login-form" action="/auth/github" method="post" target="github-auth-window" style="display:none;">
+        <input type="hidden" name="authenticity_token" value="<%= form_authenticity_token %>">
+      </form>
+      <button type="button" id="github-login-btn" class="btn btn-primary" data-window-width="620" data-window-height="720">
+        <%= t('collavre_github.integration.login_button', default: 'Sign in with Github') %>
+      </button>
+      <div id="github-existing-connections" style="display:none;margin-top:1.25em;">
+        <p style="margin-bottom:0.5em;"><%= t('collavre_github.integration.existing_intro', default: 'Connected repositories:') %></p>
+        <ul id="github-existing-repo-list" style="padding-left:1.2em;margin-bottom:0.75em;color:var(--color-text);"></ul>
+        <button type="button" id="github-delete-btn" class="btn btn-danger" style="display:none;">
+          <%= t('collavre_github.integration.delete_button', default: 'Remove integration') %>
+        </button>
+      </div>
+    </div>
+
+    <div class="github-wizard-step" id="github-step-organization" style="display:none;">
+      <p class="github-modal-subtext"><%= t('collavre_github.integration.choose_org', default: 'Select the organization that owns the repositories.') %></p>
+      <div id="github-organization-list" class="github-list github-modal-list-box" style="max-height:200px;overflow:auto;"></div>
+    </div>
+
+    <div class="github-wizard-step" id="github-step-repositories" style="display:none;">
+      <p class="github-modal-subtext"><%= t('collavre_github.integration.choose_repo', default: 'Select repositories to link. You can choose multiple.') %></p>
+      <div id="github-repository-list" class="github-list github-modal-list-box" style="max-height:240px;overflow:auto;"></div>
+    </div>
+
+    <div class="github-wizard-step" id="github-step-summary" style="display:none;">
+      <p class="github-modal-subtext"><%= t('collavre_github.integration.summary', default: 'The following repositories will be linked to this Creative:') %></p>
+      <p id="github-webhook-instructions" class="github-modal-subtext" style="display:none;margin-bottom:0.5em;"><%= t('collavre_github.integration.webhook_instructions', default: 'Configure each repository with the webhook details below.') %></p>
+      <ul id="github-selected-repos" style="padding-left:1.2em;color:var(--color-text);"></ul>
+      <p id="github-summary-empty" class="github-modal-empty" style="display:none;"><%= t('collavre_github.integration.summary_empty', default: 'No repositories selected.') %></p>
+    </div>
+
+    <div class="github-wizard-step" id="github-step-prompt" style="display:none;">
+      <p class="github-modal-subtext"><%= t('collavre_github.integration.prompt_title', default: 'Review the Gemini analysis prompt and edit it if needed.') %></p>
+      <textarea id="github-gemini-prompt" style="width:100%;min-height:220px;padding:0.75em;border:1px solid var(--color-border);border-radius:4px;font-family:monospace;font-size:0.95em;"></textarea>
+      <p class="github-modal-subtext" style="margin-top:0.75em;font-size:0.9em;">
+        <%= t('collavre_github.integration.prompt_help', default: 'Use the placeholders below to inject runtime details as needed:') %>
+        <code>#{pr_title}</code>,
+        <code>#{pr_body}</code>,
+        <code>#{commit_messages}</code>,
+        <code>#{diff}</code>,
+        <code>#{creative_tree}</code>,
+        <code>#{language_instructions}</code>
+      </p>
+    </div>
+
+    <div id="github-wizard-error" style="display:none;margin:0.5em 0;color:#c0392b;font-weight:bold;"></div>
+
+    <div class="github-wizard-footer" style="display:flex;justify-content:space-between;gap:0.5em;margin-top:1.5em;">
+      <button type="button" id="github-prev-btn" class="btn btn-secondary" style="display:none;"><%= t('app.previous', default: 'Previous') %></button>
+      <div style="margin-left:auto;display:flex;gap:0.5em;">
+        <button type="button" id="github-next-btn" class="btn btn-primary" style="display:none;"><%= t('app.next', default: 'Next') %></button>
+        <button type="button" id="github-finish-btn" class="btn btn-primary" style="display:none;"><%= t('app.finish', default: 'Finish') %></button>
+      </div>
+    </div>
+  </div>
+</div>

data/config/locales/en.yml

@@ -0,0 +1,80 @@
+en:
+  collavre_github:
+    integration:
+      label: "GitHub"
+      description: "Connect repositories and receive webhook events"
+      title: "Configure Github integration"
+      saved: "Github integration saved successfully."
+      login_required: "Sign in with your Github account to start the integration."
+      missing_creative: "No Creative selected for integration."
+      webhook_url_label: "Webhook URL"
+      webhook_secret_label: "Webhook secret"
+      existing_message: "You're already connected to the repositories below."
+      existing_intro: "Connected repositories:"
+      delete_confirm: "Do you want to remove the Github integration?"
+      delete_success: "Github integration removed successfully."
+      delete_error: "Failed to remove the Github integration."
+      delete_button: "Remove integration"
+      delete_select_warning: "Select repositories to delete."
+      connect: "Sign in with your Github account to start linking."
+      login_button: "Sign in with Github"
+      choose_org: "Select the organization that owns the repositories."
+      choose_repo: "Select repositories to link. You can choose multiple."
+      summary: "The following repositories will be linked to this Creative:"
+      webhook_instructions: "Configure each repository with the webhook details below."
+      summary_empty: "No repositories selected."
+      prompt_title: "Review the Gemini analysis prompt and edit it if needed."
+      prompt_help: "Use the placeholders below to inject runtime details as needed:"
+    auth:
+      login_first: "Please log in first to connect your GitHub account"
+      connected: "GitHub account connected successfully"
+    errors:
+      not_connected: "GitHub account not connected"
+      forbidden: "You don't have permission to perform this action"
+      not_found: "Repository not found"
+    webhooks:
+      pull_request:
+        title: "GitHub: Pull Request %{action}"
+        repository: "Repository"
+        pr: "PR"
+        author: "Author"
+        action: "Action"
+        merged: "(merged)"
+        description: "Description"
+      push:
+        title: "GitHub: Push to %{branch}"
+        repository: "Repository"
+        branch: "Branch"
+        pusher: "Pusher"
+        commits: "Commits"
+        recent_commits: "Recent commits"
+        no_message: "(no message)"
+        more: "..."
+      issue:
+        title: "GitHub: Issue %{action}"
+        repository: "Repository"
+        issue: "Issue"
+        author: "Author"
+        action: "Action"
+        description: "Description"
+      issue_comment:
+        title: "GitHub: Comment %{action} on Issue #%{number}"
+        repository: "Repository"
+        issue: "Issue"
+        comment_by: "Comment by"
+        link: "Link"
+        view_comment: "View comment"
+        comment: "Comment"
+      generic:
+        title: "GitHub: %{event}"
+        repository: "Repository"
+        action: "Action"
+        sender: "Sender"
+      actions:
+        opened: "Opened"
+        closed: "Closed"
+        merged: "Merged"
+        reopened: "Reopened"
+        updated: "Updated"
+        ready_for_review: "Ready for Review"
+        event: "Event"

data/config/locales/ko.yml

@@ -0,0 +1,80 @@
+ko:
+  collavre_github:
+    integration:
+      label: "GitHub"
+      description: "저장소를 연결하고 웹훅 이벤트를 받습니다"
+      title: "Github 연동 설정"
+      saved: "Github 연동이 저장되었습니다."
+      login_required: "Github 계정으로 로그인하여 연동을 시작하세요."
+      missing_creative: "연동할 Creative가 선택되지 않았습니다."
+      webhook_url_label: "Webhook URL"
+      webhook_secret_label: "Webhook 시크릿"
+      existing_message: "이미 아래 저장소와 연결되어 있습니다."
+      existing_intro: "연결된 저장소:"
+      delete_confirm: "Github 연동을 삭제하시겠습니까?"
+      delete_success: "Github 연동이 삭제되었습니다."
+      delete_error: "Github 연동 삭제에 실패했습니다."
+      delete_button: "연동 삭제"
+      delete_select_warning: "삭제할 Repository를 선택하세요."
+      connect: "Github 계정으로 로그인하여 연동을 시작하세요."
+      login_button: "Github으로 로그인"
+      choose_org: "저장소가 속한 조직을 선택하세요."
+      choose_repo: "연동할 저장소를 선택하세요. 여러 개 선택 가능합니다."
+      summary: "다음 저장소가 이 Creative에 연동됩니다:"
+      webhook_instructions: "각 저장소에 아래 웹훅 정보를 설정하세요."
+      summary_empty: "선택된 저장소가 없습니다."
+      prompt_title: "Gemini 분석 프롬프트를 검토하고 필요시 수정하세요."
+      prompt_help: "다음 플레이스홀더를 사용하여 런타임 정보를 주입할 수 있습니다:"
+    auth:
+      login_first: "GitHub 계정을 연결하려면 먼저 로그인하세요"
+      connected: "GitHub 계정이 연결되었습니다"
+    errors:
+      not_connected: "GitHub 계정이 연결되지 않았습니다"
+      forbidden: "이 작업을 수행할 권한이 없습니다"
+      not_found: "저장소를 찾을 수 없습니다"
+    webhooks:
+      pull_request:
+        title: "GitHub: Pull Request %{action}"
+        repository: "저장소"
+        pr: "PR"
+        author: "작성자"
+        action: "작업"
+        merged: "(머지됨)"
+        description: "설명"
+      push:
+        title: "GitHub: %{branch} 브랜치에 Push"
+        repository: "저장소"
+        branch: "브랜치"
+        pusher: "푸셔"
+        commits: "커밋"
+        recent_commits: "최근 커밋"
+        no_message: "(메시지 없음)"
+        more: "..."
+      issue:
+        title: "GitHub: Issue %{action}"
+        repository: "저장소"
+        issue: "이슈"
+        author: "작성자"
+        action: "작업"
+        description: "설명"
+      issue_comment:
+        title: "GitHub: Issue #%{number}에 댓글 %{action}"
+        repository: "저장소"
+        issue: "이슈"
+        comment_by: "댓글 작성자"
+        link: "링크"
+        view_comment: "댓글 보기"
+        comment: "댓글"
+      generic:
+        title: "GitHub: %{event}"
+        repository: "저장소"
+        action: "작업"
+        sender: "보낸 사람"
+      actions:
+        opened: "열림"
+        closed: "닫힘"
+        merged: "머지됨"
+        reopened: "다시 열림"
+        updated: "업데이트됨"
+        ready_for_review: "리뷰 준비됨"
+        event: "이벤트"

data/config/routes.rb

@@ -0,0 +1,17 @@
+CollavreGithub::Engine.routes.draw do
+  # Webhook endpoint (public, no auth)
+  # Both singular and plural for backward compatibility
+  post "webhook", to: "webhooks#create", as: :webhook
+  post "webhooks", to: "webhooks#create"
+
+  # Account endpoints
+  resource :account, only: [ :show ] do
+    get :organizations
+    get :repositories
+  end
+
+  # Creative integration endpoints
+  resources :creatives, only: [] do
+    resource :integration, module: :creatives, only: [ :show, :update, :destroy ]
+  end
+end

data/db/migrate/20250925000000_create_github_integrations.rb

@@ -0,0 +1,26 @@
+class CreateGithubIntegrations < ActiveRecord::Migration[8.0]
+  def change
+    create_table :github_accounts do |t|
+      t.references :user, null: false, foreign_key: true, index: { unique: true }
+      t.string :github_uid, null: false
+      t.string :login, null: false
+      t.string :name
+      t.string :avatar_url
+      t.string :token, null: false
+      t.datetime :token_expires_at
+      t.timestamps
+    end
+
+    create_table :github_repository_links do |t|
+      t.references :creative, null: false, foreign_key: true
+      t.references :github_account, null: false, foreign_key: true
+      t.bigint :repository_id
+      t.string :repository_full_name, null: false
+      t.timestamps
+    end
+
+    add_index :github_accounts, :github_uid, unique: true
+    add_index :github_repository_links, :repository_full_name
+    add_index :github_repository_links, [ :creative_id, :repository_full_name ], unique: true, name: "index_github_links_on_creative_and_repo"
+  end
+end

data/db/migrate/20250927000000_add_webhook_secret_to_github_repository_links.rb

@@ -0,0 +1,29 @@
+class AddWebhookSecretToGithubRepositoryLinks < ActiveRecord::Migration[8.0]
+  class GithubRepositoryLink < ApplicationRecord
+    self.table_name = "github_repository_links"
+  end
+
+  def up
+    add_column :github_repository_links, :webhook_secret, :string
+
+    GithubRepositoryLink.reset_column_information
+
+    say_with_time "Backfilling webhook secrets" do
+      GithubRepositoryLink.find_each do |link|
+        link.update_columns(webhook_secret: generate_secret)
+      end
+    end
+
+    change_column_null :github_repository_links, :webhook_secret, false
+  end
+
+  def down
+    remove_column :github_repository_links, :webhook_secret
+  end
+
+  private
+
+  def generate_secret
+    SecureRandom.hex(20)
+  end
+end

data/db/migrate/20250928105957_add_github_gemini_prompt_to_creatives.rb

@@ -0,0 +1,5 @@
+class AddGithubGeminiPromptToCreatives < ActiveRecord::Migration[8.0]
+  def change
+    add_column :creatives, :github_gemini_prompt, :text
+  end
+end

data/db/seeds.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+# Seed data for CollavreGithub engine
+# Creates the GitHub PR Analyzer AI Agent
+
+module CollavreGithub
+  class Seeds
+    AGENT_EMAIL = "github-pr-analyzer@collavre.local"
+
+    SYSTEM_PROMPT = <<~PROMPT
+      You are a GitHub Pull Request Analyzer. Your role is to analyze merged PRs and help maintain the project task tree (Creatives).
+
+      ## When you receive a GitHub PR merged event:
+      1. Use `github_pr_details` to get PR information
+      2. Use `github_pr_diff` to analyze code changes
+      3. Use `github_pr_commits` to understand the work done
+      4. Use `creative_retrieval_service` to see the current task tree
+
+      ## Analysis Guidelines:
+      - Match PR changes to existing tasks in the Creative tree
+      - Identify which tasks were completed by the PR
+      - Suggest new tasks if the PR reveals additional work needed
+      - Consider the PR title, description, and commit messages for context
+
+      ## Response Format:
+      After your analysis, if you identify tasks to update or create, respond with an action comment.
+
+      For completed tasks, suggest updating progress to 1.0:
+      ```json
+      {
+        "actions": [
+          { "action": "update_creative", "creative_id": <id>, "attributes": { "progress": 1.0 } }
+        ]
+      }
+      ```
+
+      For new tasks discovered:
+      ```json
+      {
+        "actions": [
+          { "action": "create_creative", "parent_id": <parent_id>, "attributes": { "description": "Task description" } }
+        ]
+      }
+      ```
+
+      You can combine multiple actions in a single response.
+
+      ## Important:
+      - Only suggest updates for tasks that are clearly addressed by the PR
+      - Be conservative - don't mark tasks complete unless the PR clearly resolves them
+      - Provide a brief summary of your analysis before the action JSON
+      - If no task updates are needed, just provide your analysis summary without action JSON
+    PROMPT
+
+    # Matches GitHub PR merged events
+    # The comment content will contain "### GitHub: Pull Request merged"
+    ROUTING_EXPRESSION = <<~EXPR.strip
+      event_name == "comment_created" and chat.comment.user_id == nil and chat.comment.content contains "GitHub: Pull Request merged"
+    EXPR
+
+    TOOLS = %w[
+      github_pr_details
+      github_pr_diff
+      github_pr_commits
+      creative_retrieval_service
+      creative_update_service
+    ].freeze
+
+    def self.call
+      new.call
+    end
+
+    def call
+      agent = find_or_initialize_agent
+      configure_agent(agent)
+      agent.save!
+
+      puts "[CollavreGithub] GitHub PR Analyzer agent created/updated: #{agent.email}"
+      agent
+    end
+
+    private
+
+    def find_or_initialize_agent
+      user_class.find_or_initialize_by(email: AGENT_EMAIL)
+    end
+
+    def configure_agent(agent)
+      agent.assign_attributes(
+        name: "GitHub PR Analyzer",
+        password: SecureRandom.hex(32),
+        email_verified_at: Time.current,
+        llm_vendor: default_llm_vendor,
+        llm_model: default_llm_model,
+        system_prompt: SYSTEM_PROMPT,
+        routing_expression: ROUTING_EXPRESSION,
+        tools: TOOLS,
+        searchable: true # Can analyze PRs for any Creative with GitHub integration
+      )
+    end
+
+    def user_class
+      Collavre.user_class
+    end
+
+    def default_llm_vendor
+      ENV.fetch("COLLAVRE_DEFAULT_LLM_VENDOR", "gemini")
+    end
+
+    def default_llm_model
+      ENV.fetch("COLLAVRE_DEFAULT_LLM_MODEL", "gemini-2.5-flash")
+    end
+  end
+end
+
+# Run seeds when this file is loaded
+CollavreGithub::Seeds.call

data/lib/collavre_github/engine.rb

@@ -0,0 +1,74 @@
+module CollavreGithub
+  class Engine < ::Rails::Engine
+    isolate_namespace CollavreGithub
+
+    config.generators do |g|
+      g.test_framework :minitest
+    end
+
+    def self.javascript_path
+      root.join("app/javascript")
+    end
+
+    config.i18n.load_path += Dir[root.join("config", "locales", "*.yml")]
+
+    initializer "collavre_github.routes", before: :add_routing_paths do |app|
+      app.routes.append do
+        mount CollavreGithub::Engine => "/github", as: :github_engine
+        match "/auth/github/callback", to: "collavre_github/auth#callback", via: [ :get, :post ]
+      end
+    end
+
+    initializer "collavre_github.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_github.register_integration", after: :load_config_initializers do
+      Rails.application.config.to_prepare do
+        if defined?(Collavre::IntegrationRegistry)
+          Collavre::IntegrationRegistry.register(:github, {
+            label: I18n.t("collavre_github.integration.label", default: "GitHub"),
+            icon: "github",
+            description: I18n.t("collavre_github.integration.description", default: "Connect repositories and receive webhook events"),
+            routes: CollavreGithub::Engine.routes.url_helpers,
+            creative_menu_partial: "collavre_github/integrations/modal"
+          })
+        end
+      end
+    end
+
+    initializer "collavre_github.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(:github_account)
+          user_class.has_one :github_account,
+                             class_name: "CollavreGithub::Account",
+                             foreign_key: :user_id,
+                             dependent: :destroy
+          Rails.logger.info("[CollavreGithub] Added github_account association to #{user_class.name}")
+        end
+      end
+    end
+
+    initializer "collavre_github.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(:github_repository_links)
+          creative_class.has_many :github_repository_links,
+                                  class_name: "CollavreGithub::RepositoryLink",
+                                  foreign_key: :creative_id,
+                                  dependent: :destroy
+          Rails.logger.info("[CollavreGithub] Added github_repository_links association to #{creative_class.name}")
+        end
+      end
+    end
+  end
+end

data/lib/collavre_github/version.rb

@@ -0,0 +1,3 @@
+module CollavreGithub
+  VERSION = "0.2.0"
+end

data/lib/collavre_github.rb

@@ -0,0 +1,5 @@
+require "collavre_github/version"
+require "collavre_github/engine"
+
+module CollavreGithub
+end