octorule 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fd5041a1721c8adf82d2612420fcf68e79abe258ed2c172b94c71e0c7e5522f8
+  data.tar.gz: b726f22fce6f4964c7d968276f4fde044e3cefc45811d165bccf62b7484fae7f
+SHA512:
+  metadata.gz: 5b472af0ff0724c5ffa88d14b34a6227daf9ed451e4d5248388512a46dc40e6eeba14eb1d6973f752f5c7d3def8c2b237a9cdb1c39e03203d70e38839c4935f7
+  data.tar.gz: 5dbe8cb7a8a630def0b68ddb2da407c9dd1a085a78e0e341faa05de9a060412215365587cbb9abdd170dd406ce0478773e49f6c3a92a1c75c09ffd436cb6c374

data/.ruby-version

@@ -0,0 +1 @@
+3.4.5

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-11-12
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/README.md

@@ -0,0 +1,172 @@
+# Octorule
+
+A command-line tool to enforce and synchronize GitHub repository settings across your organization.
+
+## Features
+
+- Synchronize repository settings across all repositories in an organization
+- Manage repository collaborators and their roles
+- Configure branch protection rules
+- Synchronize file contents from local files to repositories
+- Customizable settings via JSON file
+- Filter repositories by name pattern, labels, or language
+- Supports pagination for organizations with many repositories
+- Detailed logging of operations
+- Support for GitHub Enterprise via custom base URL
+- Dry-run mode to preview changes
+
+## Prerequisites
+
+- Ruby 3.2 or higher
+- GitHub Personal Access Token with `repo` and `admin:org` scopes
+
+## Installation
+
+Install the gem:
+
+```bash
+gem install octorule
+```
+
+## Usage
+
+Run the tool using:
+
+```bash
+octorule --org my-org --settings settings.json [options]
+```
+
+### Command Line Arguments
+
+Required Arguments:
+
+- `-o, --org <organization>`: GitHub organization name
+- `-s, --settings <path>`: Path to JSON file with repository settings
+
+Authentication Options:
+
+- `-t, --token <token>`: GitHub Personal Access Token (overrides GITHUB_TOKEN env var)
+- `-u, --base-url <url>`: GitHub API base URL (for GitHub Enterprise)
+
+Filter Options:
+
+- `-n, --name-pattern <pattern>`: Regular expression pattern to match repository names to include
+- `-l, --label <label>`: Only process repositories that have this label
+- `--language <language>`: Only process repositories with this primary language
+- `--fork`: Only process repositories that are forks
+- `--no-fork`: Only process repositories that aren't forks
+
+Other Options:
+
+- `-d, --dry-run`: Show what would be changed without making changes
+- `-h, --help`: Show help message
+- `-v, --version`: Show version
+
+### Examples
+
+```bash
+# Basic usage with environment variables
+export GITHUB_TOKEN=ghp_xxxxxxxxxxxx
+octorule --org my-org --settings settings.json
+
+# Using CLI token instead of environment variable
+octorule --org my-org --settings settings.json --token ghp_xxxxxxxxxxxx
+
+# Dry-run mode to preview changes
+octorule --org my-org --settings settings.json --dry-run
+
+# Using GitHub Enterprise
+octorule --org my-org --settings settings.json --base-url https://github.enterprise.com/api/v3
+
+# Only process repositories with names containing 'api' or 'service'
+octorule --org my-org --settings settings.json --name-pattern "api|service"
+
+# Only process repositories with the 'active' label
+octorule --org my-org --settings settings.json --label active
+
+# Only process Ruby repositories
+octorule --org my-org --settings settings.json --language ruby
+
+# Only process forked repositories
+octorule --org my-org --settings settings.json --fork
+
+# Only process non-forked repositories
+octorule --org my-org --settings settings.json --no-fork
+
+# Combine multiple filters (repositories must match ALL specified filters)
+octorule --org my-org --settings settings.json --name-pattern "api" --language ruby
+```
+
+### Settings File
+
+Create a JSON file with your desired repository settings. Here's an example:
+
+```json
+{
+  "repository": {
+    "has_issues": true,
+    "has_wiki": false,
+    "has_projects": true,
+    "allow_squash_merge": true,
+    "allow_merge_commit": false,
+    "allow_rebase_merge": true,
+    "delete_branch_on_merge": true,
+    "allow_auto_merge": true,
+    "allow_update_branch": true
+  },
+  "collaborators": [
+    {
+      "username": "user1",
+      "role": "admin"
+    },
+    {
+      "username": "user2",
+      "role": "write"
+    }
+  ],
+  "branch_protection": {
+    "main": {
+      "enforce_admins": true,
+      "required_status_checks": {
+        "strict": true,
+        "contexts": ["ci/build", "ci/test"]
+      },
+      "required_pull_request_reviews": {
+        "required_approving_review_count": 2,
+        "dismiss_stale_reviews": true,
+        "require_code_owner_reviews": true
+      },
+      "allow_force_pushes": false,
+      "allow_deletions": false
+    }
+  },
+  "files": [
+    {
+      "path": ".gitignore",
+      "localPath": "./templates/.gitignore"
+    },
+    {
+      "path": "CONTRIBUTING.md",
+      "localPath": "./templates/CONTRIBUTING.md"
+    }
+  ]
+}
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/ecosyste-ms/octorule. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/ecosyste-ms/octorule/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+MIT
+
+## Code of Conduct
+
+Everyone interacting in the Octorule project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/ecosyste-ms/octorule/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/exe/octorule

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "octorule"
+
+Octorule::CLI.run(ARGV)

data/lib/octorule/cli.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require "optparse"
+require "json"
+
+module Octorule
+  class CLI
+    def self.run(argv)
+      new(argv).run
+    end
+
+    def initialize(argv)
+      @argv = argv
+      @options = {}
+    end
+
+    def run
+      parse_options
+
+      unless @options[:org]
+        warn "Error: Organization name is required. Use --org or set GITHUB_ORG environment variable"
+        exit 1
+      end
+
+      unless @options[:settings]
+        warn "Error: Settings file is required. Use --settings"
+        exit 1
+      end
+
+      token = @options[:token] || ENV["GITHUB_TOKEN"]
+      unless token
+        warn "Error: GitHub token is required. Use --token or set GITHUB_TOKEN environment variable"
+        exit 1
+      end
+
+      settings = load_settings(@options[:settings])
+
+      if settings.empty?
+        warn "Error: Settings file is empty"
+        exit 1
+      end
+
+      filters = {
+        name_pattern: @options[:name_pattern],
+        label: @options[:label],
+        language: @options[:language],
+        fork: @options[:fork]
+      }
+
+      client = Octokit::Client.new(access_token: token, api_endpoint: @options[:base_url])
+      syncer = Syncer.new(client, @options[:org], settings, filters, @options[:dry_run])
+      syncer.sync
+    rescue StandardError => e
+      warn "Error: #{e.message}"
+      exit 1
+    end
+
+    private
+
+    def parse_options
+      OptionParser.new do |opts|
+        opts.banner = "Usage: octorule --org ORGANIZATION --settings FILE [options]"
+
+        opts.on("-o", "--org ORGANIZATION", "GitHub organization name") do |org|
+          @options[:org] = org
+        end
+
+        opts.on("-s", "--settings FILE", "Path to JSON file with repository settings") do |file|
+          @options[:settings] = file
+        end
+
+        opts.on("-n", "--name-pattern PATTERN", "Regular expression pattern to match repository names") do |pattern|
+          @options[:name_pattern] = pattern
+        end
+
+        opts.on("-l", "--label LABEL", "Only process repositories with this label") do |label|
+          @options[:label] = label
+        end
+
+        opts.on("--language LANGUAGE", "Only process repositories with this primary language") do |lang|
+          @options[:language] = lang
+        end
+
+        opts.on("--fork", "Only process repositories that are forks") do
+          @options[:fork] = true
+        end
+
+        opts.on("--no-fork", "Only process repositories that aren't forks") do
+          @options[:fork] = false
+        end
+
+        opts.on("-t", "--token TOKEN", "GitHub Personal Access Token (overrides GITHUB_TOKEN env var)") do |token|
+          @options[:token] = token
+        end
+
+        opts.on("-u", "--base-url URL", "GitHub API base URL (for GitHub Enterprise)") do |url|
+          @options[:base_url] = url
+        end
+
+        opts.on("-d", "--dry-run", "Show what would be changed without making changes") do
+          @options[:dry_run] = true
+        end
+
+        opts.on("-h", "--help", "Show this help message") do
+          puts opts
+          exit
+        end
+
+        opts.on("-v", "--version", "Show version") do
+          puts "octorule #{Octorule::VERSION}"
+          exit
+        end
+      end.parse!(@argv)
+
+      @options[:org] ||= ENV["GITHUB_ORG"]
+    end
+
+    def load_settings(file)
+      JSON.parse(File.read(file))
+    rescue Errno::ENOENT
+      raise "Settings file not found: #{file}"
+    rescue JSON::ParserError => e
+      raise "Invalid JSON in settings file: #{e.message}"
+    end
+  end
+end

data/lib/octorule/filters.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Octorule
+  class Filters
+    def initialize(client)
+      @client = client
+    end
+
+    def should_process?(repo, filters)
+      return true if filters.values.compact.empty?
+
+      if repo[:archived]
+        puts "Skipping #{repo[:name]} - repository is archived"
+        return false
+      end
+
+      if filters[:name_pattern]
+        pattern = Regexp.new(filters[:name_pattern])
+        unless pattern.match?(repo[:name])
+          puts "Skipping #{repo[:name]} - does not match name pattern #{filters[:name_pattern]}"
+          return false
+        end
+      end
+
+      if filters[:language]
+        repo_language = repo[:language]&.downcase
+        filter_language = filters[:language].downcase
+        unless repo_language == filter_language
+          puts "Skipping #{repo[:name]} - does not match language #{filters[:language]}"
+          return false
+        end
+      end
+
+      if filters[:label]
+        labels = fetch_labels(repo[:owner][:login], repo[:name])
+        unless labels.include?(filters[:label])
+          puts "Skipping #{repo[:name]} - does not have label #{filters[:label]}"
+          return false
+        end
+      end
+
+      if !filters[:fork].nil?
+        if filters[:fork] && !repo[:fork]
+          puts "Skipping #{repo[:name]} - repository is not a fork"
+          return false
+        elsif !filters[:fork] && repo[:fork]
+          puts "Skipping #{repo[:name]} - repository is a fork"
+          return false
+        end
+      end
+
+      true
+    end
+
+    private
+
+    def fetch_labels(org, repo)
+      @client.labels("#{org}/#{repo}").map { |label| label[:name] }
+    rescue Octokit::Error => e
+      warn "Could not fetch labels for #{repo}: #{e.message}"
+      []
+    end
+  end
+end

data/lib/octorule/services/branch_protection.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Octorule
+  module Services
+    class BranchProtection
+      def initialize(client)
+        @client = client
+      end
+
+      def update(org, repo, branch, settings, dry_run: false)
+        if dry_run
+          puts "Would update branch protection for #{branch} in #{repo}:"
+          settings.each { |k, v| puts "    #{k}: #{v}" }
+        else
+          @client.protect_branch("#{org}/#{repo}", branch, settings)
+          puts "Successfully updated branch protection for #{branch} in #{repo}"
+        end
+      rescue Octokit::Error => e
+        warn "Failed to update branch protection for #{branch} in #{repo}: #{e.message}"
+      end
+    end
+  end
+end

data/lib/octorule/services/collaborators.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Octorule
+  module Services
+    class Collaborators
+      def initialize(client)
+        @client = client
+      end
+
+      def update(org, repo, desired_collaborators, dry_run: false)
+        current = fetch_collaborators(org, repo)
+        current_usernames = current.map { |c| c[:username] }
+
+        desired_collaborators.each do |collaborator|
+          username = collaborator["username"]
+          role = collaborator["role"]
+
+          if current_usernames.include?(username)
+            current_collab = current.find { |c| c[:username] == username }
+            if current_collab[:role] != role
+              update_role(org, repo, username, role, dry_run)
+            end
+          else
+            add_collaborator(org, repo, username, role, dry_run)
+          end
+        end
+      end
+
+      private
+
+      def fetch_collaborators(org, repo)
+        @client.collaborators("#{org}/#{repo}").map do |collab|
+          {
+            username: collab[:login],
+            role: collab[:role_name]
+          }
+        end
+      rescue Octokit::Error => e
+        warn "Could not fetch collaborators for #{repo}: #{e.message}"
+        []
+      end
+
+      def add_collaborator(org, repo, username, role, dry_run)
+        if dry_run
+          puts "Would add collaborator #{username} with role #{role} to #{repo}"
+        else
+          @client.add_collaborator("#{org}/#{repo}", username, permission: role)
+          puts "Added collaborator #{username} with role #{role} to #{repo}"
+        end
+      rescue Octokit::Error => e
+        warn "Failed to add collaborator #{username} to #{repo}: #{e.message}"
+      end
+
+      def update_role(org, repo, username, role, dry_run)
+        if dry_run
+          puts "Would update role for #{username} to #{role} in #{repo}"
+        else
+          @client.add_collaborator("#{org}/#{repo}", username, permission: role)
+          puts "Updated role for #{username} to #{role} in #{repo}"
+        end
+      rescue Octokit::Error => e
+        warn "Failed to update role for #{username} in #{repo}: #{e.message}"
+      end
+    end
+  end
+end

data/lib/octorule/services/file_sync.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require "base64"
+
+module Octorule
+  module Services
+    class FileSync
+      def initialize(client)
+        @client = client
+      end
+
+      def sync(org, repo, file_config, dry_run: false)
+        path = file_config["path"]
+        local_path = file_config["localPath"]
+
+        local_content = File.read(local_path)
+        current_file = fetch_file(org, repo, path)
+
+        if current_file && current_file[:content] == local_content
+          puts "Skipping #{path} in #{repo} - content matches"
+          return
+        end
+
+        update_file(org, repo, path, local_content, current_file&.dig(:sha), dry_run)
+      rescue Errno::ENOENT
+        warn "Local file not found: #{local_path}"
+      rescue Octokit::Error => e
+        warn "Failed to sync file #{path} in #{repo}: #{e.message}"
+      end
+
+      private
+
+      def fetch_file(org, repo, path)
+        response = @client.contents("#{org}/#{repo}", path: path)
+        {
+          content: Base64.decode64(response[:content]),
+          sha: response[:sha]
+        }
+      rescue Octokit::NotFound
+        nil
+      end
+
+      def update_file(org, repo, path, content, sha, dry_run)
+        message = sha ? "Update #{path}" : "Add #{path}"
+
+        if dry_run
+          puts "Would #{sha ? "update" : "create"} file #{path} in #{repo}"
+          puts "    Content length: #{content.length} characters"
+        else
+          @client.create_contents(
+            "#{org}/#{repo}",
+            path,
+            message,
+            content,
+            sha: sha
+          )
+          puts "Successfully #{sha ? "updated" : "created"} #{path} in #{repo}"
+        end
+      end
+    end
+  end
+end

data/lib/octorule/services/repository.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Octorule
+  module Services
+    class Repository
+      def initialize(client)
+        @client = client
+      end
+
+      def fetch_all(org)
+        repos = []
+        page = 1
+
+        loop do
+          response = @client.org_repos(org, per_page: 100, page: page)
+          break if response.empty?
+
+          repos.concat(response)
+          page += 1
+        end
+
+        repos
+      end
+
+      def update_settings(org, repo, settings, dry_run: false)
+        return unless settings["repository"]
+
+        current = fetch_settings(org, repo)
+        return unless current
+
+        diff = settings_diff(current, settings["repository"])
+
+        if diff.empty?
+          puts "Skipping #{repo} - settings match"
+          return
+        end
+
+        if dry_run
+          puts "Would update repository settings for #{repo}:"
+          diff.each { |k, v| puts "    #{k}: #{v}" }
+        else
+          @client.edit_repository("#{org}/#{repo}", diff)
+          puts "Successfully updated settings for #{repo}"
+        end
+      rescue Octokit::Error => e
+        warn "Failed to update settings for #{repo}: #{e.message}"
+      end
+
+      private
+
+      def fetch_settings(org, repo)
+        @client.repository("#{org}/#{repo}")
+      rescue Octokit::Error => e
+        warn "Failed to fetch settings for #{repo}: #{e.message}"
+        nil
+      end
+
+      def settings_diff(current, desired)
+        diff = {}
+        desired.each do |key, value|
+          current_value = current[key.to_sym]
+          diff[key] = value unless current_value == value
+        end
+        diff
+      end
+    end
+  end
+end

data/lib/octorule/syncer.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Octorule
+  class Syncer
+    def initialize(client, org, settings, filters = {}, dry_run = false)
+      @client = client
+      @org = org
+      @settings = settings
+      @filters = filters
+      @dry_run = dry_run
+
+      @repository_service = Services::Repository.new(client)
+      @collaborators_service = Services::Collaborators.new(client)
+      @branch_protection_service = Services::BranchProtection.new(client)
+      @file_sync_service = Services::FileSync.new(client)
+      @filters_service = Filters.new(client)
+    end
+
+    def sync
+      puts "Starting settings sync for organization: #{@org}"
+      puts "Running in dry-run mode - no changes will be made" if @dry_run
+
+      repos = @repository_service.fetch_all(@org)
+      puts "Found #{repos.length} repositories"
+
+      processed_count = 0
+      skipped_count = 0
+
+      repos.each do |repo|
+        if @filters_service.should_process?(repo, @filters)
+          process_repository(repo)
+          processed_count += 1
+        else
+          skipped_count += 1
+        end
+      end
+
+      puts "Settings sync completed!"
+      puts "Summary:"
+      puts "    - Total repositories: #{repos.length}"
+      puts "    - Processed: #{processed_count}"
+      puts "    - Skipped: #{skipped_count}"
+      puts "    - Mode: #{@dry_run ? "Dry Run" : "Live"}"
+    rescue StandardError => e
+      warn "Error during sync: #{e.message}"
+      raise
+    end
+
+    private
+
+    def process_repository(repo)
+      repo_name = repo[:name]
+
+      @repository_service.update_settings(@org, repo_name, @settings, dry_run: @dry_run)
+
+      if @settings["collaborators"]
+        @collaborators_service.update(@org, repo_name, @settings["collaborators"], dry_run: @dry_run)
+        puts "#{@dry_run ? "Would update" : "Successfully updated"} collaborators for #{repo_name}"
+      end
+
+      if @settings["branch_protection"]&.is_a?(Hash)
+        @settings["branch_protection"].each do |branch, protection|
+          @branch_protection_service.update(@org, repo_name, branch, protection, dry_run: @dry_run)
+        end
+        puts "#{@dry_run ? "Would update" : "Successfully updated"} branch protection for #{repo_name}"
+      end
+
+      if @settings["files"]&.is_a?(Array)
+        @settings["files"].each do |file_sync|
+          @file_sync_service.sync(@org, repo_name, file_sync, dry_run: @dry_run)
+        end
+        puts "#{@dry_run ? "Would sync" : "Successfully synced"} file content for #{repo_name}"
+      end
+    end
+  end
+end

data/lib/octorule/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Octorule
+  VERSION = "0.1.0"
+end

data/lib/octorule.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative "octorule/version"
+require "octokit"
+
+module Octorule
+  class Error < StandardError; end
+
+  autoload :CLI, "octorule/cli"
+  autoload :Syncer, "octorule/syncer"
+  autoload :Filters, "octorule/filters"
+
+  module Services
+    autoload :Repository, "octorule/services/repository"
+    autoload :Collaborators, "octorule/services/collaborators"
+    autoload :BranchProtection, "octorule/services/branch_protection"
+    autoload :FileSync, "octorule/services/file_sync"
+  end
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: octorule
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andrew Nesbitt
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: A command-line tool to synchronize and enforce repository settings, collaborators,
+  branch protection rules, and files across GitHub organizations
+email:
+- andrewnez@gmail.com
+executables:
+- octorule
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ruby-version"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- README.md
+- Rakefile
+- exe/octorule
+- lib/octorule.rb
+- lib/octorule/cli.rb
+- lib/octorule/filters.rb
+- lib/octorule/services/branch_protection.rb
+- lib/octorule/services/collaborators.rb
+- lib/octorule/services/file_sync.rb
+- lib/octorule/services/repository.rb
+- lib/octorule/syncer.rb
+- lib/octorule/version.rb
+homepage: https://github.com/ecosyste-ms/octorule
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ecosyste-ms/octorule
+  source_code_uri: https://github.com/ecosyste-ms/octorule
+  changelog_uri: https://github.com/ecosyste-ms/octorule/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.5
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Enforce GitHub repository settings across your organization
+test_files: []