hyperlist 1.1.6 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3394f0a19dc7d9641036a62d294be9dcb4d07627e8f28abbf52be6db409b0ce
-  data.tar.gz: 226af1d1c88dc25128f9fb881e6195bb57f4ee9ec8248320d9c12834b1275aff
+  metadata.gz: aef5338683dfa697e59042f093e0db9a748ef53515952a295b1c9eb972519ac5
+  data.tar.gz: fbad5a0f6022d40cfd147846d3de81b317b41fff39036c9085a0230fc0a144c4
 SHA512:
-  metadata.gz: e636855dff0f0179dcb0f7eb56dc67c577f3775cd1fbf93d9c49b1812ce896e34160331146c4a6e8cea5e7fa92cafba197244210bb48b24f5abfa86e1e7c266b
-  data.tar.gz: b5793788afef9b63fe54471687ed3f03f6f100616f2aa89eb13a5fa5e36201cbfaabac24b7683f612084bfacf3ffb827bac1bf7e363958ece2de0f32fecedc7a
+  metadata.gz: fd23aaaaa0ffbb7b1d73fdc99a46d3fb08d265000e1e10651e747857a4ab5d78dbf523d967e87d4ca82a1f0f8ff46d3fc563cec4441c3a86de7a3651f0cb41e6
+  data.tar.gz: 98ae50b53b8a9b4578ed50c81b8dcd763af2273f44bca200f27627cdc808f61b620baa0d76c09a9a776107de3de637e50c1daf660c7c77903debb8ee1868909d

data/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to the HyperList Ruby TUI will be documented in this file.
 
+## [1.2.0] - 2025-08-20
+
+### Added
+- **User-Defined Templates**
+  - Save any HyperList document as a reusable template (`:st` or `:save-template`)
+  - Template manager for listing and deleting custom templates (`:lt`, `:dt`)
+  - Enhanced template browser showing both built-in and user templates
+  - Template metadata including description and creation date
+  - Templates stored in `~/.hyperlist/templates/` for easy backup and sharing
+  - JSON format for template storage with full hierarchy preservation
+  
+### Changed
+- Template system now supports both built-in and user-created templates
+- Template browser UI improved with separate sections for built-in vs user templates
+- Help documentation updated with new template commands
+
+## [1.1.7] - 2025-08-15
+
+### Fixed
+- **Updated rcurses dependency to 5.1.6**
+  - Fixes Ruby 3.4.5 hanging issue during terminal initialization
+  - rcurses now handles stdin.raw! blocking with timeout and stty fallback
+  - Fully backward compatible
+
 ## [1.1.6] - 2025-08-14
 
 ### Fixed

data/README.md

@@ -6,7 +6,8 @@
 [![GitHub stars](https://img.shields.io/github/stars/isene/HyperList.svg)](https://github.com/isene/HyperList/stargazers)
 [![Stay Amazing](https://img.shields.io/badge/Stay-Amazing-blue.svg)](https://isene.org)
 
-<img src="hyperlist_logo.svg" align="left" width="150" height="150">
+<img src="img/hyperlist_logo.svg" align="left" width="150" height="150">
+<br clear="left"/>
 
 A powerful Terminal User Interface (TUI) application for creating, editing, and managing HyperLists - a methodology for describing anything in a hierarchical, structured format.
 
@@ -23,12 +24,21 @@ For historical context and the original VIM implementation, see: [hyperlist.vim]
 ## Screenshots
 
 ### Main Interface
-![HyperList Main View](screenshot_sample.png)
+![HyperList Main View](img/screenshot_sample.png)
 
 ### Help Screen
-![HyperList Help](screenshot_help.png)
+![HyperList Help](img/screenshot_help.png)
+
+## What's New in v1.2.0
 
-## What's New in v1.1.0
+### 📝 User-Defined Templates
+- **Save as Template**: Save any HyperList document as a reusable template (`:st`)
+- **Template Manager**: List and delete your custom templates (`:lt`, `:dt`)
+- **Enhanced Template Browser**: Shows both built-in and user templates
+- **Template Metadata**: Includes description and creation date
+- Templates stored in `~/.hyperlist/templates/` for easy backup and sharing
+
+## Previous Updates (v1.1.0)
 
 ### 🔐 Encryption Support
 - **File-level encryption** for sensitive files (dot files like `.passwords.hl`)
@@ -62,7 +72,7 @@ For historical context and the original VIM implementation, see: [hyperlist.vim]
 - **Powerful Navigation**: Jump between items, references, and markers
 - **Full Editing Capabilities**: Create, edit, delete, move, and reorganize items
 - **Checkbox Support**: Multiple checkbox types with completion tracking
-- **Template System**: Jump to and fill in template markers
+- **Template System**: Built-in templates plus save/load custom templates
 - **Presentation Mode**: Focus on current item with auto-collapse
 
 ### Security Features
@@ -158,6 +168,7 @@ hyperlist file.txt          # Open any text file
 - `R` - Go to reference
 - `F` - Open file reference
 - `P` - Presentation mode (with auto-collapse)
+- `t` - Insert template (built-in or custom)
 - `?` - Help screen
 
 #### File Commands
@@ -169,6 +180,12 @@ hyperlist file.txt          # Open any text file
 - `:export md` - Export to Markdown
 - `:graph` - Export to PNG
 
+#### Template Commands
+- `:st` - Save current document as template
+- `:dt` - Delete a user template
+- `:lt` - List all user templates
+- `t` - Browse and insert templates
+
 ## Examples
 
 ### Simple Todo List

data/hyperlist

@@ -7,7 +7,7 @@
 # Check for help/version BEFORE loading any libraries
 if ARGV[0] == '-h' || ARGV[0] == '--help'
   puts <<~HELP
-    HyperList v1.1.6 - Terminal User Interface for HyperList files
+    HyperList v1.2.0 - Terminal User Interface for HyperList files
     
     USAGE
       hyperlist [OPTIONS] [FILE]
@@ -52,7 +52,7 @@ if ARGV[0] == '-h' || ARGV[0] == '--help'
   HELP
   exit 0
 elsif ARGV[0] == '-v' || ARGV[0] == '--version'
-  puts "HyperList v1.1.6"
+  puts "HyperList v1.2.0"
   exit 0
 end
 
@@ -64,13 +64,15 @@ require 'cgi'
 require 'openssl'
 require 'digest'
 require 'base64'
+require 'fileutils'
+require 'json'
 
 class HyperListApp
   include Rcurses
   include Rcurses::Input
   include Rcurses::Cursor
   
-  VERSION = "1.1.6"
+  VERSION = "1.2.0"
   
   def initialize(filename = nil)
     @filename = filename ? File.expand_path(filename) : nil
@@ -98,6 +100,8 @@ class HyperListApp
     @auto_save_enabled = false
     @auto_save_interval = 60  # seconds
     @last_auto_save = Time.now
+    @templates_dir = File.expand_path("~/.hyperlist/templates")
+    ensure_templates_dir
     @templates = load_templates
     @macro_recording = false
     @macro_register = {}  # Store macros by key
@@ -136,8 +140,11 @@ class HyperListApp
   end
   
   def setup_ui
-    Rcurses.clear_screen
-    Cursor.hide
+    # Only do rcurses operations if initialized
+    if defined?(Rcurses.instance_variable_get) && Rcurses.instance_variable_get(:@initialized)
+      Rcurses.clear_screen
+      Cursor.hide
+    end
     
     # Ensure we have the latest terminal size
     if IO.console
@@ -2169,7 +2176,7 @@ class HyperListApp
     help_lines << help_line("#{"C-E".fg("10")}", "Encrypt/decrypt line", "#{"C-U".fg("10")}", "Toggle State/Trans underline")
     help_lines << help_line("#{"R".fg("10")}", "Go to reference", "#{"F".fg("10")}", "Open file")
     help_lines << help_line("#{"N".fg("10")}", "Next = marker", "#{"P".fg("10")}", "Presentation mode")
-    help_lines << help_line("#{"t".fg("10")}", "Insert template", "#{":template".fg("10")}", "Show templates")
+    help_lines << help_line("#{"t".fg("10")}", "Insert template", "#{":st".fg("10")}", "Save as template")
     help_lines << help_line("#{"Ma".fg("10")}", "Record macro 'a'", "#{"@a".fg("10")}", "Play macro 'a'")
     help_lines << help_line("#{":vsplit".fg("10")}", "Split view vertically", "#{"w".fg("10")}", "Switch panes")
     help_lines << ""
@@ -2180,6 +2187,11 @@ class HyperListApp
     help_lines << help_line("#{":graph :g".fg("10")}", "Export to PNG graph", "#{":vsplit :vs".fg("10")}", "Split view")
     help_lines << help_line("#{":as on".fg("10")}", "Enable autosave", "#{":as off".fg("10")}", "Disable autosave")
     help_lines << help_line("#{":as N".fg("10")}", "Set interval (secs)", "#{":as".fg("10")}", "Show autosave status")
+    help_lines << ""
+    help_lines << "#{"TEMPLATES".fg("14")}"
+    help_lines << help_line("#{":st".fg("10")}", "Save as template", "#{":dt".fg("10")}", "Delete template")
+    help_lines << help_line("#{":lt".fg("10")}", "List user templates", "#{"t".fg("10")}", "Insert template")
+    help_lines << ""
     help_lines << help_line("#{"q".fg("10")}", "Quit (asks to save)", "#{"Q".fg("10")}", "Force quit")
     help_lines << ""
     help_lines << "#{"COLOR SCHEME".fg("14")}"
@@ -2853,8 +2865,18 @@ class HyperListApp
     when "autosave", "as"
       status = @auto_save_enabled ? "enabled" : "disabled"
       @message = "Auto-save is #{status} (interval: #{@auto_save_interval}s)"
-    when "t"
+    when "t", "template", "templates"
       show_templates
+    when "save-template", "savetemplate", "st"
+      save_as_template
+    when /^save-template\s+(.+)/, /^savetemplate\s+(.+)/, /^st\s+(.+)/
+      save_as_template($1.strip)
+    when "delete-template", "deletetemplate", "dt"
+      delete_template
+    when /^delete-template\s+(.+)/, /^deletetemplate\s+(.+)/, /^dt\s+(.+)/
+      delete_template($1.strip)
+    when "list-templates", "listtemplates", "lt"
+      show_template_manager(:list)
     when "foldlevel"
       level = @footer.ask("Fold to level (0-9): ", "")
       if level =~ /^[0-9]$/
@@ -3202,8 +3224,13 @@ class HyperListApp
     end
   end
   
+  def ensure_templates_dir
+    FileUtils.mkdir_p(@templates_dir) unless File.exist?(@templates_dir)
+  end
+
   def load_templates
-    {
+    # Start with built-in templates
+    templates = {
       "project" => [
         {"text" => "Project: =Project Name=", "level" => 0},
         {"text" => "[_] Define project scope", "level" => 1},
@@ -3306,6 +3333,214 @@ class HyperListApp
         {"text" => "=Tips, variations, serving suggestions=", "level" => 2}
       ]
     }
+    
+    # Load user templates from templates directory
+    if File.directory?(@templates_dir)
+      Dir.glob(File.join(@templates_dir, "*.hlt")).each do |template_file|
+        template_name = File.basename(template_file, ".hlt")
+        begin
+          template_data = JSON.parse(File.read(template_file))
+          # Convert template data to the expected format
+          if template_data.is_a?(Hash) && template_data["items"]
+            templates[template_name] = template_data["items"].map do |item|
+              {"text" => item["text"], "level" => item["level"]}
+            end
+          end
+        rescue => e
+          # Skip invalid template files
+        end
+      end
+    end
+    
+    templates
+  end
+  
+  def save_as_template(name = nil)
+    # Ask for template name if not provided
+    if name.nil? || name.empty?
+      name = @footer.ask("Template name: ", "")
+      return if name.nil? || name.empty?
+    end
+    
+    # Sanitize template name
+    name = name.gsub(/[^a-zA-Z0-9_-]/, '_')
+    
+    # Ask for description
+    description = @footer.ask("Template description (optional): ", "")
+    
+    # Prepare template data
+    template_data = {
+      "name" => name,
+      "description" => description,
+      "created" => Time.now.strftime("%Y-%m-%dT%H:%M:%S"),
+      "items" => @items.map do |item|
+        {
+          "text" => item["text"],
+          "level" => item["level"]
+        }
+      end
+    }
+    
+    # Save template file
+    template_path = File.join(@templates_dir, "#{name}.hlt")
+    
+    # Check if template already exists
+    if File.exist?(template_path)
+      response = @footer.ask("Template '#{name}' already exists. Overwrite? (y/n): ", "")
+      return unless response.downcase == 'y'
+    end
+    
+    File.write(template_path, JSON.pretty_generate(template_data))
+    @message = "Template '#{name}' saved successfully"
+  end
+  
+  def delete_template(name = nil)
+    # Get list of user templates
+    user_templates = get_user_templates
+    
+    if user_templates.empty?
+      @message = "No user templates found"
+      return
+    end
+    
+    # Show template list if name not provided
+    if name.nil? || name.empty?
+      show_template_manager(:delete)
+      return
+    end
+    
+    template_path = File.join(@templates_dir, "#{name}.hlt")
+    
+    if File.exist?(template_path)
+      response = @footer.ask("Delete template '#{name}'? (y/n): ", "")
+      if response.downcase == 'y'
+        File.delete(template_path)
+        @message = "Template '#{name}' deleted"
+        # Reload templates
+        @templates = load_templates
+      end
+    else
+      @message = "Template '#{name}' not found"
+    end
+  end
+  
+  def get_user_templates
+    templates = []
+    if File.directory?(@templates_dir)
+      Dir.glob(File.join(@templates_dir, "*.hlt")).each do |template_file|
+        template_name = File.basename(template_file, ".hlt")
+        begin
+          template_data = JSON.parse(File.read(template_file))
+          templates << {
+            "name" => template_name,
+            "description" => template_data["description"] || "",
+            "created" => template_data["created"] || "",
+            "path" => template_file
+          }
+        rescue => e
+          # Skip invalid template files
+        end
+      end
+    end
+    templates.sort_by { |t| t["name"] }
+  end
+  
+  def show_template_manager(action = :list)
+    # Store original state
+    original_state = {
+      items: @items.dup,
+      current: @current,
+      offset: @offset,
+      filename: @filename,
+      modified: @modified
+    }
+    
+    user_templates = get_user_templates
+    
+    # Build template manager view
+    @items = []
+    case action
+    when :delete
+      @items << {"text" => "DELETE TEMPLATE (press Enter to delete, q to cancel)", "level" => 0, "fold" => false, "raw" => true}
+    else
+      @items << {"text" => "USER TEMPLATES (press Enter to select, q to cancel)", "level" => 0, "fold" => false, "raw" => true}
+    end
+    @items << {"text" => "="*50, "level" => 0, "fold" => false, "raw" => true}
+    
+    if user_templates.empty?
+      @items << {"text" => "No user templates found", "level" => 0, "fold" => false, "raw" => true}
+    else
+      user_templates.each_with_index do |template, idx|
+        desc = template["description"].empty? ? "No description" : template["description"]
+        created = template["created"].empty? ? "" : " (#{Time.parse(template["created"]).strftime('%Y-%m-%d')})"
+        @items << {
+          "text" => "#{idx+1}. #{template["name"]}: #{desc}#{created}",
+          "level" => 0,
+          "fold" => false,
+          "raw" => true,
+          "template_name" => template["name"],
+          "template_action" => action
+        }
+      end
+    end
+    
+    @current = 2  # Start at first template
+    @offset = 0
+    
+    selected_template = nil
+    exit_loop = false
+    
+    # Template manager loop
+    while !exit_loop
+      begin
+        render_main
+        footer_text = case action
+        when :delete
+          "Delete Template | Enter: delete | q: cancel | j/k: navigate"
+        else
+          "User Templates | Enter: select | q: cancel | j/k: navigate"
+        end
+        @footer.text = footer_text
+        @footer.refresh
+        
+        c = getchr
+        next if c.nil?
+        
+        case c
+        when "q", "ESC", "C-c", "Q"
+          exit_loop = true
+        when "j", "DOWN"
+          @current = [@current + 1, @items.length - 1].min
+        when "k", "UP"
+          @current = [@current - 1, 2].max
+        when "ENTER", "RETURN", "\n", "\r"
+          if @current >= 2 && @current < @items.length
+            item = @items[@current]
+            if item && item.is_a?(Hash) && item["template_name"]
+              selected_template = item["template_name"]
+              exit_loop = true
+            end
+          end
+        end
+      rescue => e
+        @message = "Error in template manager: #{e.message}"
+        exit_loop = true
+      end
+    end
+    
+    # Restore original state
+    @items = original_state[:items]
+    @current = original_state[:current]
+    @offset = original_state[:offset]
+    @filename = original_state[:filename]
+    @modified = original_state[:modified]
+    
+    # Process selected template
+    if selected_template && action == :delete
+      delete_template(selected_template)
+    end
+    
+    selected_template
   end
   
   def show_templates
@@ -3318,24 +3553,33 @@ class HyperListApp
       modified: @modified
     }
     
-    # Create template selection view
+    # Create template selection view combining built-in and user templates
     template_list = [
-      ["project", "Project Plan - Complete project management template"],
-      ["meeting", "Meeting Agenda - Structure for meeting notes"],
-      ["daily", "Daily Planner - Daily task and schedule template"],
-      ["checklist", "Simple Checklist - Basic checkbox list"],
-      ["brainstorm", "Brainstorming Session - Idea generation template"],
-      ["recipe", "Recipe - Cooking recipe structure"]
+      ["project", "Project Plan - Complete project management template", "built-in"],
+      ["meeting", "Meeting Agenda - Structure for meeting notes", "built-in"],
+      ["daily", "Daily Planner - Daily task and schedule template", "built-in"],
+      ["checklist", "Simple Checklist - Basic checkbox list", "built-in"],
+      ["brainstorm", "Brainstorming Session - Idea generation template", "built-in"],
+      ["recipe", "Recipe - Cooking recipe structure", "built-in"]
     ]
     
+    # Add user templates to the list
+    user_templates = get_user_templates
+    user_templates.each do |template|
+      desc = template["description"].empty? ? "User template" : template["description"]
+      template_list << [template["name"], desc, "user"]
+    end
+    
     # Build template selection items
     @items = []
     @items << {"text" => "TEMPLATES (press Enter to insert, q to cancel)", "level" => 0, "fold" => false, "raw" => true}
     @items << {"text" => "="*50, "level" => 0, "fold" => false, "raw" => true}
     
-    template_list.each_with_index do |(key, desc), idx|
+    # Add built-in templates section
+    @items << {"text" => "BUILT-IN TEMPLATES:", "level" => 0, "fold" => false, "raw" => true}
+    template_list.select { |t| t[2] == "built-in" }.each_with_index do |(key, desc, type), idx|
       @items << {
-        "text" => "#{idx+1}. #{key.capitalize}: #{desc}", 
+        "text" => "  #{idx+1}. #{key.capitalize}: #{desc}", 
         "level" => 0, 
         "fold" => false, 
         "raw" => true, 
@@ -3343,6 +3587,21 @@ class HyperListApp
       }
     end
     
+    # Add user templates section if any exist
+    if user_templates.any?
+      @items << {"text" => "", "level" => 0, "fold" => false, "raw" => true}
+      @items << {"text" => "USER TEMPLATES:", "level" => 0, "fold" => false, "raw" => true}
+      template_list.select { |t| t[2] == "user" }.each_with_index do |(key, desc, type), idx|
+        @items << {
+          "text" => "  #{key}: #{desc}", 
+          "level" => 0, 
+          "fold" => false, 
+          "raw" => true, 
+          "template_key" => key
+        }
+      end
+    end
+    
     @current = 2  # Start at first template
     @offset = 0
     
@@ -4252,6 +4511,19 @@ class HyperListApp
   end
   
   def run
+    # Initialize rcurses explicitly (no longer auto-initialized)
+    Rcurses.init!
+    
+    # Flush any buffered input (like the Enter key from running the command)
+    while IO.select([$stdin], nil, nil, 0)
+      $stdin.read_nonblock(1024) rescue break
+    end
+    
+    # Now that rcurses is initialized, set up the UI properly
+    Rcurses.clear_screen
+    Cursor.hide
+    setup_ui
+    
     render
     
     loop do
@@ -4260,6 +4532,14 @@ class HyperListApp
       
       c = getchr
       
+      # Skip nil input (shouldn't happen normally)
+      next if c.nil?
+      
+      # Skip newline at the very start (buffered from command execution)
+      if c == "\n" && @last_key.nil?
+        next
+      end
+      
       # Track last key for double-key combinations
       prev_key = @last_key
       @last_key = c
@@ -4550,40 +4830,15 @@ class HyperListApp
     quit
   ensure
     Cursor.show
-    Rcurses.clear_screen
+    # Screen clearing disabled for debugging
+    # Rcurses.clear_screen
   end
 end
 
 # Main
-if __FILE__ == $0 && !defined?($hyperlist_wrapper_mode)
-  # Normal operation - help/version already handled at top of file
-  
-  # For Ruby 3.4+, explicitly initialize rcurses if needed
-  if RUBY_VERSION >= "3.4.0"
-    begin
-      Rcurses.init! unless Rcurses.respond_to?(:initialized?) && Rcurses.initialized?
-    rescue => e
-      # If initialization fails, try to provide helpful error
-      puts "Failed to initialize terminal interface: #{e.message}"
-      puts "Try running with: ruby #{__FILE__} #{ARGV.join(' ')}"
-      exit 1
-    end
-  end
-  
+# When installed as a gem executable, this file is loaded (not executed directly)
+# so we can't use __FILE__ == $0. Just run unless we already handled help/version.
+unless ARGV[0] == '-h' || ARGV[0] == '--help' || ARGV[0] == '-v' || ARGV[0] == '--version'
   app = HyperListApp.new(ARGV[0])
-  
-  begin
-    app.run
-  ensure
-    # Ensure proper cleanup for Ruby 3.4+
-    if RUBY_VERSION >= "3.4.0"
-      begin
-        Rcurses.done! if defined?(Rcurses.done!)
-      rescue
-        # Fallback cleanup
-        print "\e[?25h"  # Show cursor
-        system("stty sane 2>/dev/null")
-      end
-    end
-  end
+  app.run
 end

data/hyperlist.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "hyperlist"
-  spec.version       = "1.1.6"
+  spec.version       = "1.2.0"
   spec.authors       = ["Geir Isene"]
   spec.email         = ["g@isene.com"]
 
@@ -28,7 +28,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["."]
 
   # Runtime dependencies
-  spec.add_runtime_dependency "rcurses", "~> 5.1", ">= 5.1.5"
+  spec.add_runtime_dependency "rcurses", "~> 5.1", ">= 5.1.6"
   
   # Development dependencies
   spec.add_development_dependency "minitest", "~> 5.0"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hyperlist
 version: !ruby/object:Gem::Version
-  version: 1.1.6
+  version: 1.2.0
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: "."
 cert_chain: []
-date: 2025-08-14 00:00:00.000000000 Z
+date: 2025-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -19,7 +19,7 @@ dependencies:
         version: '5.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 5.1.5
+        version: 5.1.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '5.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 5.1.5
+        version: 5.1.6
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -73,18 +73,12 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
-- debug_instructions.md
-- diagnose.rb
-- diagnose_ruby34.rb
-- diagnose_safe.rb
-- fix_terminal.sh
 - hyperlist
 - hyperlist.gemspec
-- hyperlist_logo.svg
-- hyperlist_ruby34_wrapper.rb
+- img/hyperlist_logo.svg
+- img/screenshot_help.png
+- img/screenshot_sample.png
 - sample.hl
-- screenshot_help.png
-- screenshot_sample.png
 - test.hl
 homepage: https://github.com/isene/HyperList
 licenses:

data/debug_instructions.md

@@ -1,112 +0,0 @@
-# Debugging HyperList Issues
-
-## For the user experiencing startup crashes:
-
-### 1. First, verify you have the latest versions:
-
-```bash
-gem list hyperlist
-# Should show: hyperlist (1.1.3)
-
-gem list rcurses  
-# Should show: rcurses (5.1.4) or higher
-```
-
-### 2. If not, update to the latest:
-
-```bash
-gem update hyperlist
-gem update rcurses
-```
-
-### 3. Run with debug mode to see errors:
-
-```bash
-# Set debug environment variable
-export RCURSES_DEBUG=1
-export DEBUG=1
-
-# Then run hyperlist
-hyperlist
-
-# Or run in one line:
-DEBUG=1 RCURSES_DEBUG=1 hyperlist
-```
-
-### 4. Alternative: Run with Ruby directly to see errors:
-
-```bash
-# Find where hyperlist is installed
-which hyperlist
-
-# Run it directly with Ruby to see any errors
-ruby $(which hyperlist)
-```
-
-### 5. Check Ruby version compatibility:
-
-```bash
-ruby --version
-# HyperList requires Ruby 3.0.0 or higher
-```
-
-### 6. Try running with verbose Ruby output:
-
-```bash
-ruby -w $(which hyperlist)
-```
-
-### 7. Check for missing dependencies:
-
-```bash
-# This will show if rcurses is properly installed
-ruby -e "require 'rcurses'; puts 'rcurses loaded successfully'"
-```
-
-### 8. Create a simple test file to isolate the issue:
-
-Create a file called `test_hyperlist.rb`:
-
-```ruby
-#!/usr/bin/env ruby
-
-puts "Ruby version: #{RUBY_VERSION}"
-puts "Testing rcurses..."
-
-begin
-  require 'rcurses'
-  puts "✓ rcurses loaded successfully (version from gem)"
-rescue LoadError => e
-  puts "✗ Failed to load rcurses: #{e.message}"
-  exit 1
-end
-
-puts "\nTesting basic rcurses functionality..."
-begin
-  include Rcurses
-  puts "✓ Rcurses module included"
-  puts "✓ All basic checks passed!"
-rescue => e
-  puts "✗ Error: #{e.message}"
-  exit 1
-end
-```
-
-Run it with:
-```bash
-ruby test_hyperlist.rb
-```
-
-### 9. If all else fails, capture output:
-
-```bash
-# Run with script to capture all output
-script -c "hyperlist" hyperlist_output.txt
-
-# Then send us the hyperlist_output.txt file
-```
-
-## Notes:
-- GDB won't work with Ruby scripts (it's for compiled binaries)
-- The new error handling in rcurses 5.1.4+ should show errors after terminal cleanup
-- Setting DEBUG=1 or RCURSES_DEBUG=1 will show full stack traces

data/diagnose.rb

@@ -1,115 +0,0 @@
-#!/usr/bin/env ruby
-# HyperList Diagnostic Script
-# Run this to help diagnose installation/startup issues
-
-puts "=" * 60
-puts "HyperList Diagnostic Report"
-puts "=" * 60
-
-# Check Ruby version
-puts "\n1. Ruby Version:"
-puts "   #{RUBY_VERSION} (#{RUBY_PLATFORM})"
-if RUBY_VERSION < "3.0.0"
-  puts "   ⚠️  WARNING: HyperList requires Ruby 3.0.0 or higher"
-else
-  puts "   ✓ Ruby version OK"
-end
-
-# Check gem versions
-puts "\n2. Gem Versions:"
-begin
-  hyperlist_version = `gem list hyperlist --local`.match(/hyperlist \(([\d.]+)\)/)[1] rescue "not found"
-  rcurses_version = `gem list rcurses --local`.match(/rcurses \(([\d.]+(?:,\s*[\d.]+)*)\)/)[1] rescue "not found"
-  
-  puts "   hyperlist: #{hyperlist_version}"
-  if hyperlist_version >= "1.1.3"
-    puts "   ✓ HyperList version OK"
-  else
-    puts "   ⚠️  Please update: gem update hyperlist"
-  end
-  
-  puts "   rcurses: #{rcurses_version}"
-  if rcurses_version.include?("5.1.4") || rcurses_version >= "5.1.4"
-    puts "   ✓ rcurses version OK"
-  else
-    puts "   ⚠️  Please update: gem update rcurses"
-  end
-rescue => e
-  puts "   Error checking gems: #{e.message}"
-end
-
-# Test loading rcurses
-puts "\n3. Testing rcurses load:"
-begin
-  require 'rcurses'
-  puts "   ✓ rcurses loaded successfully"
-  
-  # Check if we can access rcurses modules
-  include Rcurses
-  puts "   ✓ Rcurses modules accessible"
-rescue LoadError => e
-  puts "   ✗ Failed to load rcurses: #{e.message}"
-  puts "   Try: gem install rcurses"
-rescue => e
-  puts "   ✗ Error with rcurses: #{e.message}"
-end
-
-# Test terminal capabilities
-puts "\n4. Terminal Check:"
-puts "   TERM: #{ENV['TERM'] || 'not set'}"
-puts "   TTY: #{$stdin.tty? ? 'Yes' : 'No'}"
-puts "   Encoding: #{Encoding.default_external}"
-
-# Check for HyperList executable
-puts "\n5. HyperList Installation:"
-hyperlist_path = `which hyperlist`.strip
-if hyperlist_path.empty?
-  puts "   ✗ hyperlist command not found in PATH"
-  puts "   Try: gem install hyperlist"
-else
-  puts "   ✓ Found at: #{hyperlist_path}"
-  
-  # Check if it's executable
-  if File.executable?(hyperlist_path)
-    puts "   ✓ File is executable"
-  else
-    puts "   ⚠️  File is not executable"
-    puts "   Try: chmod +x #{hyperlist_path}"
-  end
-end
-
-# Try to load core dependencies
-puts "\n6. Core Dependencies:"
-deps = ['io/console', 'date', 'cgi', 'openssl', 'digest', 'base64']
-deps.each do |dep|
-  begin
-    require dep
-    puts "   ✓ #{dep}"
-  rescue LoadError => e
-    puts "   ✗ #{dep}: #{e.message}"
-  end
-end
-
-# Test creating a basic rcurses pane (without initializing terminal)
-puts "\n7. Testing Rcurses Pane Creation (simulation):"
-begin
-  # Don't actually initialize the terminal, just test the class exists
-  if defined?(Rcurses::Pane)
-    puts "   ✓ Rcurses::Pane class exists"
-  else
-    puts "   ✗ Rcurses::Pane class not found"
-  end
-rescue => e
-  puts "   ✗ Error: #{e.message}"
-end
-
-puts "\n" + "=" * 60
-puts "Diagnostic complete!"
-puts "=" * 60
-
-puts "\nIf everything shows ✓ but hyperlist still crashes:"
-puts "1. Run with debug mode: DEBUG=1 RCURSES_DEBUG=1 hyperlist"
-puts "2. Check for error log: cat ~/.hyperlist_error.log"
-puts "3. Try running directly: ruby #{hyperlist_path}"
-
-puts "\nPlease share this diagnostic output when reporting issues."

data/diagnose_ruby34.rb

@@ -1,145 +0,0 @@
-#!/usr/bin/env ruby
-# Diagnostic script for Ruby 3.4.5 compatibility issues
-
-puts "Ruby Compatibility Diagnostic for HyperList"
-puts "=" * 50
-puts "Ruby version: #{RUBY_VERSION}"
-puts "Ruby platform: #{RUBY_PLATFORM}"
-puts
-
-# Test 1: Basic rcurses functionality
-puts "Test 1: Basic rcurses require and init..."
-begin
-  require 'rcurses'
-  puts "  ✓ rcurses loaded successfully"
-  puts "  Rcurses version: #{Rcurses::VERSION}" if defined?(Rcurses::VERSION)
-rescue LoadError => e
-  puts "  ✗ Failed to load rcurses: #{e.message}"
-  exit 1
-end
-
-# Test 2: Rcurses initialization with error capture
-puts "\nTest 2: Rcurses initialization..."
-begin
-  # Capture any output during init
-  original_stdout = $stdout
-  original_stderr = $stderr
-  
-  # Create StringIO to capture output
-  require 'stringio'
-  captured_out = StringIO.new
-  captured_err = StringIO.new
-  
-  $stdout = captured_out
-  $stderr = captured_err
-  
-  # Try to initialize
-  Rcurses.init!
-  
-  # Restore output
-  $stdout = original_stdout
-  $stderr = original_stderr
-  
-  # Check if anything was captured
-  out_content = captured_out.string
-  err_content = captured_err.string
-  
-  if !out_content.empty?
-    puts "  Captured stdout during init: #{out_content.inspect}"
-  end
-  if !err_content.empty?
-    puts "  Captured stderr during init: #{err_content.inspect}"
-  end
-  
-  puts "  ✓ Rcurses initialized"
-  
-  # Test basic functionality
-  puts "  Testing basic screen operations..."
-  print "\e[2J\e[H"  # Clear screen
-  print "Test"
-  sleep 0.1
-  print "\e[2J\e[H"  # Clear again
-  
-  puts "  ✓ Basic operations work"
-  
-rescue => e
-  puts "  ✗ Failed during initialization: #{e.message}"
-  puts "  Backtrace:"
-  e.backtrace.first(5).each { |line| puts "    #{line}" }
-ensure
-  # Try to restore terminal
-  begin
-    Rcurses.done! if defined?(Rcurses.done!)
-  rescue
-    # Fallback terminal restore
-    print "\e[?25h"  # Show cursor
-    system("stty sane 2>/dev/null")
-  end
-end
-
-# Test 3: Check for method availability issues in Ruby 3.4
-puts "\nTest 3: Ruby 3.4 specific checks..."
-
-# Check IO methods that might have changed
-if IO.respond_to?(:console)
-  puts "  ✓ IO.console available"
-else
-  puts "  ✗ IO.console not available"
-end
-
-begin
-  require 'io/console'
-  $stdin.raw { }
-  puts "  ✓ IO#raw method works"
-rescue => e
-  puts "  ✗ IO#raw failed: #{e.message}"
-end
-
-# Test 4: Check encoding
-puts "\nTest 4: Encoding checks..."
-puts "  Default external: #{Encoding.default_external}"
-puts "  Default internal: #{Encoding.default_internal}"
-puts "  Console encoding: #{$stdout.external_encoding}" if $stdout.respond_to?(:external_encoding)
-
-# Test 5: Simple hyperlist initialization test
-puts "\nTest 5: HyperList class initialization..."
-begin
-  # Load just the class definition part
-  hyperlist_code = File.read(File.join(File.dirname(__FILE__), 'hyperlist'))
-  
-  # Extract just the class without running main
-  class_only = hyperlist_code.split(/^if __FILE__ == \$0/)[0]
-  
-  # Try to evaluate it
-  eval(class_only)
-  
-  puts "  ✓ HyperList class loaded"
-  
-  # Try to create instance (without running)
-  app = HyperListApp.new
-  puts "  ✓ HyperListApp instance created"
-  
-rescue => e
-  puts "  ✗ Failed to load HyperList: #{e.message}"
-  puts "  Error at: #{e.backtrace.first}"
-end
-
-# Test 6: Terminal capability check
-puts "\nTest 6: Terminal capabilities..."
-puts "  TERM: #{ENV['TERM']}"
-puts "  Columns: #{`tput cols`.strip}" rescue nil
-puts "  Lines: #{`tput lines`.strip}" rescue nil
-
-# Test 7: Check for signal handling changes
-puts "\nTest 7: Signal handling..."
-begin
-  old_handler = Signal.trap("WINCH") { }
-  Signal.trap("WINCH", old_handler)
-  puts "  ✓ SIGWINCH trap works"
-rescue => e
-  puts "  ✗ SIGWINCH trap failed: #{e.message}"
-end
-
-puts "\n" + "=" * 50
-puts "Diagnostic complete!"
-puts "\nPlease share this output to help identify the Ruby 3.4.5 compatibility issue."

data/diagnose_safe.rb

@@ -1,198 +0,0 @@
-#!/usr/bin/env ruby
-# HyperList Safe Diagnostic Script
-# This version ensures terminal remains in a sane state
-
-# First, ensure terminal is in sane state
-system("stty sane 2>/dev/null")
-
-# Ensure we're not in raw mode and output is flushed properly
-$stdout.sync = true
-$stderr.sync = true
-
-# Don't load rcurses until we explicitly test it
-puts "=" * 60
-puts "HyperList Safe Diagnostic Report"
-puts "=" * 60
-
-# Check Ruby version
-puts "\n1. Ruby Version:"
-puts "   #{RUBY_VERSION} (#{RUBY_PLATFORM})"
-if RUBY_VERSION < "3.0.0"
-  puts "   WARNING: HyperList requires Ruby 3.0.0 or higher"
-elsif RUBY_VERSION >= "3.4.0"
-  puts "   WARNING: Ruby 3.4+ is a development version and may have compatibility issues"
-  puts "   RECOMMENDED: Use Ruby 3.3.x for stability"
-else
-  puts "   OK: Ruby version supported"
-end
-
-# Check gem versions WITHOUT loading them
-puts "\n2. Installed Gem Versions:"
-begin
-  hyperlist_output = `gem list hyperlist --local 2>&1`
-  rcurses_output = `gem list rcurses --local 2>&1`
-  
-  if hyperlist_output.include?("hyperlist")
-    version = hyperlist_output.match(/hyperlist \(([\d.]+)/)[1] rescue "unknown"
-    puts "   hyperlist: #{version}"
-    if version >= "1.1.3"
-      puts "   OK: HyperList version is current"
-    else
-      puts "   UPDATE NEEDED: gem update hyperlist"
-    end
-  else
-    puts "   hyperlist: NOT INSTALLED"
-    puts "   Run: gem install hyperlist"
-  end
-  
-  if rcurses_output.include?("rcurses")
-    # Extract just the first/latest version
-    version = rcurses_output.match(/rcurses \(([\d.]+)/)[1] rescue "unknown"
-    puts "   rcurses: #{version}"
-    if version >= "5.1.4"
-      puts "   OK: rcurses version is current"
-    else
-      puts "   UPDATE NEEDED: gem update rcurses"
-    end
-  else
-    puts "   rcurses: NOT INSTALLED"
-    puts "   Run: gem install rcurses"
-  end
-rescue => e
-  puts "   Error checking gems: #{e.message}"
-end
-
-# Check terminal environment
-puts "\n3. Terminal Environment:"
-puts "   TERM: #{ENV['TERM'] || 'not set'}"
-puts "   LANG: #{ENV['LANG'] || 'not set'}"
-puts "   TTY: #{$stdin.tty? ? 'Yes' : 'No'}"
-puts "   Terminal columns: #{`tput cols`.strip rescue 'unknown'}"
-puts "   Terminal rows: #{`tput lines`.strip rescue 'unknown'}"
-
-# Check for HyperList executable
-puts "\n4. HyperList Executable:"
-hyperlist_path = `which hyperlist 2>/dev/null`.strip
-if hyperlist_path.empty?
-  puts "   NOT FOUND in PATH"
-  
-  # Check common gem bin paths
-  gem_paths = [
-    "#{ENV['HOME']}/.local/share/gem/ruby/*/bin/hyperlist",
-    "#{ENV['HOME']}/.gem/ruby/*/bin/hyperlist",
-    "/usr/local/bin/hyperlist",
-    "/usr/bin/hyperlist"
-  ]
-  
-  found = false
-  gem_paths.each do |pattern|
-    Dir.glob(pattern).each do |path|
-      if File.exist?(path)
-        puts "   Found at: #{path}"
-        puts "   Add to PATH: export PATH=\"#{File.dirname(path)}:$PATH\""
-        found = true
-        break
-      end
-    end
-    break if found
-  end
-else
-  puts "   Found at: #{hyperlist_path}"
-  if File.executable?(hyperlist_path)
-    puts "   OK: File is executable"
-  else
-    puts "   ERROR: File is not executable"
-    puts "   Fix: chmod +x #{hyperlist_path}"
-  end
-end
-
-# Test basic dependencies WITHOUT loading rcurses
-puts "\n5. Core Ruby Dependencies:"
-deps = ['io/console', 'date', 'cgi', 'openssl', 'digest', 'base64']
-deps.each do |dep|
-  begin
-    require dep
-    puts "   OK: #{dep}"
-  rescue LoadError => e
-    puts "   MISSING: #{dep} - #{e.message}"
-  end
-end
-
-# Separate rcurses test with isolation
-puts "\n6. Testing rcurses (isolated):"
-puts "   Running isolated test..."
-
-# Create a separate test script to isolate rcurses
-test_script = <<~RUBY
-  begin
-    require 'rcurses'
-    puts "RCURSES_LOAD:OK"
-    
-    # Check if main classes exist without initializing
-    if defined?(Rcurses::Pane)
-      puts "RCURSES_PANE:OK"
-    else
-      puts "RCURSES_PANE:FAIL"
-    end
-  rescue LoadError => e
-    puts "RCURSES_LOAD:FAIL:\#{e.message}"
-  rescue => e
-    puts "RCURSES_ERROR:\#{e.class}:\#{e.message}"
-  end
-RUBY
-
-# Run test in subprocess to avoid terminal corruption
-result = `ruby -e "#{test_script}" 2>&1`
-
-if result.include?("RCURSES_LOAD:OK")
-  puts "   OK: rcurses loads successfully"
-else
-  puts "   ERROR: rcurses failed to load"
-  error = result.match(/RCURSES_LOAD:FAIL:(.+)/)
-  puts "   Details: #{error[1]}" if error
-end
-
-if result.include?("RCURSES_PANE:OK")
-  puts "   OK: Rcurses::Pane class available"
-else
-  puts "   ERROR: Rcurses::Pane class not found"
-end
-
-if result.include?("RCURSES_ERROR")
-  error = result.match(/RCURSES_ERROR:(.+):(.+)/)
-  puts "   ERROR: #{error[1]} - #{error[2]}" if error
-end
-
-# Test terminal sanity
-puts "\n7. Terminal State Check:"
-system("stty -a > /dev/null 2>&1")
-if $?.success?
-  puts "   OK: Terminal responds to stty"
-else
-  puts "   ERROR: Terminal not responding properly"
-end
-
-# Try to restore terminal just in case
-system("stty sane 2>/dev/null")
-system("tput reset 2>/dev/null")
-
-puts "\n" + "=" * 60
-puts "Diagnostic complete!"
-puts "=" * 60
-
-puts "\nRECOMMENDATIONS:"
-if RUBY_VERSION >= "3.4.0"
-  puts "1. IMPORTANT: You're using Ruby #{RUBY_VERSION} (development version)"
-  puts "   Install Ruby 3.3.x for stability:"
-  puts "   - Arch Linux: sudo pacman -S ruby"
-  puts "   - Or use: rbenv install 3.3.4"
-end
-
-puts "\nTo test rcurses isolation:"
-puts "  ruby -e \"require 'rcurses'; puts 'Loaded OK'\""
-
-puts "\nTo restore terminal if corrupted:"
-puts "  stty sane"
-puts "  reset"
-
-puts "\nPlease share this diagnostic output when reporting issues."

data/fix_terminal.sh

@@ -1,33 +0,0 @@
-#!/bin/bash
-# Terminal restoration script for when things go wrong
-
-echo "Restoring terminal to sane state..."
-
-# Reset terminal to sane defaults
-stty sane 2>/dev/null
-
-# Clear any raw mode settings
-stty echo 2>/dev/null
-stty icanon 2>/dev/null
-stty icrnl 2>/dev/null
-
-# Reset terminal completely
-tput reset 2>/dev/null
-reset 2>/dev/null
-
-# Clear screen
-clear
-
-# Show cursor
-tput cnorm 2>/dev/null
-echo -e "\033[?25h"  # ANSI escape to show cursor
-
-echo "Terminal restored!"
-echo ""
-echo "If your terminal is still broken, try:"
-echo "  1. Close and reopen your terminal"
-echo "  2. Run: reset"
-echo "  3. Run: stty sane"
-echo ""
-echo "To check terminal state:"
-echo "  stty -a"

data/hyperlist_ruby34_wrapper.rb

@@ -1,57 +0,0 @@
-#!/usr/bin/env ruby
-# encoding: utf-8
-
-# Wrapper for Ruby 3.4+ compatibility
-# This ensures proper initialization of rcurses
-
-# Handle help/version before loading libraries
-if ARGV[0] == '-h' || ARGV[0] == '--help' || ARGV[0] == '-v' || ARGV[0] == '--version'
-  # Pass through to main hyperlist
-  load File.join(File.dirname(__FILE__), 'hyperlist')
-  exit 0
-end
-
-# Explicitly initialize rcurses before loading the main app
-require 'rcurses'
-
-begin
-  # Initialize rcurses with proper error handling
-  Rcurses.init!
-  
-  # Now load and run the main hyperlist app
-  # We need to prevent the main file from running automatically
-  $hyperlist_wrapper_mode = true
-  
-  # Load the hyperlist file
-  load File.join(File.dirname(__FILE__), 'hyperlist')
-  
-  # Create and run the app
-  app = HyperListApp.new(ARGV[0])
-  app.run
-  
-rescue Interrupt
-  # Handle Ctrl+C gracefully
-  Rcurses.done! if defined?(Rcurses.done!)
-  puts "\nInterrupted"
-  exit 0
-rescue => e
-  # Ensure terminal is restored on error
-  Rcurses.done! if defined?(Rcurses.done!)
-  
-  # Fallback terminal restoration
-  print "\e[?25h"  # Show cursor
-  system("stty sane 2>/dev/null")
-  
-  puts "Error: #{e.message}"
-  puts "Backtrace:" if ENV['DEBUG']
-  e.backtrace.first(10).each { |line| puts "  #{line}" } if ENV['DEBUG']
-  exit 1
-ensure
-  # Always try to restore terminal
-  begin
-    Rcurses.done! if defined?(Rcurses.done!)
-  rescue
-    print "\e[?25h"
-    system("stty sane 2>/dev/null")
-  end
-end