git-markdown 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8414cb82426c583ac747480c7fd996b39f35c2758356884881667a57df54efe3
+  data.tar.gz: ae38f4bf979c40750003cbda6cf65548650c189f929bb33d75e268fe8dcb8e40
+SHA512:
+  metadata.gz: f4e5fe13c671fc6e7934e3bbbfc28f8c3853f0a3c5f04878b8605c1dbf293c01297eda5d8078d966be2fa86b2be6af0a97dd118e78ecd744c031d39b82ca59a2
+  data.tar.gz: 0ec5b02ec1d5a10fd981ef8a1c8732df476a10942dc132d57cdb2e8792c21af5c4f3c9089d92b53d03b9ff2b237c99e9ac899d527e6d1be6bffc266f1f5f23d5

data/AGENTS.md

@@ -0,0 +1,248 @@
+# AI Agent Playbook
+
+Rules any code-generation agent must follow when editing this repository.
+Keep changes minimal, validated, and consistent with existing patterns.
+
+## How to work in this repo
+
+- Prefer surgical edits. Don’t reformat unrelated code. Preserve public APIs unless required.
+- Source of truth is the code: read actual files, signatures, and call sites before changing anything.
+- Think before acting: understand root causes; don’t treat symptoms.
+
+### Stack constraints (do not drift)
+
+- Ruby 3.4 + Rails 8.1
+- No-build frontend: Importmap + tailwindcss-rails (Tailwind v4)
+- Use `bin/dev` for local dev (Rails + Tailwind watcher + GoodJob)
+- Do not introduce Node/Yarn or JS bundlers
+
+### Commands (run before finishing)
+
+- Tests: `bundle exec rails test` (all) or targeted files
+- System tests: `bundle exec rails test:system`
+- Coverage: `COVERAGE=1 bundle exec rails test`
+- Lint: `bin/rubocop`
+- ERB lint: `bundle exec erb_lint --lint-all`
+- Assets: `RAILS_ENV=production bin/rails assets:precompile`
+- Data: `bin/rails data:plans:seed`
+
+## Boundaries
+
+### Always
+
+- Keep diffs surgical; don’t shuffle files or reformat unrelated code.
+- Add/update minimal tests when behavior changes.
+- Use i18n keys for user-facing copy (no hardcoded UI strings).
+- Keep WebMock enabled in tests; do not allow live HTTP.
+
+### Ask first (high-risk)
+
+- New dependencies (gems / JS packages / tooling).
+- Database migrations or schema changes.
+- Changes to provider contracts, auth/authorization, billing, or security boundaries.
+- Editing Rails credentials / secrets handling.
+
+### Never
+
+- Commit secrets/credentials, master keys, or decrypted values.
+- Add Node/Yarn/bundlers to the stack.
+- Add debug prints/breakpoints in app/runtime code (`puts`, `pp`, `binding.pry`).
+  - Exception: intentional CLI output in Rake tasks is acceptable.
+
+## Git commits
+
+- Use Conventional Commits.
+- Subject line ≤ 80 chars, imperative, no trailing period.
+- Body (when non-trivial): explain **why** and **how** (not what).
+- Types: `feat`, `fix`, `refactor`, `chore`, `test`, `docs`.
+
+## Project map (what goes where)
+
+- `app/`: Rails MVC, jobs, services (legacy), views.
+- `lib/`: External providers and infra (`lib/providers`, `lib/faraday`, `lib/rack`).
+  - Data in `lib/data/` (e.g., `plans.yml`). Rake tasks in `lib/tasks/`.
+- `lib/providers`: Provider interfaces/results + implementations. Use `Providers::Page`/`Providers::Review` at boundaries.
+  - Webhook resources via `Providers::Resources` (`:page`, `:review`).
+- `test/`: Minitest (`integration/`, `system/`, etc.)
+  - VCR cassettes: `test/support/cassettes/`
+  - Webhook captures: `test/support/webhook_captures/`
+- Controllers: root under `app/controllers/`; namespaced in matching folders.
+  - Base classes: `PublicBaseController`, `DashboardBaseController`, `Admin::BaseController`.
+
+## Decision trees (use these defaults)
+
+### 1) You’re touching an Actor/service object
+
+- Is the change trivial (typo, small conditional, tiny refactor)?
+  - Yes → keep the existing Actor/service shape.
+  - No → convert the touched service to a PORO as part of the change.
+- When converting:
+  - Prefer explicit constructors + methods (`ThingCreator.new(...).create`)
+  - Or move behavior onto the relevant model when it naturally belongs there.
+
+### 2) You’re touching a ViewComponent / adding shared UI
+
+- Are you adding new UI/shared UI?
+  - Yes → use Rails partials under `app/views/shared/` (layout-aware; see below).
+- Are you touching an existing ViewComponent?
+  - Small change → keep it as-is.
+  - Meaningful change → prefer migrating it to a partial as part of the change.
+
+## Rails conventions
+
+- Routing: keep routes simple and close to Rails defaults.
+  - Avoid redundant `defaults:` / `controller:` overrides when convention can solve it.
+  - Avoid `:as` overrides unless strictly necessary.
+  - Prefer `namespace` + `resources`.
+  - Prefer REST/CRUD: introduce a resource instead of custom actions.
+
+## Code style (scoped, Fizzy-inspired)
+
+Directional rules. Apply them to **new code** and **methods/files you already touch**.
+Do not do churn-only refactors solely to “match style”.
+
+- Prefer expanded conditionals over guard clauses.
+  - Exception: early return at the very start of a method when the main body is non-trivial.
+- Method ordering in classes:
+  1) class methods
+  2) public methods (with `initialize` first)
+  3) private methods
+- Order methods vertically by invocation order (top-down flow).
+- Only use `!` when there is a corresponding non-`!` method.
+- No blank line after visibility modifiers; indent methods under them.
+- Thin controllers invoking rich domain APIs; avoid introducing “service artifacts” as glue.
+- Jobs should be shallow: enqueue via `*_later`, execute logic in `*_now` / domain methods.
+
+## Fail fast (avoid defensive programming)
+
+We prefer code to break loudly when something unexpected happens.
+
+- Avoid “defensive” checks that mask errors:
+  - `respond_to?`, `try`, dynamic `send` to avoid using the real API
+  - broad `rescue` that swallows exceptions
+  - returning nil/false as a fallback for unexpected states
+- Prefer explicit contracts:
+  - `find_by!` instead of `find_by` when it must exist
+  - `Hash#fetch` when a key must exist
+- Rescue only specific exceptions you truly handle, and keep handling intentional.
+
+## Architecture direction
+
+### Services (Actor gem) → POROs
+
+- Current state: there are service objects using the Actor gem.
+- Direction: migrate toward POROs inline with Rails/DHH style.
+- Do not add new Actor-based services.
+- Use the decision tree above to decide when to migrate.
+
+### Views: ViewComponents → Partials
+
+- Do not add new ViewComponents.
+- Prefer Rails partials under `app/views/shared/`.
+- Because we have 3 layouts (`public`, `application`, `admin`), prefer layout-aware shared folders:
+  - `app/views/shared/public/…`
+  - `app/views/shared/application/…`
+  - `app/views/shared/admin/…`
+- Pass data via `locals`; avoid relying on instance vars in shared partials.
+
+## Coding standards & optimization
+
+- Less is more: prefer less code without sacrificing readability.
+- Use clear, intention-revealing names; avoid vague names like `Manager`, `Handler`.
+- Performance:
+  - Avoid N+1 (`includes`, `preload`).
+  - Use DB constraints/indexes for new query patterns.
+  - Batch processing for large datasets (`find_each`, `insert_all`).
+- Dependencies:
+  - Do not add new dependencies for trivial tasks.
+  - Prefer stdlib / Rails built-ins already in the stack.
+
+## UI & Frontend
+
+- Tailwind v4 tokens live in `app/assets/tailwind/application.css`; use theme variables and brand classes.
+- Forms baseline: “Labels on left” layout.
+- Stimulus-first:
+  - Prefer controllers from `tailwindcss-stimulus-components` and `@stimulus-components/*`.
+  - New controllers must be generic, reusable, under `app/javascript/controllers/`, and registered in `controllers/index.js`.
+- Copy must follow `docs/brand.md`. Marketing pages must follow `docs/marketing/style-guide.md`.
+- No inline styles (`style="..."`). Use Tailwind utilities.
+- Prefer semantic HTML and accessibility basics (labels, autocomplete where appropriate).
+
+## Mailers
+
+- Mailer views live under `app/views/mailers/`.
+- Shared layout: `app/views/layouts/mailer.html.erb`
+- Prefer partials under `app/views/mailers/` for shared sections.
+- Use `premailer-rails` to inline styles.
+- Set `deliver_later_queue_name` to `:latency_5m` in mailers.
+
+## Testing (must follow)
+
+### What tests should do
+
+- Tests must cover application behavior, not framework behavior.
+- Tests must validate observable outcomes (rendered content, redirects, DB changes, enqueued jobs, outbound payloads).
+- Avoid:
+  - tautological tests (re-implementing method logic in the test)
+  - “Rails works” tests
+  - status-only assertions with no behavioral check
+  - heavy stubbing that can’t catch regressions
+
+### Practical rules
+
+- Framework: Minitest. Fixtures only (factories have been removed). Do not add factories.
+- Anatomy: setup (optional); exercise; assertions; cleanup (optional). Leave an empty line between sections.
+- Controller/system tests must assert status/redirect AND content (selectors/text) or side effects.
+- System tests: use `data-test-id` selectors; add `data-test-id` attributes in views when needed.
+- Keep review pages small in tests (~10) for speed and deterministic assertions.
+
+### HTTP / VCR / webhooks
+
+- WebMock enabled.
+- Outgoing API calls: recorded with VCR (see Project map for cassette location).
+  - VCR structure mirrors provider/API path segments.
+  - Filename: `{platform}_{resource}[optional_suffix].yml`.
+- Incoming webhooks: do not VCR. Use JSON captures (see Project map).
+
+Canonical pattern (webhook fixture ingestion):
+
+```ruby
+test "DataForSEO resolve with async mode" do
+  VCR.use_cassette("dataforseo/serp_google_maps_task_post/google_maps_page_resolve") do
+    result = Providers::Dataforseo::GoogleMaps::Page.new(
+      mode: :async,
+      recording: VCR.current_cassette.recording?,
+      platform: :google_maps
+    ).submit(
+      place_eid: @page.place_eid,
+      business_name: @location.name,
+      country: "GB"
+    )
+
+    assert_equal :scheduled, result.status
+
+    ExternalTask.create!(
+      record_uuid: @page.uuid,
+      record_type: @page.class.name,
+      provider: Providers::External::DATAFORSEO,
+      resource: Providers::Resources::PAGE,
+      eid: result.eid
+    )
+
+    payload = WebhookCapture.read(
+      provider: Providers::External::DATAFORSEO,
+      platform: :google_maps,
+      resource: Providers::Resources::PAGE,
+      task_eid: result.eid
+    )
+    assert_not_nil payload
+
+    response = Providers::Dataforseo::GoogleMaps::Page.new(
+      mode: :async,
+      platform: :google_maps
+    ).ingest(payload)
+
+    assert_equal :ok, response.status
+    assert_equal "ChIJrVtdwkDzdkgRHgNW25ELRtQ", response.data.place_eid
+  end
+end

data/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+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 -->🚀 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
+
+

data/Gemfile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+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
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,205 @@
+# git-markdown
+
+[![Gem Version](https://badge.fury.io/rb/git-markdown.svg)](https://badge.fury.io/rb/git-markdown)
+[![Ruby](https://github.com/ethos-link/git-markdown/actions/workflows/ruby.yml/badge.svg)](https://github.com/ethos-link/git-markdown/actions/workflows/ruby.yml)
+
+Convert GitHub pull requests into a single Markdown file you can review locally. Useful for offline or local AI review workflows with tools like [opencode](https://opencode.ai), GitHub Copilot CLI, and your own scripts.
+
+## Features
+
+- 🔐 Zero-config auth: uses your existing GitHub credentials
+- 🧾 Clean output: PR details, threads, and summaries in readable Markdown
+- 🧰 Practical controls: filter by status, write to file or stdout, debug when needed
+- 🏢 GitHub Enterprise support, plus safe local credential storage (XDG-style, tight perms)
+
+## Install
+
+```bash
+gem install git-markdown
+```
+
+## Quick start
+
+### 1) Setup (optional)
+
+```bash
+git-markdown setup
+```
+
+### 2) Export a PR
+
+From inside a git repository:
+
+```bash
+git-markdown pr 123
+```
+
+Or specify the repo:
+
+```bash
+git-markdown pr owner/repo#123
+```
+
+It saves `PR-{number}-{title}.md` in the current directory by default.
+
+## Usage
+
+```bash
+# Export PR from current repository
+git-markdown pr 123
+
+# Export PR from a specific repository
+git-markdown pr owner/repo#123
+
+# Output to stdout (useful for piping)
+git-markdown pr 123 --stdout | pbcopy  # macOS; on Linux use `xclip`/`wl-copy` or redirect to a file
+
+# Save to a directory
+git-markdown pr 123 --output ./reviews/
+
+# Filter comment threads (default: unresolved)
+git-markdown pr 123 --status=unresolved
+git-markdown pr 123 --status=resolved
+git-markdown pr 123 --status=all
+
+# Debug output
+git-markdown pr 123 --debug
+
+# Show version
+git-markdown version
+```
+
+## Authentication
+
+`git-markdown` looks for a GitHub token in this order:
+
+1. `GITHUB_TOKEN` or `GH_TOKEN` environment variables
+2. Git credential store (`git credential fill`)
+3. GitHub CLI (`gh auth token`)
+4. Token saved by `git-markdown setup`
+
+If you see a prompt for a GitHub username or an askpass error, set `GITHUB_TOKEN` or `GH_TOKEN` in your environment to skip git credential prompts.
+
+## GitHub Enterprise
+
+Set your API URL:
+
+```bash
+export GITHUB_API_URL=https://github.yourcompany.com/api/v3
+git-markdown pr owner/repo#123
+```
+
+## Output
+
+The generated Markdown includes:
+
+- PR metadata (title, author, status, created date)
+- PR description (full body)
+- Review comments grouped by file with line numbers
+- General discussion comments
+- Review summaries (approvals, change requests)
+
+Threads marked with `[resolved]` or `[done]` are filtered out by default. Use `--status=all` to include them.
+
+## Configuration
+
+Config is stored under `~/.config/git-markdown/`:
+
+- `config.yml` for settings (provider, API URL, defaults)
+- `credentials` for the token (permissions: 0600)
+
+## Requirements
+
+- Ruby 3.0+
+- Git (for remote detection)
+- GitHub Personal Access Token with `repo` scope
+
+## Development
+
+```bash
+git clone https://github.com/ethos-link/git-markdown.git
+cd git-markdown
+
+bundle install
+bundle exec rake test
+bundle exec standardrb
+bundle exec rake
+```
+
+Note: `Gemfile.lock` is intentionally not tracked to avoid conflicts across Ruby versions.
+
+### 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.
+
+Run the hook installer once per clone:
+
+```bash
+bundle exec lefthook install
+```
+
+### Install locally
+
+```bash
+rake install
+```
+
+## Release
+
+Releases are triggered by pushed tags and use `CHANGELOG.md` for GitHub release notes.
+
+If you want changelog automation, install `git-cliff` (<https://github.com/orhun/git-cliff>) locally and use it to update `CHANGELOG.md`.
+
+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 bumping, install dependencies:
+
+```bash
+bundle install
+```
+
+Then run:
+
+```bash
+# 1) Bump the version (commit created)
+bundle exec gem bump -v X.Y.Z
+
+# 2) Prepare release (changelog + tag + push)
+bundle exec rake release:prep
+```
+
+## Contributing
+
+1. Fork it
+2. Create a branch (`git checkout -b feature/my-feature`)
+3. Commit your changes
+4. Push (`git push origin feature/my-feature`)
+5. Open a Pull Request
+
+Please use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages.
+
+## Roadmap
+
+- [ ] GitLab Merge Request support (`git-markdown mr`)
+- [ ] GitLab and GitHub Issue support (`git-markdown issue`)
+- [ ] Custom templates
+- [ ] Optional diff in output
+
+## References
+
+- GitHub REST API docs: [docs.github.com/en/rest](https://docs.github.com/en/rest)
+- GitHub CLI auth token: [cli.github.com/manual/gh_auth_token](https://cli.github.com/manual/gh_auth_token)
+- Git credential interface: [git-scm.com/docs/git-credential](https://git-scm.com/docs/git-credential)
+- XDG Base Directory spec: [specifications.freedesktop.org/basedir-spec](https://specifications.freedesktop.org/basedir-spec/latest/)
+- RubyGems: [rubygems.org/gems/git-markdown](https://rubygems.org/)
+
+## License
+
+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.
+
+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.

data/Rakefile

@@ -0,0 +1,48 @@
+# 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"
+
+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]
+
+namespace :release do
+  desc "Update changelog, commit, and tag"
+  task :prep do
+    version = GitMarkdown::VERSION
+    branch = `git rev-parse --abbrev-ref HEAD`.strip
+
+    if branch == "HEAD"
+      abort "Release prep requires a branch (not detached HEAD)."
+    end
+
+    unless ["main", "master"].include?(branch)
+      abort "Release prep 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."
+    end
+
+    sh "git cliff -c cliff.toml --unreleased --tag v#{version} -o CHANGELOG.md"
+    if system("git diff --quiet -- CHANGELOG.md")
+      puts "No changelog changes. Skipping release prep."
+      next
+    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}"
+  end
+end

data/bin/git-markdown

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

data/cliff.toml

@@ -0,0 +1,53 @@
+[changelog]
+header = "# Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n"
+body = "{% if version %}## [{{ version | trim_start_matches(pat=\"v\") }}] - {{ timestamp | date(format=\"%Y-%m-%d\") }}\n{% endif %}\n{% for group, commits in commits | group_by(attribute=\"group\") %}{% if commits | length > 0 %}### {{ group }}\n{% for commit in commits %}- {{ commit.message | trim }}\n{% endfor %}\n\n{% endif %}{% endfor %}"
+trim = true
+
+[git]
+conventional_commits = true
+filter_unconventional = true
+tag_pattern = "v[0-9]*"
+
+[[commit_parsers]]
+message = '^feat(\(.*\))?:'
+group = "Added"
+
+[[commit_parsers]]
+message = '^fix(\(.*\))?:'
+group = "Fixed"
+
+[[commit_parsers]]
+message = '^docs(\(.*\))?:'
+group = "Documentation"
+
+[[commit_parsers]]
+message = '^refactor(\(.*\))?:'
+group = "Changed"
+
+[[commit_parsers]]
+message = '^perf(\(.*\))?:'
+group = "Changed"
+
+[[commit_parsers]]
+message = '^test(\(.*\))?:'
+group = "Changed"
+
+[[commit_parsers]]
+message = '^chore(\(.*\))?:'
+group = "Changed"
+
+[[commit_parsers]]
+message = '^build(\(.*\))?:'
+group = "Changed"
+
+[[commit_parsers]]
+message = '^ci(\(.*\))?:'
+group = "Changed"
+
+[[commit_parsers]]
+message = '^style(\(.*\))?:'
+group = "Changed"
+
+[[commit_parsers]]
+message = '^revert(\(.*\))?:'
+group = "Changed"

data/git-markdown.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |spec|
+  spec.name = "git-markdown"
+  spec.version = "0.1.0"
+  spec.authors = ["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.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"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "bin"
+  spec.executables = ["git-markdown"]
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "thor", "~> 1.0"
+
+  spec.add_development_dependency "minitest", "~> 6.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "standard", "~> 1.0"
+  spec.add_development_dependency "vcr", "~> 6.0"
+  spec.add_development_dependency "webmock", "~> 3.0"
+end

data/lefthook.yml

@@ -0,0 +1,6 @@
+commit-msg:
+  jobs:
+    - name: commitlint
+      run: bundle exec commitlint --message {1}
+    - name: standard
+      run: bundle exec rake standard