rtfm-filemanager 7.4.0 → 7.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f6bc5298e93ba60c9624f256fb1682476a581e6fdfb80f3995beba600ea20eb
-  data.tar.gz: 36deb1eeacea20c36d354b6c221a41efb7d8f9ee3f093ae8a2905d730e6ad5ca
+  metadata.gz: b14592985e916f098fa5cd315891cbfe528408b206dde1a2bf38ca30f7c61f2d
+  data.tar.gz: 96757864620b16e89a965cca06635d428fdfa16d290c4c366fd0a1c0e602a41c
 SHA512:
-  metadata.gz: ccf76a6e2c2f7c2f3760a042a1a445619f2fa6688edd0f506b74c215b98feddcd63af8ef98c2f0d9f914af2339d24336b250718af86b205f60e9e2077eedac23
-  data.tar.gz: d350f3eca6a275a5afb052306a3ac15e45f492bda2b47a12b52be9b3b5e11e4ba19b00a73980a5d9be2cd6cff6ad59cd11f624b713fb1d22cb26b3ab24bf6c06
+  metadata.gz: ef0b6f71dadfa936491fc8974e2ed57256276592de9e48fd52be80f5d4d2d35084fb42e9a718a52e22a3020573fd19296d714ef2ee3355cb2ea4b46688ce73a3
+  data.tar.gz: 3cd2798f1d8aba4016150914be9936fb052b30dc10fb2727f48edf3cf88ae096e633f790dc7d7855fc9005244b828e8990ae42989303d3b35071248da0000dd1

data/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to RTFM 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).
 
+## [7.4.1] - 2025-11-04
+
+### Fixed
+- **Directory cache invalidation** - Cache now includes file count in addition to mtime
+  - Fixes issue where files created by external processes didn't appear
+  - Cache automatically invalidates when files are added or deleted
+  - More reliable detection of directory changes across filesystems
+
 ## [7.4.0] - 2025-11-03
 
 ### Documentation

data/README.md

@@ -36,6 +36,7 @@ After first run, use `r` command to launch RTFM and exit into your current direc
 - [Keyboard Reference](#keyboard-reference)
 - [Remote SSH/SFTP Browsing](#remote-sshsftp-browsing)
 - [Configuration](#configuration)
+- [OpenAI Integration](#openai-integration)
 - [Plugins](#plugins)
 - [Image Display](#image-display)
 - [RTFM vs Ranger](#rtfm-vs-ranger)
@@ -383,6 +384,76 @@ Configuration stored in `~/.rtfm/conf`
 
 ---
 
+## OpenAI Integration
+
+RTFM includes built-in AI features powered by OpenAI's API for intelligent file analysis and interactive assistance.
+
+### Setup
+
+1. **Install the ruby-openai gem:**
+   ```bash
+   gem install ruby-openai
+   ```
+
+2. **Get an API key:**
+   - Sign up at https://platform.openai.com/
+   - Generate an API key from your account settings
+
+3. **Configure RTFM:**
+   Add your API key to `~/.rtfm/conf`:
+   ```ruby
+   @ai = "sk-your-actual-api-key-here"
+   @aimodel = "gpt-4o-mini"  # Optional: default model
+   @aicolor = 17             # Optional: chat pane background color
+   ```
+
+### Features
+
+#### File Description (Press `I`)
+
+Get an intelligent summary of any file or directory:
+- **Files:** Purpose, code review (for source files), library documentation lookup
+- **Directories:** Overview of structure and contents
+- **Git-aware:** Includes recent changes if in a git repository
+- **Smart analysis:** Automatically includes preview content for context
+
+Example uses:
+- Understand unfamiliar codebases quickly
+- Get code review suggestions (bugs, style, improvements)
+- Learn what libraries/APIs are being used
+- See git diff explanations in plain language
+
+#### Interactive Chat (Press `Ctrl-a`)
+
+Start a conversational AI assistant specialized in:
+- File and directory questions
+- Shell command help and suggestions
+- Terminal workflow assistance
+- Programming and scripting guidance
+
+The chat maintains context throughout your RTFM session, so follow-up questions work naturally.
+
+### Configuration Options
+
+```ruby
+# Model selection (in ~/.rtfm/conf)
+@aimodel = "gpt-4o-mini"      # Fast, cost-effective (default)
+@aimodel = "gpt-4o"           # More capable, higher cost
+@aimodel = "gpt-4-turbo"      # Alternative high-end model
+
+# Chat interface color
+@aicolor = 17                 # Dark blue background (default)
+```
+
+### Cost & Privacy
+
+- API calls cost money (typically $0.001-0.01 per request with gpt-4o-mini)
+- File contents are sent to OpenAI when using `I` key
+- No data is sent unless you explicitly press `I` or `Ctrl-a`
+- Chat history persists only during your RTFM session
+
+---
+
 ## Plugins
 
 RTFM supports two types of plugins in `~/.rtfm/plugins/`:

data/bin/rtfm

@@ -4477,13 +4477,15 @@ def get_cached_dirlist(dir, ls_options, ls_options_with_long = nil) # {{{2
   # Use ls_options_with_long for display, or fall back to ls_options
   ls_options_with_long ||= ls_options
 
-  # Generate cache key with directory mtime for automatic invalidation
+  # Generate cache key with directory mtime AND file count for automatic invalidation
+  # File count catches additions/deletions that may not update mtime immediately
   # Include ls_options_with_long in cache key so toggling @lslong invalidates cache
   begin
     dir_mtime = File.mtime(dir).to_i
-    cache_key = "#{dir}:#{ls_options_with_long}:#{dir_mtime}"
+    file_count = Dir.entries(dir).size
+    cache_key = "#{dir}:#{ls_options_with_long}:#{dir_mtime}:#{file_count}"
   rescue
-    return nil  # Can't cache if we can't get mtime
+    return nil  # Can't cache if we can't get mtime or file count
   end
 
   # Return cached result if available and fresh

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 7.4.0
+  version: 7.4.1
 platform: ruby
 authors:
 - Geir Isene
@@ -67,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '7.4'
 description: |-
-  RTFM v7.4.0: Comprehensive documentation release with man page, guides, and examples.
+  RTFM v7.4.1: Fixed directory cache not updating when files added/deleted externally.
    A full featured terminal browser with syntax highlighted files, images shown in the terminal, videos thumbnailed, etc. Features include remote SSH/SFTP browsing, interactive SSH shell, comprehensive undo system, bookmarks, and much more. You can bookmark and jump around easily, delete, rename, copy, symlink and move files. RTFM is one of the most feature-packed terminal file managers.
 email: g@isene.com
 executables: