hyperlist 1.1.2 → 1.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4833d00af59c0e670c52789600b5c211056882bf24712925055307a6a19ad450
-  data.tar.gz: f9079f324d678fde34ed9e7e004c6ad1515903506919764b1007fad386f8f88f
+  metadata.gz: ceec87c634faff3f44aea9faab6b7e2c5fbb6299827371c148b01ac833a6653e
+  data.tar.gz: d2aee8287a2af42238f8d55ac47e5ac4f38738d55c4672f5f7835c561653246a
 SHA512:
-  metadata.gz: 3260f77e28209f0ed869f970442747ecaeec99107697992fc726a321b2fa5c88ab75a1fd66c71678ed40bdf16e089ad8beb4ba0060f2ebd947da158e95b6a14e
-  data.tar.gz: 56ea68f58fe5bd03837fce80b62b5a8b3477d8d5f62b0faca3cc8ee2db48fb5b91fe4ac502b049f076f094cace07a0814ebaa8fd2172c4a23dd5c35c91f3b043
+  metadata.gz: a6bb97db751579efeb55724dd0280edf506a9c547c6809ae61e4fe2ed7ae8b505fb1fc85f138a6ae0c5aea47abc74ed391b6e35f347bbb0dc8e09c562eb2ea77
+  data.tar.gz: efdac57b3bff33a8cefa53f26782ff99dfee21536d54bd185497d89bd010669cc543b2e5c167bdb2d0fe250de73a82a4922dc6c927af33d6f07dbb74429cc2f4

data/debug_instructions.md

@@ -0,0 +1,112 @@
+# 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

@@ -0,0 +1,115 @@
+#!/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_safe.rb

@@ -0,0 +1,198 @@
+#!/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

@@ -0,0 +1,33 @@
+#!/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

@@ -7,7 +7,7 @@
 # Check for help/version BEFORE loading any libraries
 if ARGV[0] == '-h' || ARGV[0] == '--help'
   puts <<~HELP
-    HyperList v1.1.0 - Terminal User Interface for HyperList files
+    HyperList v1.1.4 - 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.0"
+  puts "HyperList v1.1.4"
   exit 0
 end
 
@@ -70,7 +70,7 @@ class HyperListApp
   include Rcurses::Input
   include Rcurses::Cursor
   
-  VERSION = "1.1.2"
+  VERSION = "1.1.4"
   
   def initialize(filename = nil)
     @filename = filename ? File.expand_path(filename) : nil

data/hyperlist.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "hyperlist"
-  spec.version       = "1.1.2"
+  spec.version       = "1.1.4"
   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"
+  spec.add_runtime_dependency "rcurses", "~> 5.1", ">= 5.1.5"
   
   # Development dependencies
   spec.add_development_dependency "minitest", "~> 5.0"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperlist
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.1.4
 platform: ruby
 authors:
 - Geir Isene
@@ -17,6 +17,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.1.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -24,6 +27,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.1.5
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -67,6 +73,10 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- debug_instructions.md
+- diagnose.rb
+- diagnose_safe.rb
+- fix_terminal.sh
 - hyperlist
 - hyperlist.gemspec
 - hyperlist_logo.svg