RubyGems - llm-docs-builder - Versions diffs - 1.0.0 → 1.1.0 - Mend

llm-docs-builder 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

checksums.yaml +4 -4
data/.github/workflows/ci.yml +10 -4
data/.github/workflows/docker.yml +3 -3
data/.github/workflows/push.yml +2 -2
data/.ruby-version +1 -1
data/CHANGELOG.md +30 -6
data/Gemfile.lock +13 -13
data/README.md +23 -11
data/lib/llm_docs_builder/bulk_transformer.rb +8 -3
data/lib/llm_docs_builder/generator.rb +74 -5
data/lib/llm_docs_builder/output_formatter.rb +1 -1
data/lib/llm_docs_builder/transformers/link_transformer.rb +320 -32
data/lib/llm_docs_builder/version.rb +1 -1
data/lib/llm_docs_builder.rb +1 -0
data/llm-docs-builder.yml.example +2 -2
data/package-lock.json +9 -9
metadata +2 -2

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1d023947b940a99bfa254d72ff79e47eef15f378eeb2e46ca2f04859b5da6dd
-  data.tar.gz: 85448c820f8fce92e9a26c094a9dd8cd485619ac45eb72ad45ed5b058ff2dc69
+  metadata.gz: c9ce6fbe87a426d69139719ecd76489c5aed030517167758ea0b2df452f3d636
+  data.tar.gz: 9ce3bfab8d25b4c3a9f11b899f20038da89463eb82ffde1b69106ce4934377c8
 SHA512:
-  metadata.gz: 9b345c53110799db9429b5185c1f773ae7ed99bdfa4da73f038cacad8cd319aa378f483f928a76d7f73533da08201f930f74b98e28a0246042e85d5269dc0d24
-  data.tar.gz: 6f876f2ec8b9e41a8daf1626b87e0cfb610fe164ff47231587ab3cbb78d2ea1ed699d06a24ea2927426ea7a227996828fbdc82c3a4abbc3e37883bee3277923d
+  metadata.gz: 9f98c868bfde76f265dd69854a43da9c67b48f5310234611105a6dec00a62236070461484b52c8e08c85cf9fd7bfcbffea0a85e92ce0943ac879b9dc532d3b77
+  data.tar.gz: 6a6340a373df54139338af837a7755b3148fdaef4d58810779cd88b5e2c5f1cca6edda231cee9e3cdace9cc60d465b14e0d78ecf41c3e338fb9fc40029d3f4c0

data/.github/workflows/ci.yml CHANGED Viewed

@@ -19,10 +19,12 @@ jobs:
   specs:
     timeout-minutes: 15
     runs-on: ubuntu-latest
+    continue-on-error: ${{ contains(matrix.ruby, 'preview') || contains(matrix.ruby, 'rc') }}
     strategy:
       fail-fast: false
       matrix:
         ruby:
+          - '4.1.0-preview1'
           - '4.0'
           - '3.4'
           - '3.3'
@@ -34,8 +36,12 @@ jobs:
         with:
           fetch-depth: 0
+      - name: Remove Gemfile.lock for Ruby preview versions
+        if: contains(matrix.ruby, 'preview') || contains(matrix.ruby, 'rc')
+        run: rm -f Gemfile.lock
       - name: Set up Ruby
-        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
+        uses: ruby/setup-ruby@7f797815d8adceb1c412e7abefdd1ab4abc47a5f # v1.335.0
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
@@ -60,9 +66,9 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       - name: Set up Ruby
-        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
+        uses: ruby/setup-ruby@7f797815d8adceb1c412e7abefdd1ab4abc47a5f # v1.335.0
         with:
-          ruby-version: '4.0.6'
+          ruby-version: '4.0.9'
           bundler-cache: true
       - name: Run yard-lint
         run: bundle exec yard-lint lib/
@@ -75,7 +81,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Set up Node.js
-        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
         with:
           node-version: '20'
           cache: 'npm'

data/.github/workflows/docker.yml CHANGED Viewed

@@ -45,10 +45,10 @@ jobs:
             type=raw,value=latest,enable={{is_default_branch}}
       - name: Set up QEMU
-        uses: docker/setup-qemu-action@96fe6ef7f33517b61c61be40b68a1882f3264fb8 # v4
+        uses: docker/setup-qemu-action@99012661954931238ded8c8b007157a8430204e1 # v4
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@bb05f3f5519dd87d3ba754cc423b652a5edd6d2c # v4
+        uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4
       - name: Login to Docker Hub
         if: github.event_name != 'pull_request'
@@ -66,7 +66,7 @@ jobs:
           password: ${{ secrets.GITHUB_TOKEN }}
       - name: Build and push
-        uses: docker/build-push-action@53b7df96c91f9c12dcc8a07bcb9ccacbed38856a # v7
+        uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7
         with:
           context: .
           platforms: linux/amd64,linux/arm64

data/.github/workflows/push.yml CHANGED Viewed

@@ -24,7 +24,7 @@ jobs:
           fetch-depth: 0
       - name: Set up Ruby
-        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
+        uses: ruby/setup-ruby@7f797815d8adceb1c412e7abefdd1ab4abc47a5f # v1.335.0
         with:
           bundler-cache: false
@@ -32,4 +32,4 @@ jobs:
         run: |
           bundle install --jobs 4 --retry 3
-      - uses: rubygems/release-gem@052cc82692552de3ef2b81fd670e41d13cba8092 # v1.4.0
+      - uses: rubygems/release-gem@7f9650160c1a4e7989fdc9855807bdbd421d8b6b # v1.4.1

data/.ruby-version CHANGED Viewed

	@@ -1 +1 @@
1	- 4.0.6
1	+ 4.0.9

data/CHANGELOG.md CHANGED Viewed

@@ -1,31 +1,55 @@
 # Changelog
-## [Unreleased]
+## 1.1.0 (2026-11-02)
+- [Enhancement] **Relative Link Resolution** - `base_url` link expansion now resolves relative links like a browser would.
+  - `../` and `./` segments are normalized (`../other.md` → `https://example.com/other.md` instead of `https://example.com/docs/../other.md`).
+  - `bulk-transform` resolves each link from its file's own directory, so `./setup.md` in `guides/intro.md` expands to `<base_url>/guides/setup.md`.
+  - Links starting with `/` resolve from `base_url`; anchors, query strings, absolute URLs and `mailto:`/`tel:`/`ftp:` links are unchanged.
+- [Fix] **llms.txt Paths Are Percent-Encoded** - `generate` now percent-encodes each path segment in `llms.txt` entries, with and without `base_url`.
+  - `docs/my docs/a b.md` gives `my%20docs/a%20b.md`, so names with spaces or parentheses no longer break the Markdown link.
+  - Non-ASCII names are encoded as UTF-8 (`zażółć.md` → `za%C5%BC%C3%B3%C5%82%C4%87.md`).
+- [Fix] **llms.txt Descriptions** - A page description is now always a single line, and the 200-character limit no longer cuts a Markdown link or image in half; a link or image that does not fit is left out.
+- [Fix] **Transformed Files Picked Up as Sources** - `bulk-transform` and `generate` now skip files ending with the transform suffix (`*.llm.md` by default, or `*<suffix>.md`).
+  - A second `bulk-transform` run no longer writes `*.llm.llm.md` files.
+  - `generate` lists each page once, from its source file, instead of listing both `README.md` and `README.llm.md`.
+  - Source files whose names end with the suffix (e.g. `notes.llm.md`) are skipped too. An empty suffix skips nothing.
+- [Fix] **Angle-Bracket Link Destinations** - `base_url` link expansion now resolves CommonMark `[text](<path with spaces>)` links like other relative links: the brackets are dropped and spaces are percent-encoded (`<../my docs/a b.md>` → `<base_url>/my%20docs/a%20b.md`) instead of producing a broken URL with a stray `>`.
+- [Fix] **Query-Only Links** - `base_url` link expansion now resolves a query-only link like `[q](?tab=2)` to the current page (`guides/sub/page.md` gives `<base_url>/guides/sub/page.md?tab=2`, as RFC 3986 does) instead of the page's directory (`<base_url>/guides/sub/?tab=2`). Anchor-only links like `#self` are unchanged.
+- [Fix] **`simplify_links` Strips Only One Prefix** - repeated filler prefixes are now all removed, so `Click here to see the docs` becomes `docs` (as documented) instead of `see the`.
+- [Fix] **Links Inside Code Are Rewritten** - link transformations (`base_url` expansion, `convert_urls`, `simplify_links`) no longer change links in fenced code blocks, indented code blocks and inline code spans.
+- [Fix] **`convert_urls` Skips Anchors, Queries and Relative Links** - `.html`/`.htm` URLs followed by an anchor or a query are now converted (`doc.html#sec` → `doc.md#sec`, `doc.html?x=1` → `doc.md?x=1`).
+  - Relative link targets are converted too, also without `base_url` (`[Intro](../intro.html)` → `[Intro](../intro.md)`).
+  - `.html` inside a query or an anchor and targets with a non-HTTP scheme (`mailto:`, `ftp:`, `sftp:`, `file:`, ...) are left unchanged.
+- [Fix] **Links With Brackets in Their Text** - `base_url` link expansion now expands links whose text holds brackets, nested up to two levels deep (`[a [b] c](../intro.md)`), and linked images like `[![alt](../img/a.png)](../intro.md)`, where both the image and the outer link are now expanded. Before, such links stayed relative, and a linked image got only its image expanded.
+- [Fix] **Links With Any URI Scheme** - `base_url` link expansion now leaves every link with a URI scheme unchanged, in any case (`HTTPS://`, `Mailto:`, `sftp:`, `ssh:`, `git:`, `irc:`, `urn:`, `data:`, `javascript:`, ...). Before, only lowercase `http`, `https`, `mailto`, `ftp` and `tel` links were kept, and others became broken URLs like `<base_url>/guides/sftp:/host/x`.
+- [Fix] **Link Reference Definitions** - `base_url` link expansion now expands reference-style link definitions (`[id]: ../intro.md "Title"`) like inline links, so `[text][id]`, `[id][]` and `[id]` links no longer stay relative while inline links in the same file are expanded. Titles are kept; definitions with a URI scheme, anchors, footnotes (`[^1]: ...`) and definitions in code are unchanged.
+  - `convert_urls` converts `.html`/`.htm` definition targets too (`[id]: ../intro.html` → `[id]: ../intro.md`).
+- [Fix] **`compare` Web Server Link** - The "Configure your web server" link in the `compare` output now points at the README section "Serving Optimized Docs to AI Bots" (`#serving-optimized-docs-to-ai-bots`) instead of a missing `#serving-optimized-docs` anchor.
 ## 1.0.0 (2026-08-24)
-- [Fix] **Link Expansion Corrupts Non-HTTP URI Schemes** — `LinkTransformer#expand_relative_links` no longer rewrites `mailto:`, `tel:`, and `ftp:` links into dead `https://...` URLs when `base_url` is set (#165).
+- [Fix] **Link Expansion Corrupts Non-HTTP URI Schemes** - `LinkTransformer#expand_relative_links` no longer rewrites `mailto:`, `tel:`, and `ftp:` links into dead `https://...` URLs when `base_url` is set (#165).
   - Any link whose scheme is in the known absolute-scheme list (`http`, `https`, `mailto`, `ftp`, `tel`) is now left untouched, matching `HtmlToMarkdownConverter`'s `SAFE_URI_SCHEMES`.
   - Relative links (e.g. `./guide.md`) continue to expand as before.
 - [Enhancement] Add Ruby warning category opt-in to test helpers
 ## 0.13.0 (2026-05-11)
 - [Breaking] Dropped Ruby 3.2 support. Minimum required Ruby version is now 3.3.
-- [Fix] **Heading Nesting in Normalize Mode** — Fixed `normalize_headings` producing incorrect heading levels when same-level headings are nested under a parent.
+- [Fix] **Heading Nesting in Normalize Mode** - Fixed `normalize_headings` producing incorrect heading levels when same-level headings are nested under a parent.
   - Consecutive same-level headings (e.g., two `##` headings) now correctly adjust the child's markdown level to be deeper than the parent's (e.g., `##` → `###`)
   - Effective level formula: `max(parent_effective_level + 1, original_level)`
   - ATX closing hashes (`## Title ##`) are now stripped from titles before building hierarchical paths
-- [Fix] **HTML-to-Markdown Section Nesting** — Headings inside nested `<section>` elements now receive adjusted markdown levels based on section nesting depth.
+- [Fix] **HTML-to-Markdown Section Nesting** - Headings inside nested `<section>` elements now receive adjusted markdown levels based on section nesting depth.
   - `<h2>` inside a nested `<section>` under another `<section>` with its own `<h2>` is now correctly rendered as `###` instead of `##`
 ## 0.12.0 (2025-11-12)
-- [Feature] **HTML to Markdown Reverse Converter** — Added support for converting HTML content to markdown format.
+- [Feature] **HTML to Markdown Reverse Converter** - Added support for converting HTML content to markdown format.
   - Enables processing of HTML documentation sources
   - Integrates seamlessly with the transformer pipeline
   - Useful for converting web-based docs to markdown for further processing
   - By @Eric-Guo in PR #32.
 ## 0.11.0 (2025-11-03)
-- [Feature] **Transform from URL** — The `transform` command now accepts a remote URL via `--url` and processes fetched content through the standard transformer pipeline.
+- [Feature] **Transform from URL** - The `transform` command now accepts a remote URL via `--url` and processes fetched content through the standard transformer pipeline.
   - Example: `llm-docs-builder transform --url https://example.com/docs/page.html`
   - Applies all configured transformations and output options identically to local files
   - By @Eric-Guo and @codex in PR #28.

data/Gemfile.lock CHANGED Viewed

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    llm-docs-builder (1.0.0)
+    llm-docs-builder (1.1.0)
       nokogiri (~> 1.17)
       zeitwerk (~> 2.6)
@@ -11,8 +11,8 @@ GEM
     ast (2.4.3)
     coderay (1.1.3)
     diff-lcs (1.6.2)
-    io-console (0.9.2)
-    json (2.21.2)
+    io-console (0.9.4)
+    json (3.0.2)
     language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
     method_source (1.1.0)
@@ -20,19 +20,19 @@ GEM
     nokogiri (1.19.4)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    parallel (2.1.0)
+    parallel (2.2.0)
     parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
     prism (1.9.0)
-    pry (0.16.0)
+    pry (0.16.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
       reline (>= 0.6.0)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.4.2)
-    regexp_parser (2.12.0)
+    regexp_parser (2.13.1)
     reline (0.7.0)
       io-console (~> 0.5)
     rspec (3.13.2)
@@ -48,8 +48,8 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.89.0)
-      json (~> 2.3)
+    rubocop (1.91.0)
+      json (>= 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
       parallel (>= 1.10)
@@ -63,13 +63,13 @@ GEM
       parser (>= 3.3.7.2)
       prism (~> 1.7)
     ruby-progressbar (1.13.0)
-    simplecov (1.1.1)
-    unicode-display_width (3.2.0)
-      unicode-emoji (~> 4.1)
-    unicode-emoji (4.2.0)
+    simplecov (1.3.2)
+    unicode-display_width (3.3.0)
+      unicode-emoji (~> 4.3)
+    unicode-emoji (4.3.0)
     warning (1.6.0)
     yard (0.9.45)
-    yard-lint (1.11.0)
+    yard-lint (1.13.0)
       yard (~> 0.9)
       zeitwerk (~> 2.6)
     zeitwerk (2.8.3)

data/README.md CHANGED Viewed

@@ -125,7 +125,7 @@ llm-docs-builder generate --config llm-docs-builder.yml
 ```yaml
 # llm-docs-builder.yml
 docs: ./docs
-base_url: https://myproject.io
+base_url: https://myproject.io  # Base URL for expanding relative links
 title: My Project
 description: Brief description
 body: Optional body content between description and sections
@@ -165,6 +165,12 @@ excludes:
   - "**/drafts/**"
 ```
+**Link expansion (`base_url`):** relative links become absolute URLs.
+- Inline links, images (also linked images, `[![alt](a.png)](../intro.md)`) and reference-style definitions (`[a]: ../intro.md`) are expanded. `<path with spaces>` destinations are resolved and their spaces encoded as `%20`.
+- `bulk-transform` resolves links from each file's directory under `docs`. Single-file `transform` (and `LlmDocsBuilder.transform_markdown`) resolves them from `base_url`: with `base_url: https://myproject.io/docs`, `../intro.md` becomes `https://myproject.io/intro.md`.
+- Links starting with `/` resolve from `base_url`. In `bulk-transform`, a query-only link (`[q](?tab=2)`) resolves to the current page (`.../page.md?tab=2`).
+- Left unchanged: links in fenced code, indented code and inline code; anchors (`#x`); protocol-relative URLs (`//cdn.io/a.md`); URLs with any scheme, in any case (`HTTPS:`, `sftp:`, `urn:`, `mailto:`); HTML `<a href>` and `<img src>`.
 ## CLI Commands
 ```bash
@@ -183,31 +189,34 @@ llm-docs-builder version                  # Show version
 -d, --docs PATH      Documentation path
 -o, --output PATH    Output file
 -u, --url URL        URL for comparison
+-f, --file PATH      Local markdown file for comparison
 -v, --verbose        Detailed output
 ```
 ## Serving Optimized Docs to AI Bots
-After using `bulk-transform` with `suffix: .llm`, configure your web server to serve optimized versions to AI bots:
+After using `bulk-transform` with `suffix: .llm`, configure your web server to serve optimized versions to AI bots. Pages without an `.llm.md` version are served as is:
 **Apache (.htaccess):**
 ```apache
 SetEnvIf User-Agent "(?i)(openai|anthropic|claude|gpt)" IS_LLM_BOT
+RewriteEngine On
 RewriteCond %{ENV:IS_LLM_BOT} !^$
+RewriteCond %{REQUEST_URI} !\.llm\.md$
+RewriteCond %{REQUEST_FILENAME} ^(.+)\.md$
+RewriteCond %1.llm.md -f
 RewriteRule ^(.*)\.md$ $1.llm.md [L]
 ```
 **Nginx:**
 ```nginx
-map $http_user_agent $is_llm_bot {
-    default 0;
-    "~*(?i)(openai|anthropic|claude|gpt)" 1;
+map $http_user_agent $llm_suffix {
+    default "";
+    "~*(openai|anthropic|claude|gpt)" ".llm";
 }
-location ~ ^/docs/(.*)\.md$ {
-    if ($is_llm_bot) {
-        rewrite ^(.*)\.md$ $1.llm.md last;
-    }
+location ~ ^/docs/(?<doc>.*)\.md$ {
+    try_files /docs/$doc$llm_suffix.md $uri =404;
 }
 ```
@@ -258,7 +267,10 @@ api = API.new
 ```markdown
 # API Documentation
-[complete API documentation](./api.md)
+> Important: This is a note
+[Click here to see the complete API documentation](./api.md)
 api = API.new
 ```
@@ -411,7 +423,7 @@ All compression features can be used individually for fine-grained control:
 - `generate_toc: true` - Generate table of contents from headings with anchor links
 - `custom_instruction: "text"` - Inject AI context message at document top
 - `simplify_links: true` - Simplify verbose link text (e.g., "Click here to see the docs" → "docs")
-- `convert_urls: true` - Convert `.html`/`.htm` URLs to `.md` format
+- `convert_urls: true` - Convert `.html`/`.htm` URLs to `.md` format, keeping anchors and queries (`../intro.html#x` → `../intro.md#x`): absolute `http(s)` URLs anywhere in the text, and relative link and reference-style definition targets. URLs in code are unchanged
 - `normalize_whitespace: true` - Reduce excessive blank lines and remove trailing whitespace
 ## License

data/lib/llm_docs_builder/bulk_transformer.rb CHANGED Viewed

@@ -76,16 +76,19 @@ module LlmDocsBuilder
     # Recursively scans the docs directory for markdown files
     #
-    # Skips hidden files (starting with dot) and returns sorted array of paths
+    # Skips hidden files (starting with dot) and already transformed files (ending with
+    # the suffix, e.g. README.llm.md) and returns sorted array of paths
     #
     # @return [Array<String>] paths to markdown files
     def find_markdown_files
       files = []
+      output_ending = "#{options[:suffix]}.md".downcase
       Find.find(docs_path) do |path|
         next unless File.file?(path)
         next unless path.match?(/\.md$/i)
         next if File.basename(path).start_with?('.')
+        next if output_ending != '.md' && path.downcase.end_with?(output_ending)
         files << path
       end
@@ -109,12 +112,14 @@ module LlmDocsBuilder
     # Applies markdown transformations to a single file
     #
-    # Creates MarkdownTransformer instance and delegates transformation
+    # Creates MarkdownTransformer instance and delegates transformation. Passes the file's
+    # path relative to the docs directory so relative links resolve from its own location.
     #
     # @param file_path [String] path to markdown file
     # @return [String] transformed content
     def transform_file(file_path)
-      transformer = MarkdownTransformer.new(file_path, options)
+      source_path = Pathname.new(file_path).relative_path_from(Pathname.new(docs_path)).to_s
+      transformer = MarkdownTransformer.new(file_path, options.merge(source_path: source_path))
       transformer.transform
     end

data/lib/llm_docs_builder/generator.rb CHANGED Viewed

@@ -12,6 +12,10 @@ module LlmDocsBuilder
   #
   # @api public
   class Generator
+    # Maximum length of a file description in llms.txt, in characters
+    MAX_DESCRIPTION_LENGTH = 200
+    private_constant :MAX_DESCRIPTION_LENGTH
     # @return [String] path to documentation directory or file
     attr_reader :docs_path
@@ -27,6 +31,7 @@ module LlmDocsBuilder
     # @option options [String] :description project description (overrides auto-detection)
     # @option options [String] :output output file path for saving
     # @option options [Boolean] :verbose enable verbose output
+    # @option options [String] :suffix suffix of bulk-transformed files to skip (default: '.llm')
     def initialize(docs_path, options = {})
       @docs_path = docs_path
       @options = options
@@ -68,11 +73,13 @@ module LlmDocsBuilder
     # Recursively finds and analyzes markdown files in directory
     #
-    # Sorts by priority (README, guides, etc.) and skips hidden files
+    # Sorts by priority (README, guides, etc.) and skips hidden files and bulk-transformed
+    # files (ending with the suffix, e.g. README.llm.md)
     #
     # @return [Array<Hash>] sorted array of analyzed file metadata
     def find_markdown_files_in_directory
       files = []
+      output_ending = "#{options.fetch(:suffix, '.llm')}.md".downcase
       Find.find(docs_path) do |path|
         # Skip hidden directories unless explicitly enabled
@@ -85,6 +92,7 @@ module LlmDocsBuilder
         next unless File.file?(path)
         next unless path.match?(/\.md$/i)
         next if File.basename(path).start_with?('.')
+        next if output_ending != '.md' && path.downcase.end_with?(output_ending)
         next if should_exclude?(path)
         files << analyze_file(path)
@@ -157,7 +165,8 @@ module LlmDocsBuilder
     # Extracts description from file content
     #
-    # Takes first paragraph after title, truncated to 200 characters
+    # Takes first paragraph after title as a single line, truncated to MAX_DESCRIPTION_LENGTH characters.
+    # A Markdown link or image that would be cut by the limit is dropped entirely.
     #
     # @param content [String] file content
     # @return [String] extracted description
@@ -170,7 +179,62 @@ module LlmDocsBuilder
       # Get first paragraph
       first_paragraph = description_lines.take_while { |line| !line.strip.empty? }
-      first_paragraph.join(' ').strip.slice(0, 200)
+      description = first_paragraph.join(' ').gsub(/\s+/, ' ').strip
+      return description if description.length <= MAX_DESCRIPTION_LENGTH
+      cut_link = link_spans(description).find do |span|
+        span.begin < MAX_DESCRIPTION_LENGTH && span.end >= MAX_DESCRIPTION_LENGTH
+      end
+      return description.slice(0, MAX_DESCRIPTION_LENGTH) unless cut_link
+      description.slice(0, cut_link.begin).rstrip
+    end
+    # Finds the character ranges of Markdown links and images in text
+    #
+    # Brackets and parentheses are matched by nesting depth, so linked images, nested link text, URLs
+    # with parentheses and reference links are each one range. An unclosed bracket is not a link.
+    #
+    # @param text [String] single-line text
+    # @return [Array<Range>] inclusive index ranges
+    def link_spans(text)
+      closing = closing_indexes(text)
+      spans = []
+      index = 0
+      while (start = text.index('[', index))
+        stop = closing[start]
+        index = start + 1
+        next unless stop
+        stop = closing[stop + 1] while closing[stop + 1]
+        start -= 1 if start.positive? && text[start - 1] == '!'
+        spans << (start..stop)
+        index = stop + 1
+      end
+      spans
+    end
+    # Maps the index of each opening bracket or parenthesis to the index of the one that closes it
+    #
+    # @param text [String] text to search
+    # @return [Hash{Integer => Integer}] closing index by opening index, unclosed ones are absent
+    def closing_indexes(text)
+      closing = {}
+      open_indexes = { '[' => [], '(' => [] }
+      pairs = { ']' => '[', ')' => '(' }
+      text.each_char.with_index do |char, index|
+        if open_indexes.key?(char)
+          open_indexes[char] << index
+        elsif pairs.key?(char) && (opened = open_indexes[pairs[char]].pop)
+          closing[opened] = index
+        end
+      end
+      closing
     end
     # Assigns priority to file based on filename patterns
@@ -310,13 +374,18 @@ module LlmDocsBuilder
     # Constructs full URL from path using base_url option if provided
     #
+    # Each path segment is percent-encoded, so names with spaces, parentheses or
+    # non-ASCII characters give a valid Markdown link destination.
+    #
     # @param path [String] relative path to file
     # @return [String] full URL or relative path
     def build_url(path)
+      encoded_path = path.split('/').map { |segment| ERB::Util.url_encode(segment) }.join('/')
       if (base_url = options[:base_url])
-        File.join(base_url, path)
+        File.join(base_url, encoded_path)
       else
-        path
+        encoded_path
       end
     end

data/lib/llm_docs_builder/output_formatter.rb CHANGED Viewed

@@ -128,7 +128,7 @@ module LlmDocsBuilder
       puts '   llm-docs-builder bulk-transform --docs ./docs --config llm-docs-builder.yml'
       puts ''
       puts '2. Configure your web server to serve .md files to AI bots:'
-      puts '   See: https://github.com/mensfeld/llm-docs-builder#serving-optimized-docs'
+      puts '   See: https://github.com/mensfeld/llm-docs-builder#serving-optimized-docs-to-ai-bots'
       puts ''
       puts '3. Measure your actual savings:'
       puts '   llm-docs-builder compare --url <your-url> --file <local-md>'

data/lib/llm_docs_builder/transformers/link_transformer.rb CHANGED Viewed

@@ -15,61 +15,349 @@ module LlmDocsBuilder
       # @param content [String] markdown content
       # @param options [Hash] transformation options
       # @option options [String] :base_url base URL for expanding relative links
+      # @option options [String] :source_path path of the transformed file relative to the
+      #   docs root, used to resolve relative links against the file's own directory
       # @option options [Boolean] :convert_urls convert HTML URLs to markdown format
       # @return [String] transformed content
+      # @note Code (fenced and indented code blocks, inline code spans) is left unchanged
       def transform(content, options = {})
-        result = content.dup
-        result = expand_relative_links(result, options[:base_url]) if options[:base_url]
-        result = convert_html_urls(result) if options[:convert_urls]
-        result = simplify_links(result) if options[:simplify_links]
+        outside_code(content) do |result|
+          if options[:base_url]
+            result = expand_relative_links(
+              result, options[:base_url], options[:source_path], convert_urls: options[:convert_urls]
+            )
+          end
+          result = convert_html_urls(result, convert_definitions: !options[:base_url]) if options[:convert_urls]
+          result = simplify_links(result) if options[:simplify_links]
-        result
+          result
+        end
       end
       private
-      # URI schemes that must never be treated as relative paths when expanding
-      # links with a base URL (kept in sync with the converter's safe schemes)
-      ABSOLUTE_URL_SCHEMES = %w[http https mailto ftp tel].freeze
+      # A link target with a URI scheme is never a relative path
+      URI_SCHEME_PATTERN = /\A[a-z][a-z0-9+.-]*:/i
+      private_constant :URI_SCHEME_PATTERN
+      # Placeholder that stands in for a protected code fragment; a code block's ends with `b`
+      CODE_PLACEHOLDER = /\u0000(\d+)b?\u0000/
+      # Inline code span: a backtick run closed by a run of the same length, within one paragraph
+      INLINE_CODE = /(?<![`\\])(`+)(?!`)(?:(?!\n[ \t]*\n)[^\u0000])+?(?<!`)\1(?!`)/m
+      # Opening line of a fenced code block
+      FENCE_OPENING = /\A[ \t]*(`{3,}|~{3,})/
+      # Blockquote markers at the start of a line
+      BLOCKQUOTE_PREFIX = /\A(?: {0,3}> ?)*/
+      # Line that starts a list item
+      LIST_ITEM = /\A {0,3}(?:[-+*]|\d{1,9}[.)])(?:[ \t]|\s*\z)/
+      # Contents of a bracket pair in a link text: plain text, images and brackets that do not open a link
+      # (links do not nest)
+      BRACKET_CONTENT_PATTERN = /(?:[^\[\]]|!\[[^\[\]]*\]|\[[^\[\]]*\](?!\())*/
+      # Part of a link text: brackets in it may be nested up to two levels deep (e.g. a linked image)
+      LINK_TEXT_PART_PATTERN = /[^\[\]]|!\[#{BRACKET_CONTENT_PATTERN}\]|\[#{BRACKET_CONTENT_PATTERN}\](?!\()/
+      # Link destination; it never runs into protected code, only its title may contain it
+      LINK_DESTINATION_PATTERN = /\(([^)\u0000]+(?:\s+(?:"[^")]*"|'[^')]*'))?)\)/
+      # Inline link
+      LINK_PATTERN = /\[((?:#{LINK_TEXT_PART_PATTERN})+)\]#{LINK_DESTINATION_PATTERN}/
+      # Inline link or image inside a link text, where an image may have no alt text (`[![](badge.svg)](url)`)
+      NESTED_LINK_PATTERN = /\[((?:#{LINK_TEXT_PART_PATTERN})*)\]#{LINK_DESTINATION_PATTERN}/
+      # Link reference definition line (`[id]: target "title"`): its label, destination and the rest of the line.
+      # Footnote definitions (`[^1]: text`) are not link reference definitions.
+      REFERENCE_DEFINITION_PATTERN = /
+        ^((?:\ {0,3}>\ ?)*\ {0,3}\[(?!\^)(?:[^\[\]\\\n]|\\.)+\]:[ \t]*)
+        (<[^<>\n]*>|[^\s<\u0000][^\s\u0000]*)
+        ((?:[ \t]+(?:"[^"\n]*"|'[^'\n]*'|\([^()\n]*\)))?[ \t\r]*)$
+      /x
+      # Consecutive link reference definition lines
+      REFERENCE_DEFINITIONS_PATTERN = /#{REFERENCE_DEFINITION_PATTERN}(?:\n#{REFERENCE_DEFINITION_PATTERN})*/
+      # Line that link reference definitions may follow: a blank line, an ATX heading, a thematic break or a code
+      # block. A definition cannot interrupt a paragraph.
+      REFERENCE_DEFINITIONS_PRECEDING_LINE_PATTERN = /
+        (?:\ {0,3}>\ ?)*
+        (?:
+          [ \t]* |
+          \ {0,3}\#{1,6}(?:[ \t][^\n]*)? |
+          \ {0,3}(?:(?:\*[ \t]*){3,}|(?:-[ \t]*){3,}|(?:_[ \t]*){3,}) |
+          \u0000\d+b\u0000[ \t]*
+        )\r?
+      /x
+      # Definitions on the first or second line of the content
+      LEADING_REFERENCE_DEFINITIONS_PATTERN =
+        /\A(?:#{REFERENCE_DEFINITIONS_PRECEDING_LINE_PATTERN}\n)?\K#{REFERENCE_DEFINITIONS_PATTERN}/
+      # Definitions from the third line on, so that they never overlap the leading ones. Kept apart from the leading
+      # pattern: an `\A` alternative here would make the regex try every position of the content.
+      FOLLOWING_REFERENCE_DEFINITIONS_PATTERN =
+        /\n#{REFERENCE_DEFINITIONS_PRECEDING_LINE_PATTERN}\n\K#{REFERENCE_DEFINITIONS_PATTERN}/
+      private_constant :CODE_PLACEHOLDER, :INLINE_CODE, :FENCE_OPENING, :BLOCKQUOTE_PREFIX, :LIST_ITEM,
+        :BRACKET_CONTENT_PATTERN, :LINK_TEXT_PART_PATTERN, :LINK_DESTINATION_PATTERN, :LINK_PATTERN,
+        :NESTED_LINK_PATTERN, :REFERENCE_DEFINITION_PATTERN, :REFERENCE_DEFINITIONS_PATTERN,
+        :REFERENCE_DEFINITIONS_PRECEDING_LINE_PATTERN, :LEADING_REFERENCE_DEFINITIONS_PATTERN,
+        :FOLLOWING_REFERENCE_DEFINITIONS_PATTERN
+      # Run a transformation on content with code replaced by placeholders, then restore the code
+      #
+      # @param content [String] markdown content
+      # @yieldparam text [String] content with code fragments replaced by placeholders
+      # @yieldreturn [String] transformed content
+      # @return [String] transformed content with the original code restored
+      def outside_code(content)
+        codes = []
+        protect = lambda do |code, block: false|
+          codes << code
+          "\u0000#{codes.size - 1}#{'b' if block}\u0000"
+        end
+        text = protect_code_blocks(content, protect)
+        text = text.gsub(INLINE_CODE) { protect.call(::Regexp.last_match(0)) }
+        yield(text).gsub(CODE_PLACEHOLDER) { codes[::Regexp.last_match(1).to_i] }
+      end
+      # Replace fenced and indented code blocks with placeholders
+      #
+      # Indented lines count as code only after a blank line and outside lists, where they would otherwise be
+      # paragraph or list item continuations. Code inside blockquotes is detected after the `>` markers.
+      #
+      # @param content [String] markdown content
+      # @param protect [Proc] stores a code fragment and returns its placeholder
+      # @return [String] content with code blocks replaced
+      def protect_code_blocks(content, protect)
+        out = +''
+        code = +''
+        fence = nil
+        fence_depth = 0
+        depth = 0
+        in_list = false
+        prev_blank = true
+        content.each_line do |line|
+          quote = line[BLOCKQUOTE_PREFIX]
+          body = line.delete_prefix(quote)
+          prev_blank ||= quote.count('>') > depth
+          depth = quote.count('>')
+          fence = nil if depth < fence_depth
+          if fence
+            code << line
+            closing = line.sub(/\A(?: {0,3}> ?){#{fence_depth}}/, '')
+            fence = nil if closing.match?(/\A[ \t]*#{Regexp.escape(fence)}#{Regexp.escape(fence[0])}*\s*\z/)
+            prev_blank = true
+            next
+          end
+          if !in_list && (prev_blank || !code.empty?) && indented_code?(body)
+            code << line
+            next
+          end
+          if (fence = fence_opening(body))
+            fence_depth = depth
+            code << line
+            next
+          end
+          out << protect_lines(code, protect) << line
+          code = +''
+          in_list = in_list_after?(body, in_list, prev_blank)
+          prev_blank = body.strip.empty?
+        end
+        out << protect_lines(code, protect)
+      end
+      # Fence of a line that opens a fenced code block
+      #
+      # @param line [String] markdown line
+      # @return [String, nil] the opening fence, or nil when the line does not open a block
+      def fence_opening(line)
+        opening = line.match(FENCE_OPENING)
+        return unless opening
+        return if opening[1].start_with?('`') && opening.post_match.include?('`')
+        opening[1]
+      end
+      # Check whether a line is indented enough to be code
+      #
+      # @param line [String] markdown line
+      # @return [Boolean] true for a non-blank line indented by four spaces or a tab
+      def indented_code?(line)
+        line.match?(/\A(?: {4}|\t)\s*\S/)
+      end
+      # Check whether content after a line is still inside a list
+      #
+      # @param line [String] markdown line
+      # @param in_list [Boolean] whether the previous line was inside a list
+      # @param prev_blank [Boolean] whether the previous line was blank
+      # @return [Boolean] true when the list continues after this line
+      def in_list_after?(line, in_list, prev_blank)
+        return true if line.match?(LIST_ITEM)
+        return in_list if line.strip.empty? || !prev_blank || line.match?(/\A[ \t]/)
+        false
+      end
+      # Replace collected code lines with a placeholder, keeping the final line break
+      #
+      # @param code [String] collected code lines
+      # @param protect [Proc] stores a code fragment and returns its placeholder
+      # @return [String] placeholder, or an empty string when there is no code
+      def protect_lines(code, protect)
+        return '' if code.empty?
+        body = code.chomp
+        "#{protect.call(body, block: true)}#{code.delete_prefix(body)}"
+      end
-      # Expand relative links to absolute URLs
+      # Expand relative links and link reference definitions to absolute URLs
       #
       # @param content [String] markdown content
       # @param base_url [String] base URL for expansion
+      # @param source_path [String, nil] path of the file relative to the docs root
+      # @param convert_urls [Boolean] also convert HTML targets of link reference definitions to markdown, so the
+      #   definitions are scanned only once
       # @return [String] content with expanded links
-      def expand_relative_links(content, base_url)
-        content.gsub(/\[([^\]]+)\]\(([^)]+)\)/) do |match|
-          text = ::Regexp.last_match(1)
-          url = ::Regexp.last_match(2)
+      def expand_relative_links(content, base_url, source_path = nil, convert_urls: false)
+        result = expand_links_matching(content, LINK_PATTERN, base_url, source_path)
+        rewrite_reference_definitions(result) do |target|
+          expanded = expand_target(target, base_url, source_path)
+          convert_urls ? convert_html_target(expanded) : expanded
+        end
+      end
+      # Rewrite the destinations of link reference definitions
+      #
+      # @param content [String] markdown content
+      # @yieldparam target [String] destination of a definition
+      # @yieldreturn [String] new destination
+      # @return [String] content with rewritten definitions
+      def rewrite_reference_definitions(content)
+        return content unless content.include?(']:')
+        rewrite = lambda do |definitions|
+          definitions.gsub(REFERENCE_DEFINITION_PATTERN) do
+            match = ::Regexp.last_match
-          if url.start_with?('http://', 'https://', '//', '#') || absolute_url_scheme?(url)
-            match
-          else
-            clean_url = url.gsub(%r{^\./}, '')
-            expanded_url = File.join(base_url, clean_url)
-            "[#{text}](#{expanded_url})"
+            "#{match[1]}#{yield(match[2])}#{match[3]}"
           end
         end
+        content
+          .sub(LEADING_REFERENCE_DEFINITIONS_PATTERN, &rewrite)
+          .gsub(FOLLOWING_REFERENCE_DEFINITIONS_PATTERN, &rewrite)
       end
-      # Check whether a link target uses a known absolute URI scheme
+      # Expand relative links that match a pattern, and the links and images in their link text
       #
-      # @param url [String] link target
-      # @return [Boolean] true when the target already carries its own scheme
-      def absolute_url_scheme?(url)
-        scheme = url.split(':', 2).first.to_s
-        ABSOLUTE_URL_SCHEMES.include?(scheme)
+      # @param content [String] markdown content
+      # @param pattern [Regexp] pattern of the links to expand
+      # @param base_url [String] base URL for expansion
+      # @param source_path [String, nil] path of the file relative to the docs root
+      # @return [String] content with expanded links
+      def expand_links_matching(content, pattern, base_url, source_path)
+        content.gsub(pattern) do
+          url = ::Regexp.last_match(2)
+          text = expand_links_matching(::Regexp.last_match(1), NESTED_LINK_PATTERN, base_url, source_path)
+          "[#{text}](#{expand_target(url, base_url, source_path)})"
+        end
+      end
+      # Expand a link target unless it is absolute, protocol-relative or an anchor
+      #
+      # @param target [String] link target, optionally followed by a link title
+      # @param base_url [String] base URL for expansion
+      # @param source_path [String, nil] path of the file relative to the docs root
+      # @return [String] expanded or unchanged target
+      def expand_target(target, base_url, source_path)
+        destination = target.delete_prefix('<')
+        return target if destination.start_with?('//', '#') || destination.match?(URI_SCHEME_PATTERN)
+        resolve_relative_url(base_url, target, source_path)
+      end
+      # Resolve a relative link target against the base URL
+      #
+      # Targets starting with `/` are resolved from the base URL itself, other targets from the source
+      # file's directory. `./` and `../` segments are normalized. Titles, queries and anchors are kept.
+      # Angle-bracket destinations (`<path with spaces>`) are unwrapped and their spaces percent-encoded.
+      # A query-only target (`?tab=2`) resolves to the source file itself, as in RFC 3986, with its
+      # name percent-encoded.
+      #
+      # @param base_url [String] base URL for expansion
+      # @param target [String] relative link target, optionally followed by a link title
+      # @param source_path [String, nil] path of the source file relative to the docs root
+      # @return [String] expanded URL
+      def resolve_relative_url(base_url, target, source_path)
+        url, title = target.match(/\A(.*?)(\s+(?:"[^"]*"|'[^']*'))?\z/m).captures
+        url = url[/\A<(.*)>\z/m, 1]&.gsub(' ', '%20') || url
+        path, suffix = url.match(/\A([^?#]*)(.*)\z/m).captures
+        query_only = source_path && path.empty? && suffix.start_with?('?')
+        path = ERB::Util.url_encode(File.basename(source_path)) if query_only
+        source_dir = source_path ? File.dirname(source_path) : '.'
+        origin = base_url[%r{\A[^:/?#]+://[^/?#]*}].to_s
+        base_path = base_url.delete_prefix(origin)
+        dir = path.start_with?('/') ? base_path : File.join(base_path, source_dir)
+        "#{origin}#{normalize_path("#{dir}/#{path}")}#{suffix}#{title}"
+      end
+      # Normalize `.`, `..` and empty segments of a path
+      #
+      # @param path [String] path to normalize
+      # @return [String] normalized path, with its trailing slash kept
+      def normalize_path(path)
+        normalized = Pathname.new(path).cleanpath.to_s
+        normalized += '/' if path.match?(%r{/\.{0,2}\z}) && !normalized.end_with?('/')
+        normalized
       end
       # Convert HTML URLs to markdown format
       #
+      # Converts absolute URLs anywhere in the content and relative link and link reference definition targets,
+      # keeping queries and anchors.
+      #
       # @param content [String] markdown content
+      # @param convert_definitions [Boolean] whether to convert link reference definition targets
       # @return [String] content with converted URLs
-      def convert_html_urls(content)
-        content.gsub(%r{https?://[^\s<>]+\.html?(?=[)\s]|$)}) do |url|
-          url.sub(/\.html?$/, '.md')
+      def convert_html_urls(content, convert_definitions: true)
+        result = content.gsub(%r{https?://[^\s<>?#]+?\.html?(?=[?#)\s]|$)}) do |url|
+          url.sub(/\.html?\z/, '.md')
+        end
+        result = result.gsub(/\]\(([^)\s?#]+?)\.html?(?=[?#)\s])/) do |match|
+          path = ::Regexp.last_match(1)
+          path.match?(URI_SCHEME_PATTERN) ? match : "](#{path}.md"
         end
+        return result unless convert_definitions
+        rewrite_reference_definitions(result) { |target| convert_html_target(target) }
+      end
+      # Convert a relative HTML link reference definition target to markdown
+      #
+      # @param target [String] destination of a definition
+      # @return [String] converted or unchanged target
+      def convert_html_target(target)
+        target.match?(URI_SCHEME_PATTERN) ? target : target.sub(/\A([^?#]+?)\.html?(?=[?#]|\z)/, '\1.md')
       end
       # Simplify verbose link text
@@ -77,14 +365,14 @@ module LlmDocsBuilder
       # @param content [String] markdown content
       # @return [String] content with simplified links
       def simplify_links(content)
-        content.gsub(/\[([^\]]+)\]\(([^)]+)\)/) do
+        content.gsub(LINK_PATTERN) do
           text = ::Regexp.last_match(1)
           url = ::Regexp.last_match(2)
           simplified_text = text
-                            .gsub(/^(click here to|see|read more about|check out|visit)\s+(the\s+)?/i, '')
+                            .gsub(/^(?:(?:click here to|see|read more about|check out|visit)\s+(?:the\s+)?)+/i, '')
                             .gsub(/\s+(here|documentation|docs)$/i, '')
-                            .strip
+                            .gsub(/\A\s+|\s+\z/, '') # String#strip also removes the NUL of code placeholders
           simplified_text = text if simplified_text.empty?

data/lib/llm_docs_builder/version.rb CHANGED Viewed

@@ -2,5 +2,5 @@
 module LlmDocsBuilder
   # Current version of the LlmDocsBuilder gem
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/lib/llm_docs_builder.rb CHANGED Viewed

@@ -6,6 +6,7 @@ require 'find'
 autoload(:Nokogiri, 'nokogiri')
 autoload(:CGI, 'cgi')
+autoload(:ERB, 'erb')
 loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect('cli' => 'CLI')

data/llm-docs-builder.yml.example CHANGED Viewed

@@ -1,5 +1,5 @@
-# Example llms-txt.yml configuration file
-# Copy to llms-txt.yml and customize for your project
+# Example llm-docs-builder.yml configuration file
+# Copy to llm-docs-builder.yml and customize for your project
 # Path to documentation directory or file
 docs: ./docs

data/package-lock.json CHANGED Viewed

@@ -103,9 +103,9 @@
       }
     },
     "node_modules/fastq": {
-      "version": "1.20.1",
-      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz",
-      "integrity": "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==",
+      "version": "1.20.3",
+      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.3.tgz",
+      "integrity": "sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==",
       "dev": true,
       "license": "ISC",
       "dependencies": {
@@ -286,9 +286,9 @@
       }
     },
     "node_modules/smol-toml": {
-      "version": "1.8.0",
-      "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.8.0.tgz",
-      "integrity": "sha512-kCZr2V3ch9i00x8zXRhjUNVcjG9ijES5dDudkXvUVCT5QlJNQWElSJdZqyPemffHoLNUYwOcou0Fy+ojN0uHSQ==",
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.9.0.tgz",
+      "integrity": "sha512-hpd+HLON7HdZXqYchMM/+LaTTbdK0AU3NngIJ4KVyWbY9bfQqdL9cD+4yf6dUoU2Ap4VsU0JkQi6FxAI1B2mXQ==",
       "dev": true,
       "license": "BSD-3-Clause",
       "engines": {
@@ -312,9 +312,9 @@
       }
     },
     "node_modules/yaml": {
-      "version": "2.9.0",
-      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz",
-      "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==",
+      "version": "2.9.1",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.1.tgz",
+      "integrity": "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==",
       "dev": true,
       "license": "ISC",
       "bin": {

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm-docs-builder
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -201,7 +201,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Build and optimize documentation for LLMs - generate llms.txt, transform
   markdown, and more