git-markdown 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06b5aeed8786c57bb26b159375e7dcbb449e12b2ef4068f5aade847e1ffb809b
-  data.tar.gz: 3c60e2b038a66ca27183e27c54efba8bc05a0cd0395f3c9ce6f735e401840702
+  metadata.gz: 76a5b1c374e3b1570dbc81b878c599fbe4948bb82f34ac3e7b83b838fba9f8fa
+  data.tar.gz: e59928ca3d2c0e06662c1c3bd5de7a9e6a8dd08fe185107902442a9dc96644aa
 SHA512:
-  metadata.gz: d5156133e179f31b2271f67caed36f9d90dfc0404cb25134097ae6a208861249959f6a3c4aefa7f1f7649d5f1ab25db11fb352de6bd2c11df8962139b2d2c327
-  data.tar.gz: cbd01023d035fea4d1f82759e8d829d645ddbcbbf40fa8d5acaf5eff1a777861a9566d2c13dd078efe1abbe3995abd00b2d1e6ba8d9c3f2e364eebf5ae0aae2d
+  metadata.gz: 06eca733ed11a7e397f050a3e12080c0354e12c4fe1f760dec9e0237a919e5eaa4d5b65af451356ffceed818c095d0829908f5feb0df0b7eac2b5408e34bb5ff
+  data.tar.gz: 0545bb27e46d36a396c5963fbefc4f37a9c00b96ae275872cb0c959e9b3724aa994dc0078c58c900d0b8594f0ba035d4749d876d48d6cb2ac7db286dc62327b2

data/AGENT.md

@@ -0,0 +1,47 @@
+# Agent Guide
+
+Repository-specific rules for code-generation agents working on `git-markdown`.
+
+## Core workflow
+
+- Prefer surgical edits. Do not reformat unrelated code or reshuffle files.
+- Read the actual call sites and CLI flows before changing behavior.
+- Preserve the public CLI and generated Markdown shape unless the task explicitly requires a change.
+- Fix root causes, not symptoms.
+- Keep one canonical owner per behavior:
+  - remote parsing in `Git::Markdown::RemoteParser`
+  - auth/config in `Git::Markdown::Configuration` and `Git::Markdown::Credentials`
+  - provider fetching in `Git::Markdown::Providers::*`
+  - HTTP transport/response handling in `Git::Markdown::Api::*`
+  - output rendering in `Git::Markdown::Markdown::Generator`
+
+## Naming and code quality
+
+- Use one canonical term per concept across code, config, and docs.
+- Do not add parallel wrappers or aliases for the same concept.
+- Use clear names that describe the domain object or action; avoid vague names like `Manager`, `Helper`, or `Handler`.
+- Keep classes small and intention-revealing. If logic starts spanning transport, parsing, and rendering concerns, split by responsibility rather than adding conditionals.
+- Fail fast on unexpected states. Prefer explicit errors over silent fallbacks.
+- When tests are hard to write, simplify the production design first instead of adding test-only indirection.
+
+## Testing and boundaries
+
+- Framework: Minitest.
+- Keep WebMock enabled. Do not allow live HTTP in tests.
+- Use VCR for outbound GitHub API interactions when fixtures are needed.
+- Add or update minimal tests when behavior changes, especially for CLI output, parsing, and provider interactions.
+- Use `standardrb` for Ruby style consistency.
+- Run `bundle exec rake` before finishing.
+
+## Git commits and release
+
+- Conventional Commits are required and enforced by `commitlint`.
+- Allowed commit types for normal work: `feat`, `fix`, `refactor`, `chore`, `test`, `docs`.
+- Subject line: imperative, <= 80 chars, no trailing period.
+- Add a body for non-trivial changes explaining why and how.
+- Install hooks once per clone: `bundle exec lefthook install`
+- Release flow:
+  - `bundle exec rake 'release:prepare[patch]'`
+  - changelog is generated by `git-cliff`
+  - publishing happens only in GitHub Actions
+  - this gem publishes only to RubyGems

data/CHANGELOG.md

@@ -5,9 +5,18 @@ 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.8] - 2026-03-20
+## [0.1.9] - 2026-04-21
 
-### <!-- 0 -->🚀 Features
-- filter GitHub-native resolved comments via GraphQL
+### <!-- 1 -->🐛 Bug Fixes
+- publish built gem in release workflow
+
+
+### <!-- 3 -->📚 Documentation
+- update gemspec and readme
+
+
+### <!-- 7 -->⚙️ Miscellaneous Tasks
+- standardize gem release workflow and repo conventions
+- stop using github variables
 
 

data/Gemfile

@@ -5,8 +5,6 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in git-markdown.gemspec
 gemspec
 
-gem "gem-release", "~> 2.2"
-
 group :development do
   gem "commitlint", require: false
   gem "lefthook", require: false

data/README.md

@@ -130,7 +130,7 @@ Note: `Gemfile.lock` is intentionally not tracked to avoid conflicts across Ruby
 
 ### Git hooks
 
-We use [lefthook](https://lefthook.dev/) with the Ruby [commitlint](https://github.com/arandilopez/commitlint) gem to enforce Conventional Commits on every commit. CI also validates commit messages on pull requests and pushes to main/master.
+We use [lefthook](https://lefthook.dev/) with the Ruby [commitlint](https://github.com/arandilopez/commitlint) gem to enforce Conventional Commits on every commit. We also use [Standard Ruby](https://standardrb.com/) to keep code style consistent. CI validates commit messages, Standard Ruby, tests, and git-cliff changelog generation on pull requests and pushes to main/master.
 
 Run the hook installer once per clone:
 
@@ -146,27 +146,29 @@ rake install
 
 ## Release
 
-Releases are triggered by pushed tags and use `CHANGELOG.md` for GitHub release notes.
+Releases are tag-driven and published by GitHub Actions to RubyGems. Local release commands never publish directly.
 
-If you want changelog automation, install `git-cliff` (<https://github.com/orhun/git-cliff>) locally and use it to update `CHANGELOG.md`.
+Install [git-cliff](https://git-cliff.org/) locally before preparing a release. The release task regenerates `CHANGELOG.md` from Conventional Commits.
 
-The release workflow expects a `## [X.Y.Z]` entry in `CHANGELOG.md` that matches the tag. Note: `release:prep` enforces a clean working tree and must run on the `main` or `master` branch; it will skip if the changelog has no changes.
+Before preparing a release, make sure you are on `main` or `master` with a clean worktree.
 
-Before bumping, install dependencies:
+Then run one of:
 
 ```bash
-bundle install
+bundle exec rake 'release:prepare[patch]'
+bundle exec rake 'release:prepare[minor]'
+bundle exec rake 'release:prepare[major]'
+bundle exec rake 'release:prepare[0.1.0]'
 ```
 
-Then run:
+The task will:
 
-```bash
-# 1) Bump the version (commit created)
-bundle exec gem bump -v X.Y.Z
+1. Regenerate `CHANGELOG.md` with `git-cliff`.
+1. Update `lib/git/markdown/version.rb`.
+1. Commit the release changes.
+1. Create and push the `vX.Y.Z` tag.
 
-# 2) Prepare release (changelog + tag + push)
-bundle exec rake release:prep
-```
+The `Release` workflow then runs tests, publishes the gem to RubyGems, and creates the GitHub release from the changelog entry.
 
 ## Contributing
 
@@ -199,7 +201,7 @@ MIT License, see [LICENSE.txt](LICENSE.txt)
 
 ## About
 
-Made by the team at [Ethos Link](https://www.ethos-link.com) — practical software for growing businesses. We build tools for hospitality and retail teams who don’t have time for complicated setups: plain-language insights, fast onboarding, and real human support so you can get clear insights, take action, and move on.
+Made by the team at [Ethos Link](https://www.ethos-link.com) — practical software for growing businesses. We build tools for hospitality operators who need clear workflows, fast onboarding, and real human support.
 
-We also build [Reviato](https://www.reviato.com), “More stars. Less hassle.”.
-Reviato helps restaurants, hotels, clinics, vets and other local businesses collect and analyse customer reviews, highlights recurring themes, and turns feedback into actionable next steps.
+We also build [Reviato](https://www.reviato.com), “Capture. Interpret. Act.”.
+Turn guest feedback into clear next steps for your team. Collect private appraisals, spot patterns across reviews, and act before small issues turn into public ones.

data/Rakefile

@@ -1,89 +1,99 @@
 # frozen_string_literal: true
 
-# Note: Releases are handled automatically by GitHub Actions when you push a tag (e.g., v0.2.0)
-# See .github/workflows/release.yml for details
 require "bundler/gem_tasks"
 require "rake/testtask"
 require "standard/rake"
 require_relative "lib/git/markdown/version"
 
+VERSION_PATH = File.expand_path("lib/git/markdown/version.rb", __dir__)
+VALID_RELEASE_TARGETS = %w[major minor patch].freeze
+
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
   t.libs << "lib"
   t.test_files = FileList["test/**/*_test.rb"]
 end
 
-task default: %i[test standard]
+def current_branch
+  `git branch --show-current`.strip
+end
 
-namespace :release do
-  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]
+def clean_worktree?
+  system("git diff --quiet") && system("git diff --cached --quiet")
+end
+
+def release_version(target)
+  target = target.to_s.strip
+  raise ArgumentError, "Provide patch, minor, major, or an explicit X.Y.Z version." if target.empty?
+
+  return target if target.match?(/\A\d+\.\d+\.\d+\z/)
+
+  unless VALID_RELEASE_TARGETS.include?(target)
+    raise ArgumentError, "Invalid release target #{target.inspect}. Use #{VALID_RELEASE_TARGETS.join(", ")} or X.Y.Z."
+  end
+
+  major, minor, patch = GitMarkdown::VERSION.split(".").map(&:to_i)
+
+  case target
+  when "major"
+    "#{major + 1}.0.0"
+  when "minor"
+    "#{major}.#{minor + 1}.0"
+  when "patch"
+    "#{major}.#{minor}.#{patch + 1}"
+  end
+end
+
+def update_version_file(version)
+  File.write(
+    VERSION_PATH,
+    <<~RUBY
+      # frozen_string_literal: true
+
+      module GitMarkdown
+        VERSION = "#{version}"
+      end
+    RUBY
+  )
+end
 
-    unless valid_levels.include?(level)
-      abort "Invalid level: #{level}. Use: #{valid_levels.join(", ")}"
-    end
+def update_changelog(version)
+  success = system("git-cliff", "-c", "cliff.toml", "--unreleased", "--tag", "v#{version}", "-o", "CHANGELOG.md")
+  raise "git-cliff failed. Install git-cliff and make sure cliff.toml is valid." unless success
+  raise "git-cliff did not update CHANGELOG.md. Ensure there are Conventional Commits since the last tag." if system("git", "diff", "--quiet", "--", "CHANGELOG.md")
+end
+
+if Rake::Task.task_defined?("release")
+  Rake::Task["release"].clear
+end
 
-    branch = `git rev-parse --abbrev-ref HEAD`.strip
-    unless ["main", "master"].include?(branch)
-      abort "Release must run on main or master. Current: #{branch}."
-    end
+desc "Publishing is handled by GitHub Actions. Use release:prepare[...] instead."
+task :release do
+  abort "Use `bundle exec rake 'release:prepare[patch]'` (or minor/major/X.Y.Z). Publishing runs in GitHub Actions after the tag is pushed."
+end
 
-    unless system("git diff --quiet") && system("git diff --cached --quiet")
-      abort "Release requires a clean working tree."
-    end
+namespace :release do
+  desc "Prepare a release: update CHANGELOG/version, commit, tag, and push. Accepts patch, minor, major, or X.Y.Z."
+  task :prepare, [:target] do |_task, args|
+    branch = current_branch
+    abort "Release must run on main or master. Current branch: #{branch.inspect}." unless %w[main master].include?(branch)
+    abort "Release requires a clean working tree." unless clean_worktree?
 
+    version = release_version(args[:target])
     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
-
-    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 "Warning: No changelog changes detected"
-    else
-      puts "✓ Changelog updated"
-    end
-
-    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"
+    abort "Release version #{version} is older than current version #{current}." if Gem::Version.new(version) < Gem::Version.new(current)
 
-    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"
+    update_changelog(version)
+    update_version_file(version)
 
-    puts "\n✅ Release v#{next_version} prepared successfully!"
-    puts "GitHub Actions will now build and publish the release."
+    sh "git add CHANGELOG.md lib/git/markdown/version.rb"
+    sh %(git commit -m "chore(release): prepare v#{version}")
+    sh %(git tag -a v#{version} -m "Release v#{version}")
+    sh "git push origin #{branch}"
+    sh "git push origin v#{version}"
+  rescue ArgumentError, RuntimeError => e
+    abort e.message
   end
 end
+
+task default: %i[test standard]

data/git-markdown.gemspec

@@ -6,6 +6,7 @@ Gem::Specification.new do |spec|
   spec.name = "git-markdown"
   spec.version = GitMarkdown::VERSION
   spec.authors = ["Paulo Fidalgo", "Ethos Link"]
+  spec.email = ["devel@ethos-link.com"]
 
   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."
@@ -23,6 +24,8 @@ Gem::Specification.new do |spec|
     "changelog_uri" => "#{repo}/blob/#{branch}/CHANGELOG.md",
     "documentation_uri" => "#{repo}/blob/#{branch}/README.md",
     "funding_uri" => "https://www.reviato.com/",
+    "github_repo" => "ssh://github.com/ethos-link/git-markdown",
+    "allowed_push_host" => "https://rubygems.org",
     "rubygems_mfa_required" => "true"
   }
 

data/lib/git/markdown/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-markdown
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - Paulo Fidalgo
@@ -96,11 +96,14 @@ dependencies:
         version: '3.0'
 description: A CLI tool that fetches GitHub pull requests and converts them to Markdown
   format, perfect for local AI assistants like opencode and codex.
+email:
+- devel@ethos-link.com
 executables:
 - git-markdown
 extensions: []
 extra_rdoc_files: []
 files:
+- AGENT.md
 - AGENTS.md
 - CHANGELOG.md
 - Gemfile
@@ -137,6 +140,8 @@ metadata:
   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/
+  github_repo: ssh://github.com/ethos-link/git-markdown
+  allowed_push_host: https://rubygems.org
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: