fix: resolve key mismatch bug and improve token validation

Author: Bulletdev

lib/gitfollow/cli.rb

@@ -27,10 +27,10 @@ def init
         spinner.success('Done!')
 
         puts "\nInitialization complete!"
-        puts "Username: @#{snapshot[:username]}"
-        puts "Followers: #{snapshot[:stats][:followers_count]}"
-        puts "Following: #{snapshot[:stats][:following_count]}"
-        puts "Mutual: #{snapshot[:stats][:mutual_count]}"
+        puts "Username: @#{snapshot['username']}"
+        puts "Followers: #{snapshot['stats']['followers_count']}"
+        puts "Following: #{snapshot['stats']['following_count']}"
+        puts "Mutual: #{snapshot['stats']['mutual_count']}"
         puts "\nRun 'gitfollow check' to detect changes."
       rescue StandardError => e
         spinner.error("Failed: #{e.message}")
@@ -224,17 +224,20 @@ def version
     def setup_components
       token = options[:token] || ENV.fetch('OCTOCAT_TOKEN', nil)
 
-      if token.nil? || token.empty?
-        puts 'Error: GitHub token not provided.'
+      if token.nil? || token.empty? || token.strip.empty?
+        puts 'Error: GitHub token not provided or is empty.'
         puts 'Set OCTOCAT_TOKEN environment variable or use --token option.'
+        puts 'Get a token at: https://github.com/settings/tokens'
         exit 1
       end
 
       begin
         @client = GitFollow::Client.new(token: token)
 
         unless @client.valid_token?
-          puts 'Error: Invalid GitHub token.'
+          puts 'Error: Invalid GitHub token or insufficient permissions.'
+          puts 'Ensure your token has the following scopes: read:user, user:follow'
+          puts 'Generate a new token at: https://github.com/settings/tokens'
           exit 1
         end
 

lib/gitfollow/client.rb

@@ -7,7 +7,9 @@ class Client
     attr_reader :username, :client
 
     def initialize(token:, username: nil)
-      raise ArgumentError, 'GitHub token is required' if token.nil? || token.empty?
+      if token.nil? || token.empty? || token.strip.empty?
+        raise ArgumentError, 'GitHub token is required and cannot be empty'
+      end
 
       @client = Octokit::Client.new(access_token: token)
       @client.auto_paginate = true

spec/gitfollow/client_spec.rb

@@ -8,11 +8,11 @@
 
   describe '#initialize' do
     it 'raises error when token is nil' do
-      expect { described_class.new(token: nil) }.to raise_error(ArgumentError, 'GitHub token is required')
+      expect { described_class.new(token: nil) }.to raise_error(ArgumentError, 'GitHub token is required and cannot be empty')
     end
 
     it 'raises error when token is empty' do
-      expect { described_class.new(token: '') }.to raise_error(ArgumentError, 'GitHub token is required')
+      expect { described_class.new(token: '') }.to raise_error(ArgumentError, 'GitHub token is required and cannot be empty')
     end
 
     it 'initializes with valid token' do