Improve error messages

Author: andrew

lib/git/pkgs/commands/blame.rb

@@ -21,7 +21,7 @@ def run
           branch_name = @options[:branch] || repo.default_branch
           branch = Models::Branch.find_by(name: branch_name)
 
-          error "No analysis found for branch '#{branch_name}'" unless branch&.last_analyzed_sha
+          error "No analysis found for branch '#{branch_name}'. Run 'git pkgs init' first." unless branch&.last_analyzed_sha
 
           current_commit = Models::Commit.find_by(sha: branch.last_analyzed_sha)
           snapshots = current_commit&.dependency_snapshots&.includes(:manifest) || []

lib/git/pkgs/commands/branch.rb

@@ -40,7 +40,7 @@ def add_branch
 
           Database.connect(repo.git_dir)
 
-          error "Branch '#{branch_name}' not found" unless repo.branch_exists?(branch_name)
+          error "Branch '#{branch_name}' not found. Check 'git branch -a' for available branches." unless repo.branch_exists?(branch_name)
 
           existing = Models::Branch.find_by(name: branch_name)
           if existing
@@ -104,7 +104,7 @@ def remove_branch
           Database.connect(repo.git_dir)
 
           branch = Models::Branch.find_by(name: branch_name)
-          error "Branch '#{branch_name}' not tracked" unless branch
+          error "Branch '#{branch_name}' not tracked. Run 'git pkgs branch list' to see tracked branches." unless branch
 
           # Only delete branch_commits, keep shared commits
           count = branch.branch_commits.count

lib/git/pkgs/commands/diff.rb

@@ -27,14 +27,14 @@ def run
           from_sha = repo.rev_parse(from_ref)
           to_sha = repo.rev_parse(to_ref)
 
-          error "Could not resolve '#{from_ref}'" unless from_sha
-          error "Could not resolve '#{to_ref}'" unless to_sha
+          error "Could not resolve '#{from_ref}'. Check that the ref exists." unless from_sha
+          error "Could not resolve '#{to_ref}'. Check that the ref exists." unless to_sha
 
           from_commit = Models::Commit.find_or_create_from_repo(repo, from_sha)
           to_commit = Models::Commit.find_or_create_from_repo(repo, to_sha)
 
-          error "Commit '#{from_sha[0..7]}' not found" unless from_commit
-          error "Commit '#{to_sha[0..7]}' not found" unless to_commit
+          error "Commit '#{from_sha[0..7]}' not in database. Run 'git pkgs update' to index new commits." unless from_commit
+          error "Commit '#{to_sha[0..7]}' not in database. Run 'git pkgs update' to index new commits." unless to_commit
 
           # Get all changes between the two commits
           changes = Models::DependencyChange

lib/git/pkgs/commands/init.rb

@@ -18,7 +18,7 @@ def run
           repo = Repository.new
 
           branch_name = @options[:branch] || repo.default_branch
-          error "Branch '#{branch_name}' not found" unless repo.branch_exists?(branch_name)
+          error "Branch '#{branch_name}' not found. Check 'git branch -a' for available branches." unless repo.branch_exists?(branch_name)
 
           if Database.exists?(repo.git_dir) && !@options[:force]
             info "Database already exists. Use --force to rebuild."

lib/git/pkgs/commands/list.rb

@@ -20,7 +20,7 @@ def run
           commit_sha = @options[:commit] || repo.head_sha
           target_commit = Models::Commit.find_by(sha: commit_sha)
 
-          error "Commit #{commit_sha[0, 7]} not found in database" unless target_commit
+          error "Commit #{commit_sha[0, 7]} not in database. Run 'git pkgs update' to index new commits." unless target_commit
 
           deps = compute_dependencies_at_commit(target_commit, repo)
 

lib/git/pkgs/commands/show.rb

@@ -20,10 +20,10 @@ def run
           Database.connect(repo.git_dir)
 
           sha = repo.rev_parse(ref)
-          error "Could not resolve '#{ref}'" unless sha
+          error "Could not resolve '#{ref}'. Check that the ref exists with 'git rev-parse #{ref}'." unless sha
 
           commit = Models::Commit.find_or_create_from_repo(repo, sha)
-          error "Commit '#{sha[0..7]}' not found" unless commit
+          error "Commit '#{sha[0..7]}' not in database. Run 'git pkgs update' to index new commits." unless commit
 
           changes = Models::DependencyChange
             .includes(:commit, :manifest)

lib/git/pkgs/commands/stale.rb

@@ -20,7 +20,7 @@ def run
           branch_name = @options[:branch] || repo.default_branch
           branch = Models::Branch.find_by(name: branch_name)
 
-          error "No analysis found for branch '#{branch_name}'" unless branch&.last_analyzed_sha
+          error "No analysis found for branch '#{branch_name}'. Run 'git pkgs init' first." unless branch&.last_analyzed_sha
 
           current_commit = Models::Commit.find_by(sha: branch.last_analyzed_sha)
           snapshots = current_commit&.dependency_snapshots&.includes(:manifest) || []

lib/git/pkgs/commands/tree.rb

@@ -21,7 +21,7 @@ def run
           commit_sha = @options[:commit] || repo.head_sha
           commit = find_commit_with_snapshot(commit_sha, repo)
 
-          error "No dependency data found for commit #{commit_sha[0, 7]}" unless commit
+          error "No dependency data for commit #{commit_sha[0, 7]}. Run 'git pkgs update' to index new commits." unless commit
 
           # Get current snapshots
           snapshots = commit.dependency_snapshots.includes(:manifest)

lib/git/pkgs/output.rb

@@ -12,7 +12,7 @@ module Output
       def parse_time(str)
         Time.parse(str)
       rescue ArgumentError
-        error "Invalid date format: #{str}"
+        error "Invalid date format: #{str}. Use YYYY-MM-DD format."
       end
 
       # Print informational/status message. Suppressed in quiet mode.