llm-docs-builder 0.9.3 → 0.9.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75429a83cfd019e7059f76a5fe7df200bff3bc14066c5f83e0739c85a5a68b63
-  data.tar.gz: 850d0568023dd1602cad0b48af5e6437b61f34f760c77b99adb565056313d241
+  metadata.gz: 66983a07a7271c966999350d03fbde1b1080ef0ac05a7209452cbb8720074e1b
+  data.tar.gz: 5d7cb81a700db6a43c17145af56ffcd2f6cea4a9a5182d4a2b14fd7772c8ee07
 SHA512:
-  metadata.gz: f0384e50c10837ec00e4d195115882d4fdaade5e522bba02929b028ac315d686324baf189bfc16803120b77718b28c10f2026e10f2f2bd3dd1ea7aab09f36549
-  data.tar.gz: 184e427780364d704067b1f84962fa7c658782ff2e048c991b34c06ca2643029d107872df1a0beac92cfb07076ae72cf9289527d534cad6274a99fdeaef22ac0
+  metadata.gz: 416b6f94c7e7dbac3bf3e6ae8793adcf9893d685aec29cc83665c2f9a6ab312bd422542e0074bbeec961f23740698aac6e517ebb7c87f3cb0fef3c8c6067c662
+  data.tar.gz: 2fba65092d82dbbeea60ce05317a781ed82f20367313d4eab9a69425e6e51f70ec106ca5f56218bbe255d1485752732de2a876359fde7018e706b948d51053fb

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.9.4 (2025-10-27)
+- [Feature] **Auto-Exclude Hidden Directories** - Hidden directories (starting with `.`) are now automatically excluded by default to prevent noise from `.git`, `.lint`, `.github`, etc.
+  - Adds `include_hidden: false` as default behavior
+  - Set `include_hidden: true` in config to include hidden directories if needed
+  - Uses `Find.prune` for efficient directory tree traversal
+  - Prevents scanning of common directories like `.lint`, `.gh`, `.git`, `node_modules` (if hidden)
+  - Fixed bug where root directory `.` was being pruned when used as docs_path
+- [Fix] **Excludes Pattern Matching** - Fixed fnmatch pattern handling for better glob pattern support.
+  - Fixed `**/.dir/**` patterns now correctly match root-level directories
+  - Normalized patterns ending with `/**` to `/**/*` for proper fnmatch behavior
+  - Handles `**/` prefix matching for zero-directory cases
+  - Fixed relative path calculation to avoid "different prefix" errors
+- [Test] Added unit tests for hidden directory exclusion feature (5 tests)
+- [Test] Added integration tests for hidden directory behavior (3 tests)
+
 ## 0.9.3 (2025-10-27)
 - [Fix] **Generate Command Excludes Support** - The `generate` command now properly respects the `excludes` configuration option to filter out files from llms.txt generation.
   - Added `should_exclude?` method to Generator class that matches files against glob patterns

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    llm-docs-builder (0.9.3)
+    llm-docs-builder (0.9.4)
       zeitwerk (~> 2.6)
 
 GEM

data/lib/llm_docs_builder/config.rb

@@ -100,6 +100,7 @@ module LlmDocsBuilder
         suffix: options[:suffix] || self['suffix'] || '.llm',
         excludes: options[:excludes] || self['excludes'] || [],
         bulk: options.key?(:bulk) ? options[:bulk] : (self['bulk'] || false),
+        include_hidden: options.key?(:include_hidden) ? options[:include_hidden] : (self['include_hidden'] || false),
         # New compression options
         remove_code_examples: if options.key?(:remove_code_examples)
                                 options[:remove_code_examples]

data/lib/llm_docs_builder/generator.rb

@@ -76,6 +76,13 @@ module LlmDocsBuilder
       files = []
 
       Find.find(docs_path) do |path|
+        # Skip hidden directories unless explicitly enabled
+        # Don't prune the root docs_path itself (even if it's ".")
+        if File.directory?(path) && path != docs_path && File.basename(path).start_with?('.') && !options[:include_hidden]
+          Find.prune
+          next
+        end
+
         next unless File.file?(path)
         next unless path.match?(/\.md$/i)
         next if File.basename(path).start_with?('.')
@@ -308,16 +315,38 @@ module LlmDocsBuilder
       return false if excludes.empty?
 
       # Get relative path from docs_path for matching
-      relative_path = if File.directory?(docs_path)
-                        Pathname.new(file_path).relative_path_from(Pathname.new(docs_path)).to_s
-                      else
-                        File.basename(file_path)
-                      end
+      relative_path = begin
+        if File.directory?(docs_path)
+          # Convert both to absolute paths first to avoid "different prefix" error
+          abs_file = File.expand_path(file_path)
+          abs_docs = File.expand_path(docs_path)
+          Pathname.new(abs_file).relative_path_from(Pathname.new(abs_docs)).to_s
+        else
+          File.basename(file_path)
+        end
+      rescue ArgumentError
+        # If paths can't be made relative (different roots), use basename
+        File.basename(file_path)
+      end
 
       excludes.any? do |pattern|
+        # Normalize pattern: ensure /** is followed by something
+        # fnmatch requires /** to be followed by at least one component
+        normalized_pattern = pattern.end_with?('/**') ? "#{pattern}/*" : pattern
+
         # Check both absolute and relative paths
-        File.fnmatch(pattern, file_path, File::FNM_PATHNAME | File::FNM_DOTMATCH) ||
-          File.fnmatch(pattern, relative_path, File::FNM_PATHNAME | File::FNM_DOTMATCH)
+        matches = File.fnmatch(normalized_pattern, file_path, File::FNM_PATHNAME | File::FNM_DOTMATCH) ||
+                  File.fnmatch(normalized_pattern, relative_path, File::FNM_PATHNAME | File::FNM_DOTMATCH)
+
+        # If pattern starts with **/, also try without it (for root-level matches)
+        # Since **/ in fnmatch doesn't match zero directories
+        if !matches && normalized_pattern.start_with?('**/')
+          pattern_without_prefix = normalized_pattern.sub(%r{^\*\*/}, '')
+          matches = File.fnmatch(pattern_without_prefix, file_path, File::FNM_PATHNAME | File::FNM_DOTMATCH) ||
+                    File.fnmatch(pattern_without_prefix, relative_path, File::FNM_PATHNAME | File::FNM_DOTMATCH)
+        end
+
+        matches
       end
     end
 

data/lib/llm_docs_builder/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm-docs-builder
 version: !ruby/object:Gem::Version
-  version: 0.9.3
+  version: 0.9.4
 platform: ruby
 authors:
 - Maciej Mensfeld