git-markdown 0.1.0 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8414cb82426c583ac747480c7fd996b39f35c2758356884881667a57df54efe3
-  data.tar.gz: ae38f4bf979c40750003cbda6cf65548650c189f929bb33d75e268fe8dcb8e40
+  metadata.gz: 06b5aeed8786c57bb26b159375e7dcbb449e12b2ef4068f5aade847e1ffb809b
+  data.tar.gz: 3c60e2b038a66ca27183e27c54efba8bc05a0cd0395f3c9ce6f735e401840702
 SHA512:
-  metadata.gz: f4e5fe13c671fc6e7934e3bbbfc28f8c3853f0a3c5f04878b8605c1dbf293c01297eda5d8078d966be2fa86b2be6af0a97dd118e78ecd744c031d39b82ca59a2
-  data.tar.gz: 0ec5b02ec1d5a10fd981ef8a1c8732df476a10942dc132d57cdb2e8792c21af5c4f3c9089d92b53d03b9ff2b237c99e9ac899d527e6d1be6bffc266f1f5f23d5
+  metadata.gz: d5156133e179f31b2271f67caed36f9d90dfc0404cb25134097ae6a208861249959f6a3c4aefa7f1f7649d5f1ab25db11fb352de6bd2c11df8962139b2d2c327
+  data.tar.gz: cbd01023d035fea4d1f82759e8d829d645ddbcbbf40fa8d5acaf5eff1a777861a9566d2c13dd078efe1abbe3995abd00b2d1e6ba8d9c3f2e364eebf5ae0aae2d

data/CHANGELOG.md

@@ -5,27 +5,9 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.0] - 2026-02-08
+## [0.1.8] - 2026-03-20
 
 ### <!-- 0 -->🚀 Features
-- initialize gem structure with gemspec
-
-
-### <!-- 1 -->🐛 Bug Fixes
-- add missing yaml require and improve setup UX
-- hide negative flags in Thor CLI and add local install docs
-- fix git-cliff configuration
-
-
-### <!-- 3 -->📚 Documentation
-- fix README URLs and expand About section
-
-
-### <!-- 7 -->⚙️ Miscellaneous Tasks
-- update gemspec and README with proper metadata
-- streamline release prep workflow
-- add git hooks and ignore build artifacts
-- update CI ruby matrix and gitignore
-- update CI ruby matrix and gitignore
+- filter GitHub-native resolved comments via GraphQL
 
 

data/Rakefile

@@ -16,33 +16,74 @@ end
 task default: %i[test standard]
 
 namespace :release do
-  desc "Update changelog, commit, and tag"
-  task :prep do
-    version = GitMarkdown::VERSION
-    branch = `git rev-parse --abbrev-ref HEAD`.strip
+  desc "Full release: update changelog, bump version, commit, tag, and push"
+  task :bump, [:level] do |_t, args|
+    level = args[:level] || "patch"
+    valid_levels = %w[major minor patch pre]
 
-    if branch == "HEAD"
-      abort "Release prep requires a branch (not detached HEAD)."
+    unless valid_levels.include?(level)
+      abort "Invalid level: #{level}. Use: #{valid_levels.join(", ")}"
     end
 
+    branch = `git rev-parse --abbrev-ref HEAD`.strip
     unless ["main", "master"].include?(branch)
-      abort "Release prep must run on main or master. Current: #{branch}."
+      abort "Release must run on main or master. Current: #{branch}."
     end
 
     unless system("git diff --quiet") && system("git diff --cached --quiet")
-      abort "Release prep requires a clean working tree."
+      abort "Release requires a clean working tree."
+    end
+
+    current = GitMarkdown::VERSION
+    parts = current.split(".").map(&:to_i)
+
+    next_version = case level
+    when "major"
+      "#{parts[0] + 1}.0.0"
+    when "minor"
+      "#{parts[0]}.#{parts[1] + 1}.0"
+    when "patch"
+      "#{parts[0]}.#{parts[1]}.#{parts[2] + 1}"
+    when "pre"
+      "#{parts[0]}.#{parts[1]}.#{parts[2]}.pre.1"
     end
 
-    sh "git cliff -c cliff.toml --unreleased --tag v#{version} -o CHANGELOG.md"
+    puts "=== Step 1: Updating CHANGELOG.md for v#{next_version} ==="
+    sh "git cliff -c cliff.toml --unreleased --tag v#{next_version} -o CHANGELOG.md"
+
     if system("git diff --quiet -- CHANGELOG.md")
-      puts "No changelog changes. Skipping release prep."
-      next
+      puts "Warning: No changelog changes detected"
+    else
+      puts "✓ Changelog updated"
     end
 
-    sh "git add CHANGELOG.md"
-    sh "git commit -m \"docs: update changelog for v#{version}\""
-    sh "bundle exec gem tag -v #{version}"
-    sh "git push"
-    sh "git push origin v#{version}"
+    puts "\n=== Step 2: Bumping version to #{next_version} ==="
+
+    File.write(
+      "lib/git/markdown/version.rb",
+      <<~RUBY
+        # frozen_string_literal: true
+
+        module GitMarkdown
+          VERSION = "#{next_version}"
+        end
+      RUBY
+    )
+
+    puts "✓ Version updated in lib/git/markdown/version.rb"
+
+    puts "\n=== Step 3: Committing changes ==="
+    sh "git add CHANGELOG.md lib/git/markdown/version.rb"
+    sh "git commit -m \"chore(release): bump version to #{next_version}\""
+    puts "✓ Changes committed"
+
+    puts "\n=== Step 4: Creating and pushing tag ==="
+    sh "git tag -a v#{next_version} -m \"Release v#{next_version}\""
+    sh "git push origin master"
+    sh "git push origin v#{next_version}"
+    puts "✓ Tag v#{next_version} created and pushed"
+
+    puts "\n✅ Release v#{next_version} prepared successfully!"
+    puts "GitHub Actions will now build and publish the release."
   end
 end

data/git-markdown.gemspec

@@ -1,19 +1,30 @@
 # frozen_string_literal: true
 
+require_relative "lib/git/markdown/version"
+
 Gem::Specification.new do |spec|
   spec.name = "git-markdown"
-  spec.version = "0.1.0"
-  spec.authors = ["ethos-link"]
+  spec.version = GitMarkdown::VERSION
+  spec.authors = ["Paulo Fidalgo", "Ethos Link"]
 
   spec.summary = "Convert GitHub PRs to Markdown for local AI code review"
   spec.description = "A CLI tool that fetches GitHub pull requests and converts them to Markdown format, perfect for local AI assistants like opencode and codex."
-  spec.homepage = "https://github.com/ethos-link/git-markdown"
+  spec.homepage = "https://www.ethos-link.com/opensource/git-markdown"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 3.0.0"
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  repo = "https://github.com/ethos-link/git-markdown"
+  branch = "master"
+
+  spec.metadata = {
+    "homepage_uri" => spec.homepage,
+    "source_code_uri" => repo,
+    "bug_tracker_uri" => "#{repo}/issues",
+    "changelog_uri" => "#{repo}/blob/#{branch}/CHANGELOG.md",
+    "documentation_uri" => "#{repo}/blob/#{branch}/README.md",
+    "funding_uri" => "https://www.reviato.com/",
+    "rubygems_mfa_required" => "true"
+  }
 
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject do |f|

data/lib/git/markdown/api/client.rb

@@ -17,6 +17,17 @@ module GitMarkdown
         Response.new(response)
       end
 
+      def post(path, body = {})
+        uri = build_uri(path, {})
+        request = Net::HTTP::Post.new(uri)
+        set_headers(request)
+        request["Content-Type"] = "application/json"
+        request.body = JSON.generate(body)
+
+        response = http_request(uri, request)
+        Response.new(response)
+      end
+
       private
 
       def build_uri(path, params)

data/lib/git/markdown/configuration.rb

@@ -7,13 +7,14 @@ module GitMarkdown
     XDG_CONFIG_HOME = ENV.fetch("XDG_CONFIG_HOME", File.expand_path("~/.config"))
     DEFAULT_PROVIDER = :github
 
-    attr_accessor :token, :provider, :api_url, :output_dir, :default_status
+    attr_accessor :token, :provider, :api_url, :graphql_url, :output_dir, :default_status
 
     def initialize
       @provider = DEFAULT_PROVIDER
       @output_dir = Dir.pwd
       @default_status = :unresolved
       @api_url = nil
+      @graphql_url = nil
     end
 
     def self.load
@@ -24,6 +25,7 @@ module GitMarkdown
       load_from_file if config_file_exist?
       resolve_credentials
       resolve_api_url if api_url.nil?
+      resolve_graphql_url if graphql_url.nil?
       self
     end
 
@@ -67,6 +69,7 @@ module GitMarkdown
       )
       @provider = config[:provider] if config[:provider]
       @api_url = config[:api_url] if config[:api_url]
+      @graphql_url = config[:graphql_url] if config[:graphql_url]
       @output_dir = config[:output_dir] if config[:output_dir]
       @default_status = config[:default_status].to_sym if config[:default_status]
     end
@@ -81,10 +84,17 @@ module GitMarkdown
       end
     end
 
+    def resolve_graphql_url
+      @graphql_url = ENV.fetch("GITHUB_GRAPHQL_URL") do
+        (@provider == :github) ? "https://api.github.com/graphql" : nil
+      end
+    end
+
     def config_to_yaml
       {
         provider: @provider,
         api_url: @api_url,
+        graphql_url: @graphql_url,
         output_dir: @output_dir,
         default_status: @default_status
       }.to_yaml

data/lib/git/markdown/markdown/generator.rb

@@ -50,9 +50,9 @@ module GitMarkdown
       def include_comment?(comment)
         case @status_filter
         when :unresolved
-          !comment.body.include?("[resolved]") && !comment.body.include?("[done]")
+          !comment.resolved? && !comment.body.include?("[resolved]") && !comment.body.include?("[done]")
         when :resolved
-          comment.body.include?("[resolved]") || comment.body.include?("[done]")
+          comment.resolved? || comment.body.include?("[resolved]") || comment.body.include?("[done]")
         else
           true
         end

data/lib/git/markdown/models/comment.rb

@@ -4,6 +4,7 @@ module GitMarkdown
   module Models
     class Comment
       attr_reader :id, :body, :author, :path, :line, :html_url, :created_at, :updated_at, :in_reply_to_id
+      attr_accessor :resolved
 
       def initialize(attrs = {})
         @id = attrs[:id]
@@ -15,6 +16,7 @@ module GitMarkdown
         @created_at = attrs[:created_at]
         @updated_at = attrs[:updated_at]
         @in_reply_to_id = attrs[:in_reply_to_id]
+        @resolved = attrs.fetch(:resolved, false)
       end
 
       def self.from_api(data)
@@ -38,6 +40,10 @@ module GitMarkdown
       def reply?
         !@in_reply_to_id.nil?
       end
+
+      def resolved?
+        @resolved == true
+      end
     end
   end
 end

data/lib/git/markdown/providers/github/graphql.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module GitMarkdown
+  module Providers
+    class GitHub
+      class Graphql
+        RESOLVED_STATE_QUERY = <<~GRAPHQL
+          query($owner: String!, $repo: String!, $number: Int!, $threadsAfter: String, $commentsAfter: String) {
+            repository(owner: $owner, name: $repo) {
+              pullRequest(number: $number) {
+                reviewThreads(first: 100, after: $threadsAfter) {
+                  pageInfo {
+                    hasNextPage
+                    endCursor
+                  }
+                  nodes {
+                    isResolved
+                    comments(first: 100, after: $commentsAfter) {
+                      pageInfo {
+                        hasNextPage
+                        endCursor
+                      }
+                      nodes {
+                        databaseId
+                        body
+                        path
+                        line
+                        createdAt
+                        updatedAt
+                        author {
+                          login
+                        }
+                        replyTo {
+                          databaseId
+                        }
+                        url
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        GRAPHQL
+
+        def initialize(config)
+          @config = config
+        end
+
+        def fetch_resolved_states(owner, repo, number)
+          resolved_ids = Set.new
+          threads_after = nil
+
+          loop do
+            response = client.post("", {
+              query: RESOLVED_STATE_QUERY,
+              variables: {owner: owner, repo: repo, number: number,
+                          threadsAfter: threads_after}
+            })
+
+            raise ApiError, "GraphQL request failed: #{response.error_message}" unless response.success?
+
+            data = response.data
+            threads_data = data.dig("data", "repository", "pullRequest", "reviewThreads")
+            break unless threads_data
+
+            threads_data["nodes"].each do |thread|
+              next unless thread["isResolved"]
+
+              thread["comments"]["nodes"].each do |comment|
+                resolved_ids.add(comment["databaseId"]) if comment["databaseId"]
+              end
+            end
+
+            threads_page = threads_data["pageInfo"]
+            break unless threads_page["hasNextPage"]
+
+            threads_after = threads_page["endCursor"]
+          end
+
+          resolved_ids
+        end
+
+        private
+
+        def client
+          @client ||= Api::Client.new(
+            base_url: @config.graphql_url,
+            token: @config.token
+          )
+        end
+      end
+    end
+  end
+end

data/lib/git/markdown/providers/github.rb

@@ -21,23 +21,36 @@ module GitMarkdown
       end
 
       def fetch_reviews(owner, repo, number)
+        resolved_ids = fetch_resolved_comment_ids(owner, repo, number)
+
         path = "/repos/#{owner}/#{repo}/pulls/#{number}/reviews"
         reviews = fetch_all_pages(path)
 
+        all_pr_comments = fetch_all_pr_comments(owner, repo, number)
+
         reviews.map do |review_data|
           review = Models::Review.from_api(review_data)
-          review.comments = fetch_review_comments(owner, repo, review.id)
+          review.comments = all_pr_comments
+            .select { |c| c["pull_request_review_id"] == review.id }
+            .map do |data|
+              comment = Models::Comment.from_api(data)
+              comment.resolved = resolved_ids.include?(comment.id)
+              comment
+          end
           review
         end
       end
 
-      def fetch_review_comments(owner, repo, review_id)
-        path = "/repos/#{owner}/#{repo}/pulls/comments"
-        all_comments = fetch_all_pages(path)
+      def fetch_review_comments(owner, repo, review_id, resolved_ids = Set.new)
+        all_pr_comments = fetch_all_pr_comments(owner, repo)
 
-        all_comments
+        all_pr_comments
           .select { |c| c["pull_request_review_id"] == review_id }
-          .map { |data| Models::Comment.from_api(data) }
+          .map do |data|
+            comment = Models::Comment.from_api(data)
+            comment.resolved = resolved_ids.include?(comment.id)
+            comment
+          end
       end
 
       private
@@ -49,6 +62,22 @@ module GitMarkdown
         )
       end
 
+      def graphql_client
+        @graphql_client ||= Graphql.new(@config)
+      end
+
+      def fetch_resolved_comment_ids(owner, repo, number)
+        graphql_client.fetch_resolved_states(owner, repo, number)
+      rescue ApiError
+        Set.new
+      end
+
+      def fetch_all_pr_comments(owner, repo, _number = nil)
+        @all_pr_comments ||= {}
+        key = "#{owner}/#{repo}"
+        @all_pr_comments[key] ||= fetch_all_pages("/repos/#{owner}/#{repo}/pulls/comments")
+      end
+
       def fetch_all_pages(path, params = {})
         results = []
         page = 1

data/lib/git/markdown/version.rb

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

data/lib/git_markdown.rb

@@ -15,6 +15,7 @@ require_relative "git/markdown/credentials"
 require_relative "git/markdown/remote_parser"
 require_relative "git/markdown/providers/base"
 require_relative "git/markdown/providers/github"
+require_relative "git/markdown/providers/github/graphql"
 require_relative "git/markdown/api/client"
 require_relative "git/markdown/api/response"
 require_relative "git/markdown/models/pull_request"

metadata

@@ -1,10 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: git-markdown
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.8
 platform: ruby
 authors:
-- ethos-link
+- Paulo Fidalgo
+- Ethos Link
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -122,16 +123,21 @@ files:
 - lib/git/markdown/models/review.rb
 - lib/git/markdown/providers/base.rb
 - lib/git/markdown/providers/github.rb
+- lib/git/markdown/providers/github/graphql.rb
 - lib/git/markdown/remote_parser.rb
 - lib/git/markdown/version.rb
 - lib/git_markdown.rb
-homepage: https://github.com/ethos-link/git-markdown
+homepage: https://www.ethos-link.com/opensource/git-markdown
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/ethos-link/git-markdown
+  homepage_uri: https://www.ethos-link.com/opensource/git-markdown
   source_code_uri: https://github.com/ethos-link/git-markdown
-  changelog_uri: https://github.com/ethos-link/git-markdown/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/ethos-link/git-markdown/issues
+  changelog_uri: https://github.com/ethos-link/git-markdown/blob/master/CHANGELOG.md
+  documentation_uri: https://github.com/ethos-link/git-markdown/blob/master/README.md
+  funding_uri: https://www.reviato.com/
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -146,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Convert GitHub PRs to Markdown for local AI code review
 test_files: []