feat: enhance check command with detailed commit information

- Add detailed commit information showing commit messages and dates
- Show which upstream commit will be used for PR creation
- Display last sync information when up to date
- Add commit details section with local and upstream commit info
- Show timestamps for better tracking of update timing
- Improve user visibility into what commits are being tracked

Enhanced output now shows:
- Commit messages for both local and upstream
- Last updated timestamps
- Which upstream commit will be used for PR
- Better context for decision making

Author: nejc

README.md

@@ -111,9 +111,22 @@ The package uses two important branch settings:
 - **`UPSTREAM_LOCAL_BRANCH`**: Your main project branch where PRs will be created against (e.g., `main`, `master`, `develop`)
 
 **Example scenarios:**
-- **Laravel Starter Kit**: `UPSTREAM_BRANCH=main` (upstream repo) → `UPSTREAM_LOCAL_BRANCH=main` (your repo)
+- **Modern Project**: `UPSTREAM_BRANCH=main` (upstream repo) → `UPSTREAM_LOCAL_BRANCH=main` (your repo)
 - **Legacy Project**: `UPSTREAM_BRANCH=main` (upstream repo) → `UPSTREAM_LOCAL_BRANCH=master` (your repo)
-- **Development Branch**: `UPSTREAM_BRANCH=develop` (upstream repo) → `UPSTREAM_LOCAL_BRANCH=develop` (your repo)
+- **Development Workflow**: `UPSTREAM_BRANCH=main` (upstream repo) → `UPSTREAM_LOCAL_BRANCH=dev` (your repo)
+- **Feature Branch Workflow**: `UPSTREAM_BRANCH=develop` (upstream repo) → `UPSTREAM_LOCAL_BRANCH=develop` (your repo)
+
+### Common Branch Naming Conventions
+
+Most projects use these branch naming patterns:
+
+- **`dev`** - Development branch (most common in many projects)
+- **`master`** - Traditional main branch (common in older projects)
+- **`main`** - Modern main branch (newer projects, GitHub default)
+- **`develop`** - GitFlow development branch
+- **`staging`** - Staging environment branch
+
+**Setup defaults to `dev`** as it's the most common development branch convention.
 
 ### Publish Configuration
 
@@ -159,7 +172,7 @@ Add these to your `.env` file:
 # Upstream repository configuration
 UPSTREAM_URL=https://github.com/your-upstream/repo.git
 UPSTREAM_BRANCH=main                    # Branch in upstream repo to pull from
-UPSTREAM_LOCAL_BRANCH=main              # Your main project branch (PRs created against this)
+UPSTREAM_LOCAL_BRANCH=dev               # Your main project branch (PRs created against this)
 UPSTREAM_STRATEGY=merge
 UPSTREAM_COMMIT_MESSAGE="chore(upstream): sync from upstream"
 UPSTREAM_ALLOW_UNRELATED=true

src/Console/Commands/UpstreamCheckCommand.php

@@ -78,6 +78,9 @@ public function handle(): int
             // Get upstream commit
             $upstreamCommit = $git->run(['rev-parse', "$remoteName/$upstreamBranch"]);
             $this->line('📍 Latest upstream commit: <info>'.mb_substr($upstreamCommit, 0, 8).'</info>');
+            
+            // Show more detailed commit information
+            $this->showCommitDetails($git, $localCommit, $upstreamCommit);
 
             // Check if we're behind
             $isBehind = $this->isBehind($git, $localBranch, "$remoteName/$upstreamBranch");
@@ -93,11 +96,14 @@ public function handle(): int
                 $this->line('💡 To pull the updates, run:');
                 $this->line('   <info>php artisan laravelplus:update</info> (creates PR by default)');
                 $this->line('   <info>php artisan laravelplus:update --direct</info> (to apply directly)');
+                $this->newLine();
+                $this->line("🔗 PR will sync from upstream commit: <info>".mb_substr($upstreamCommit, 0, 8)."</info>");
 
                 return self::SUCCESS;
             }
             $this->newLine();
             $this->info('✅ You are up to date! No updates available.');
+            $this->line("📋 Last sync was from upstream commit: <info>".mb_substr($upstreamCommit, 0, 8)."</info>");
 
             return self::SUCCESS;
 
@@ -218,4 +224,30 @@ private function applyDefaultPreset(array $cfg): array
 
         return $cfg;
     }
+
+    private function showCommitDetails(VersionControl $git, string $localCommit, string $upstreamCommit): void
+    {
+        try {
+            // Get commit messages
+            $localMessage = $git->run(['log', '--format=%s', '-n', '1', $localCommit]);
+            $upstreamMessage = $git->run(['log', '--format=%s', '-n', '1', $upstreamCommit]);
+            
+            // Get commit dates
+            $localDate = $git->run(['log', '--format=%ci', '-n', '1', $localCommit]);
+            $upstreamDate = $git->run(['log', '--format=%ci', '-n', '1', $upstreamCommit]);
+            
+            $this->newLine();
+            $this->line('📝 <comment>Commit Details:</comment>');
+            $this->line("   Local: <info>".mb_substr($localCommit, 0, 8)."</info> - ".mb_trim($localMessage));
+            $this->line("   Upstream: <info>".mb_substr($upstreamCommit, 0, 8)."</info> - ".mb_trim($upstreamMessage));
+            
+            // Show dates
+            $this->line('📅 <comment>Last Updated:</comment>');
+            $this->line("   Local: <info>".date('Y-m-d H:i:s', strtotime($localDate))."</info>");
+            $this->line("   Upstream: <info>".date('Y-m-d H:i:s', strtotime($upstreamDate))."</info>");
+            
+        } catch (Throwable) {
+            // If we can't get commit details, just continue silently
+        }
+    }
 }

src/Console/Commands/UpstreamSetupCommand.php

@@ -94,8 +94,8 @@ private function setupPreset(string $preset): int
         // Ask for local branch (what branch to create PRs against)
         $localBranch = $this->text(
             'Which local branch should receive the updates? (PRs will be created against this branch)',
-            default: 'main',
-            placeholder: 'e.g., main, master, develop (your main project branch)'
+            default: 'dev',
+            placeholder: 'e.g., master, dev, main (your main project branch)'
         );
 
         // Update .env file
@@ -145,8 +145,8 @@ private function setupCustom(): int
 
         $localBranch = $this->text(
             'Which local branch should receive the updates? (PRs will be created against this branch)',
-            default: 'main',
-            placeholder: 'e.g., main, master, develop (your main project branch)'
+            default: 'dev',
+            placeholder: 'e.g., master, dev, main (your main project branch)'
         );
 
         $this->info('Setting up upstream sync for custom repository...');