shiplog 0.1.0

data/db/migrate/20261026000001_create_shiplog_tables.rb

@@ -0,0 +1,102 @@
+class CreateShiplogTables < ActiveRecord::Migration[8.1]
+  def change
+    create_table :shiplog_repositories do |t|
+      t.string :full_name, null: false
+      t.datetime :synced_at
+      t.datetime :sync_cursor
+      t.datetime :changes_scanned_at
+      t.text :last_error
+      t.timestamps
+      t.index :full_name, unique: true
+    end
+
+    create_table :shiplog_issues do |t|
+      t.references :repository, null: false, foreign_key: { to_table: :shiplog_repositories }
+      t.string :node_id, null: false
+      t.integer :number, null: false
+      t.string :title, null: false
+      t.text :body
+      t.string :state, null: false, default: "open"
+      t.string :state_reason
+      t.jsonb :labels, null: false, default: []
+      t.string :milestone_title
+      t.integer :assignees_count, null: false, default: 0
+      t.string :parent_node_id
+      t.string :url
+      t.datetime :github_created_at
+      t.datetime :github_updated_at
+      t.datetime :closed_at
+      t.string :pinned_column
+      t.integer :position
+      t.timestamps
+      t.index :node_id, unique: true
+      t.index :parent_node_id
+      t.index :labels, using: :gin
+    end
+
+    create_table :shiplog_pull_requests do |t|
+      t.references :repository, null: false, foreign_key: { to_table: :shiplog_repositories }
+      t.string :node_id, null: false
+      t.integer :number, null: false
+      t.string :title, null: false
+      t.text :body
+      t.string :state, null: false, default: "open"
+      t.datetime :merged_at
+      t.string :author_login
+      t.jsonb :labels, null: false, default: []
+      t.string :url
+      t.datetime :github_updated_at
+      t.timestamps
+      t.index :node_id, unique: true
+    end
+
+    create_table :shiplog_issue_links do |t|
+      t.string :issue_node_id, null: false
+      t.string :pull_request_node_id, null: false
+      t.timestamps
+      t.index [ :issue_node_id, :pull_request_node_id ], unique: true
+      t.index :pull_request_node_id
+    end
+
+    create_table :shiplog_commits do |t|
+      t.references :repository, null: false, foreign_key: { to_table: :shiplog_repositories }, index: false
+      t.string :sha, null: false
+      t.text :message, null: false
+      t.string :author_login
+      t.datetime :committed_at
+      t.string :url
+      t.timestamps
+      t.index [ :repository_id, :sha ], unique: true
+    end
+
+    create_table :shiplog_entries do |t|
+      t.string :kind, null: false
+      t.string :status, null: false, default: "draft"
+      t.references :subject, polymorphic: true, null: false, index: false
+      t.string :title
+      t.text :body
+      t.string :source_digest
+      t.datetime :rewritten_at
+      t.text :rewrite_error
+      t.date :released_on
+      t.datetime :approved_at
+      t.string :approved_by
+      t.string :discard_reason
+      t.timestamps
+      t.index [ :subject_type, :subject_id, :kind ], unique: true
+      t.index :status
+    end
+
+    create_table :shiplog_webhook_deliveries do |t|
+      t.string :delivery_id, null: false
+      t.string :event
+      t.string :action
+      t.string :repository_full_name
+      t.datetime :received_at
+      t.datetime :processed_at
+      t.text :error
+      t.timestamps
+      t.index :delivery_id, unique: true
+    end
+  end
+end

data/lib/generators/shiplog/install/install_generator.rb

@@ -0,0 +1,94 @@
+module Shiplog
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      desc "Installs Shiplog: initializer, routes, migrations and the GitHub issue form."
+
+      class_option :tailwind, type: :boolean, default: false,
+        desc: "Style the public pages with Tailwind: turn the bundled stylesheet off and generate config.classes"
+
+      TAILWIND_STYLESHEET = "app/assets/tailwind/application.css".freeze
+      # Relative to app/assets/tailwind/application.css: ../ is app/assets, ../../ is app, ../../../ is the app root.
+      TAILWIND_SOURCE = %(@source "../../../config/initializers/shiplog.rb";).freeze
+
+      # Neutral Tailwind v4 classes (gray scale, indigo accent, dark: variants) for every Shiplog::Classes key.
+      TAILWIND_CLASSES = {
+        page: "mx-auto max-w-6xl px-4 py-8 text-gray-900 dark:text-gray-100",
+        page_header: "mb-8",
+        page_title: "text-3xl font-semibold tracking-tight",
+        page_lede: "mt-2 text-gray-600 dark:text-gray-400",
+        columns: "grid gap-6 md:grid-cols-3",
+        column: "rounded-xl border border-gray-200 bg-gray-50 p-4 dark:border-gray-800 dark:bg-gray-900/50",
+        column_header: "mb-4 border-b border-gray-200 pb-3 dark:border-gray-800",
+        column_title: "inline text-base font-semibold",
+        column_count: "ml-2 rounded-full bg-gray-200 px-2 py-0.5 text-xs font-medium text-gray-700 dark:bg-gray-800 dark:text-gray-300",
+        column_description: "mt-1 text-sm text-gray-500 dark:text-gray-400",
+        column_empty: "text-sm text-gray-500 dark:text-gray-400",
+        cards: "space-y-3",
+        card: "rounded-lg border border-gray-200 bg-white p-3 shadow-sm transition hover:border-indigo-400 hover:shadow dark:border-gray-800 dark:bg-gray-900 dark:hover:border-indigo-500",
+        card_title: "font-medium",
+        card_body: "mt-1 text-sm text-gray-600 dark:text-gray-400",
+        months: "space-y-10",
+        month: "border-l-2 border-gray-200 pl-6 dark:border-gray-800",
+        month_title: "mb-4 text-lg font-semibold",
+        entries: "space-y-4",
+        entry: "rounded-lg border border-gray-200 bg-white p-4 dark:border-gray-800 dark:bg-gray-900",
+        entry_feature: "border-l-4 border-l-indigo-500",
+        entry_category: "mr-2 inline-block rounded-full bg-gray-100 px-2 py-0.5 text-xs font-medium text-gray-700 dark:bg-gray-800 dark:text-gray-300",
+        entry_title: "mt-2 text-base font-semibold",
+        entry_body: "mt-1 text-sm text-gray-600 dark:text-gray-400",
+        entry_date: "text-xs text-gray-500 dark:text-gray-400",
+        pagination: "mt-8 flex justify-between",
+        pagination_link: "text-sm font-medium text-indigo-600 hover:underline dark:text-indigo-400",
+        empty: "text-gray-500 dark:text-gray-400"
+      }.freeze
+
+      def copy_initializer
+        template "initializer.rb.tt", "config/initializers/shiplog.rb"
+      end
+
+      def add_tailwind_source
+        return unless options[:tailwind]
+
+        path = File.join(destination_root, TAILWIND_STYLESHEET)
+        if File.exist?(path)
+          css = File.read(path)
+          if css.include?(TAILWIND_SOURCE)
+            say_status :identical, TAILWIND_STYLESHEET
+          else
+            separator = css.empty? || css.end_with?("\n") ? "" : "\n"
+            append_to_file TAILWIND_STYLESHEET, "#{separator}#{TAILWIND_SOURCE}\n"
+          end
+        else
+          say "Add this line to your Tailwind stylesheet so Tailwind compiles the Shiplog classes:\n  #{TAILWIND_SOURCE}"
+        end
+      end
+
+      def mount_engines
+        route <<~RUBY
+          # Shiplog: public roadmap, changelog and GitHub webhook.
+          mount Shiplog::Engine => "/"
+
+          # Shiplog admin. Wrap it in your own authentication before enabling it, for example with Devise:
+          # authenticate :user, ->(user) { user.admin? } do
+          #   mount Shiplog::Admin::Engine => "/admin/shiplog"
+          # end
+        RUBY
+      end
+
+      def install_migrations
+        rake "shiplog:install:migrations"
+      end
+
+      def copy_issue_form
+        copy_file "shiplog-feature.yml", ".github/ISSUE_TEMPLATE/shiplog-feature.yml"
+      end
+
+      private
+
+      def tailwind_classes_ruby
+        TAILWIND_CLASSES.map { |key, value| %(    #{key}: "#{value}",\n) }.join.sub(/,\n\z/, "\n")
+      end
+    end
+  end
+end

data/lib/generators/shiplog/install/templates/initializer.rb.tt

@@ -0,0 +1,86 @@
+Shiplog.configure do |config|
+  # GitHub repositories to sync ("owner/name"). Sub-issues may cross repositories of the same owner.
+  config.repositories = %w[acme/app acme/app-ios]
+
+  # A String, or a callable evaluated on every GitHub request (e.g. to mint a GitHub App installation token).
+  config.github_token = -> { Rails.application.credentials.dig(:github, :shiplog_token) }
+
+  # Secret configured on the GitHub webhook. Without it every webhook delivery is rejected.
+  config.webhook_secret = Rails.application.credentials.dig(:github, :shiplog_webhook_secret)
+
+  # Only issues with this label reach the roadmap.
+  # config.public_label = "public"
+
+  # Open public issues with one of these labels (or a milestone) are shown as "Coming soon".
+  # config.soon_labels = %w[soon]
+
+  # Pull requests with one of these labels never become changelog entries.
+  # config.excluded_labels = %w[internal dependencies refactor chore]
+
+  # Authors (Regexp, String or anything responding to ===) whose pull requests and commits are skipped.
+  # config.excluded_authors = [/\[bot\]\z/]
+
+  # Conventional-commit types eligible for the changelog.
+  # config.commit_types = %w[feat fix perf]
+
+  # Callable that receives the prompt (String) and returns a String containing JSON:
+  # {"title": "...", "body": "...", "customer_facing": true}
+  # config.rewriter = ->(prompt) { RubyLLM.chat.ask(prompt).content }
+
+  # Used in the built-in prompts.
+  # config.product_name = "Acme"
+  # config.audience = "small business owners who invoice customers"
+  # config.tone = "Friendly, concise, no jargon. Address the customer as 'you'."
+
+  # Optional ->(kind:, context:) { String } that replaces the built-in prompts.
+  # config.prompt_builder = nil
+
+  # Read once, when the public controllers load: changing it later has no effect.
+  # config.public_parent_controller = "ActionController::Base"
+  # config.public_layout = "shiplog/application"
+
+  # Parent class and layout of the admin controllers. Set the parent here (read once, when they load) and
+  # point the layout at your admin layout to render the admin inside your app's chrome.
+  # config.admin_parent_controller = "ActionController::Base"
+  # config.admin_layout = "shiplog/admin"
+
+  # :standalone (default) wraps the admin in Shiplog's own page chrome. Use :hosted when admin_layout is one of
+  # your layouts: Shiplog then renders only a compact sub-nav inside your content.
+  # config.admin_chrome = :standalone
+
+  # In :hosted mode, render Shiplog's flash messages inside the admin content. Set it to false when your
+  # layout already shows the flash.
+  # config.admin_flash = true
+
+<% if options[:tailwind] -%>
+  # The bundled stylesheet is off: the pages are styled with the Tailwind classes below, added next to
+  # the stable shiplog-* BEM classes. Tailwind finds them through the @source line in
+  # app/assets/tailwind/application.css (@source "../../../config/initializers/shiplog.rb";).
+  config.stylesheet = false
+
+  config.classes = {
+<%= tailwind_classes_ruby -%>
+  }
+
+<% else -%>
+  # Include the bundled stylesheet (CSS variables and @layer shiplog) in the public pages.
+  # Set it to false when your app styles the pages itself, for example with Tailwind.
+  # config.stylesheet = true
+
+  # Extra classes per element, added to the stable shiplog-* BEM classes (e.g. Tailwind utilities).
+  # Keys: <%= Shiplog::Classes::KEYS.join(", ") %>
+  # config.classes = {}
+
+<% end -%>
+  # Checked by the admin controllers; return false for a 403. It defaults to denying everyone.
+  # The line below opens it because the route constraint around the admin mount does the authentication.
+  # If the mount is not wrapped in such a constraint, replace it with a real check (e.g. controller.current_user&.admin?).
+  config.authorize_admin = ->(controller) { true } # the route constraint around the admin mount does the authentication
+
+  # Recorded as the approver of an entry.
+  # config.current_admin = ->(controller) { controller.try(:current_user)&.try(:email) }
+
+  # Public paths, read when routes are drawn.
+  # config.roadmap_path = "roadmap"
+  # config.changelog_path = "changelog"
+end

data/lib/generators/shiplog/install/templates/shiplog-feature.yml

@@ -0,0 +1,23 @@
+name: Customer-facing feature
+description: A feature or improvement your customers will see on the public roadmap and changelog.
+labels: ["public"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What can customers not do today, or what is painful? Write it in plain language.
+    validations:
+      required: true
+  - type: textarea
+    id: before
+    attributes:
+      label: Before
+      description: How do customers work around the problem today?
+  - type: textarea
+    id: after
+    attributes:
+      label: After
+      description: What will customers be able to do once this ships?
+    validations:
+      required: true

data/lib/shiplog/admin/engine.rb

@@ -0,0 +1,9 @@
+module Shiplog
+  module Admin
+    class Engine < ::Rails::Engine
+      isolate_namespace Shiplog::Admin
+      engine_name "shiplog_admin"
+      config.paths["config/routes.rb"] = "config/admin_routes.rb"
+    end
+  end
+end

data/lib/shiplog/classes.rb

@@ -0,0 +1,38 @@
+module Shiplog
+  # The public styling hooks. Every element of the public pages has a key here, a stable BEM class
+  # (always rendered) and an optional host-supplied class string (config.classes[key]).
+  module Classes
+    BEM = {
+      page: "shiplog-page",
+      page_header: "shiplog-page__header",
+      page_title: "shiplog-page__title",
+      page_lede: "shiplog-page__lede",
+      columns: "shiplog-columns",
+      column: "shiplog-column",
+      column_header: "shiplog-column__header",
+      column_title: "shiplog-column__title",
+      column_count: "shiplog-column__count",
+      column_description: "shiplog-column__description",
+      column_empty: "shiplog-column__empty",
+      cards: "shiplog-cards",
+      card: "shiplog-card",
+      card_title: "shiplog-card__title",
+      card_body: "shiplog-card__body",
+      months: "shiplog-months",
+      month: "shiplog-month",
+      month_title: "shiplog-month__title",
+      entries: "shiplog-entries",
+      entry: "shiplog-entry",
+      entry_feature: "shiplog-entry--feature",
+      entry_category: "shiplog-entry__category",
+      entry_title: "shiplog-entry__title",
+      entry_body: "shiplog-entry__body",
+      entry_date: "shiplog-entry__date",
+      pagination: "shiplog-pagination",
+      pagination_link: "shiplog-pagination__link",
+      empty: "shiplog-empty"
+    }.freeze
+
+    KEYS = BEM.keys.freeze
+  end
+end

data/lib/shiplog/configuration.rb

@@ -0,0 +1,92 @@
+module Shiplog
+  class Configuration
+    attr_accessor :repositories, :github_token, :webhook_secret,
+      :public_label, :soon_labels, :excluded_labels, :excluded_authors, :commit_types,
+      :rewriter, :product_name, :audience, :tone, :prompt_builder,
+      :public_layout, :admin_layout,
+      :stylesheet, :admin_flash, :authorize_admin, :current_admin,
+      :roadmap_path, :changelog_path
+
+    ADMIN_CHROMES = %i[standalone hosted].freeze
+
+    attr_reader :admin_chrome, :classes, :public_parent_controller, :admin_parent_controller
+
+    # :standalone (default) wraps the admin in Shiplog's own page chrome; :hosted renders it inside the
+    # layout of config.admin_layout (compact sub-nav, no page chrome of its own).
+    def admin_chrome=(value)
+      chrome = value.to_s.to_sym if value.respond_to?(:to_sym)
+      unless ADMIN_CHROMES.include?(chrome)
+        raise ArgumentError, "Invalid admin_chrome #{value.inspect}. Valid values: #{ADMIN_CHROMES.map(&:inspect).join(", ")}"
+      end
+      @admin_chrome = chrome
+    end
+
+    # Extra classes per element (see Shiplog::Classes::KEYS). Unknown keys raise in every environment;
+    # string keys become symbols and the hash is stored as a frozen copy.
+    def classes=(value)
+      classes = (value || {}).to_h.transform_keys { |key| key.to_s.to_sym }
+      unknown = classes.keys - Shiplog::Classes::KEYS
+      if unknown.any?
+        raise ArgumentError, "Unknown Shiplog classes key(s): #{unknown.map(&:inspect).join(", ")}. " \
+          "Valid keys: #{Shiplog::Classes::KEYS.map(&:inspect).join(", ")}"
+      end
+      @classes = classes.freeze
+    end
+
+    # The parent classes are read once, when the engine's controllers load.
+    def public_parent_controller=(value)
+      ensure_controller_not_loaded!(:public_parent_controller, Shiplog, :PublicController)
+      @public_parent_controller = value
+    end
+
+    def admin_parent_controller=(value)
+      ensure_controller_not_loaded!(:admin_parent_controller, Shiplog::Admin, :ApplicationController)
+      @admin_parent_controller = value
+    end
+
+    def initialize
+      @repositories = []
+      @public_label = "public"
+      @soon_labels = %w[soon]
+      @excluded_labels = %w[internal dependencies refactor chore]
+      @excluded_authors = [ /\[bot\]\z/ ]
+      @commit_types = %w[feat fix perf]
+      @tone = "Friendly, concise, no jargon. Address the customer as 'you'."
+      @public_parent_controller = "ActionController::Base"
+      @public_layout = "shiplog/application"
+      @admin_parent_controller = "ActionController::Base"
+      @admin_layout = "shiplog/admin"
+      @classes = {}.freeze
+      @stylesheet = true
+      @admin_chrome = :standalone
+      @admin_flash = true
+      @authorize_admin = ->(_controller) { false }
+      @current_admin = ->(controller) { controller.try(:current_user)&.try(:email) }
+      @roadmap_path = "roadmap"
+      @changelog_path = "changelog"
+    end
+
+    def resolved_github_token
+      github_token.respond_to?(:call) ? github_token.call : github_token
+    end
+
+    # The configured spelling of a repository name (matched case-insensitively), or nil.
+    def repository_configured?(name)
+      return if name.blank?
+      repositories.find { |configured| configured.casecmp?(name.to_s) }
+    end
+
+    def excluded_author?(login)
+      excluded_authors.any? { |pattern| pattern === login }
+    end
+
+    private
+
+    def ensure_controller_not_loaded!(setting, namespace, name)
+      return unless namespace.const_defined?(name, false) && !namespace.autoload?(name)
+
+      raise ArgumentError, "config.#{setting} was set after #{namespace}::#{name} loaded, so it would have no effect. " \
+        "Set it in config/initializers (before Shiplog controllers load)."
+    end
+  end
+end

data/lib/shiplog/engine.rb

@@ -0,0 +1,5 @@
+module Shiplog
+  class Engine < ::Rails::Engine
+    isolate_namespace Shiplog
+  end
+end

data/lib/shiplog/github/client.rb

@@ -0,0 +1,96 @@
+require "net/http"
+require "json"
+require "uri"
+
+module Shiplog
+  module Github
+    class Client
+      ENDPOINT = URI("https://api.github.com/graphql")
+      RETRYABLE_STATUSES = [ 502, 503, 504 ].freeze
+      NETWORK_ERRORS = [
+        Net::OpenTimeout, Net::ReadTimeout, Errno::ECONNRESET, Errno::ECONNREFUSED,
+        OpenSSL::SSL::SSLError, SocketError
+      ].freeze
+      DEFAULT_RESET_WINDOW = 60
+
+      def initialize(token: Shiplog.config.resolved_github_token, retry_delay: 1)
+        @token = token
+        @retry_delay = retry_delay
+      end
+
+      def query(query, variables = {})
+        raise Error, "No GitHub token configured (Shiplog.config.github_token)" if @token.blank?
+
+        response = post(JSON.generate(query:, variables:))
+        handle(response)
+      end
+
+      private
+
+      def post(payload, retried: false)
+        response = request(payload)
+        return response unless RETRYABLE_STATUSES.include?(response.code.to_i) && !retried
+
+        sleep @retry_delay
+        post(payload, retried: true)
+      end
+
+      def request(payload)
+        http = Net::HTTP.new(ENDPOINT.host, ENDPOINT.port)
+        http.use_ssl = true
+        http.open_timeout = 10
+        http.read_timeout = 30
+        http.request(build_request(payload))
+      rescue *NETWORK_ERRORS => error
+        raise Transient, "#{error.class}: #{error.message}"
+      end
+
+      def build_request(payload)
+        Net::HTTP::Post.new(ENDPOINT).tap do |req|
+          req["Authorization"] = "Bearer #{@token}"
+          req["Content-Type"] = "application/json"
+          req["User-Agent"] = "shiplog/#{Shiplog::VERSION}"
+          req.body = payload
+        end
+      end
+
+      def handle(response)
+        status = response.code.to_i
+        raise_rate_limited(response) if rate_limited?(response, status)
+        raise Transient, "GitHub responded with HTTP #{status}" if status >= 500
+        raise Error, "GitHub responded with HTTP #{status}" unless status.between?(200, 299)
+
+        body = JSON.parse(response.body)
+        errors = body["errors"].to_a
+        raise_rate_limited(response) if errors.any? { |e| e["type"] == "RATE_LIMITED" }
+        return body.fetch("data") if errors.empty? || not_found_only?(body, errors)
+
+        raise Error, errors.map { |e| e["message"] }.join("; ")
+      rescue JSON::ParserError
+        raise Error, "GitHub returned an unparseable response"
+      end
+
+      # A missing issue/PR number yields `data.repository.issue: null` plus a NOT_FOUND error.
+      def not_found_only?(body, errors)
+        body["data"].present? && errors.all? { |e| e["type"] == "NOT_FOUND" }
+      end
+
+      def rate_limited?(response, status)
+        return false unless [ 403, 429 ].include?(status)
+
+        response["x-ratelimit-remaining"] == "0" || response["retry-after"].present?
+      end
+
+      def raise_rate_limited(response)
+        reset_at = if response["retry-after"].present?
+          Time.current + response["retry-after"].to_i
+        elsif response["x-ratelimit-reset"].to_i.positive?
+          Time.at(response["x-ratelimit-reset"].to_i).utc
+        else
+          Time.current + DEFAULT_RESET_WINDOW
+        end
+        raise RateLimited.new(reset_at)
+      end
+    end
+  end
+end

data/lib/shiplog/github/errors.rb

@@ -0,0 +1,17 @@
+module Shiplog
+  module Github
+    class Error < StandardError; end
+
+    # Network failures and 5xx responses; safe to retry later.
+    class Transient < Error; end
+
+    class RateLimited < Error
+      attr_reader :reset_at
+
+      def initialize(reset_at)
+        @reset_at = reset_at
+        super("GitHub rate limit exceeded, resets at #{reset_at.utc.iso8601}")
+      end
+    end
+  end
+end

data/lib/shiplog/github/queries.rb

@@ -0,0 +1,108 @@
+module Shiplog
+  module Github
+    module Queries
+      PULL_REQUEST_FIELDS = <<~GRAPHQL.freeze
+        fragment PullRequestFields on PullRequest {
+          id number title body state mergedAt url updatedAt
+          author { __typename login }
+          repository { nameWithOwner }
+          labels(first: 30) { nodes { name } }
+        }
+      GRAPHQL
+
+      ISSUE_FIELDS = <<~GRAPHQL.freeze
+        fragment IssueFields on Issue {
+          __typename id number title body state stateReason url createdAt updatedAt closedAt
+          labels(first: 30) { nodes { name } }
+          milestone { title }
+          assignees { totalCount }
+          parent { id }
+          closedByPullRequestsReferences(first: 20, includeClosedPrs: true) {
+            pageInfo { hasNextPage }
+            nodes { ...PullRequestFields }
+          }
+        }
+      GRAPHQL
+
+      PULL_REQUEST_WITH_ISSUES = <<~GRAPHQL.freeze
+        fragment PullRequestWithIssues on PullRequest {
+          ...PullRequestFields
+          closingIssuesReferences(first: 20) {
+            pageInfo { hasNextPage }
+            nodes { id }
+          }
+        }
+      GRAPHQL
+
+      # GitHub rejects documents with unused fragments, so each query embeds
+      # exactly the fragments it (transitively) uses.
+      ISSUE_FRAGMENTS = (ISSUE_FIELDS + PULL_REQUEST_FIELDS).freeze
+      PULL_REQUEST_FRAGMENTS = (PULL_REQUEST_WITH_ISSUES + PULL_REQUEST_FIELDS).freeze
+
+      ISSUES = <<~GRAPHQL.freeze
+        query($owner: String!, $name: String!, $since: DateTime, $after: String) {
+          repository(owner: $owner, name: $name) {
+            issues(first: 50, after: $after, filterBy: { since: $since }, orderBy: { field: UPDATED_AT, direction: ASC }) {
+              pageInfo { hasNextPage endCursor }
+              nodes { ...IssueFields }
+            }
+          }
+        }
+        #{ISSUE_FRAGMENTS}
+      GRAPHQL
+
+      PULL_REQUESTS = <<~GRAPHQL.freeze
+        query($owner: String!, $name: String!, $after: String) {
+          repository(owner: $owner, name: $name) {
+            pullRequests(first: 50, after: $after, orderBy: { field: UPDATED_AT, direction: DESC }) {
+              pageInfo { hasNextPage endCursor }
+              nodes { ...PullRequestWithIssues }
+            }
+          }
+        }
+        #{PULL_REQUEST_FRAGMENTS}
+      GRAPHQL
+
+      ISSUE = <<~GRAPHQL.freeze
+        query($owner: String!, $name: String!, $number: Int!) {
+          repository(owner: $owner, name: $name) {
+            issue(number: $number) { ...IssueFields }
+          }
+        }
+        #{ISSUE_FRAGMENTS}
+      GRAPHQL
+
+      PULL_REQUEST = <<~GRAPHQL.freeze
+        query($owner: String!, $name: String!, $number: Int!) {
+          repository(owner: $owner, name: $name) {
+            pullRequest(number: $number) { ...PullRequestWithIssues }
+          }
+        }
+        #{PULL_REQUEST_FRAGMENTS}
+      GRAPHQL
+
+      COMMITS = <<~GRAPHQL.freeze
+        query($owner: String!, $name: String!, $since: GitTimestamp, $after: String) {
+          repository(owner: $owner, name: $name) {
+            defaultBranchRef {
+              target {
+                ... on Commit {
+                  history(first: 100, since: $since, after: $after) {
+                    pageInfo { hasNextPage endCursor }
+                    nodes {
+                      oid message committedDate url
+                      author { user { login } }
+                      associatedPullRequests(first: 1) { totalCount }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      GRAPHQL
+
+      ALL = { ISSUES:, PULL_REQUESTS:, ISSUE:, PULL_REQUEST:, COMMITS: }.freeze
+    end
+  end
+end

data/lib/shiplog/version.rb

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