feat: improve PAT integration and error handling for v1.1.0-rc

- Profile scanner now uses authenticated API (githubFetch)
- Distinguish between rate limit, API error, and no repos
- Inline PAT input on rate limit error with stacked layout
- Context-specific empty state messages
- Rate limit UI matches popup's dark minimal style
- Added [HELP] section with DM link

Author: kiritocode1

utils/api/github.ts

@@ -82,7 +82,7 @@ async function getAuthHeaders(): Promise<HeadersInit> {
 /**
  * Authenticated fetch wrapper for GitHub API
  */
-async function githubFetch(url: string): Promise<Response> {
+export async function githubFetch(url: string): Promise<Response> {
     const headers = await getAuthHeaders();
     return fetch(url, { headers });
 }
@@ -169,13 +169,21 @@ export async function fetchRepoTree(owner: string, repo: string): Promise<string
     }
 }
 
+export interface FetchReposResult {
+    repos: RepoInfo[];
+    rateLimited: boolean;
+    error: boolean;
+}
+
 /**
  * Fetch user's public repositories
  */
-export async function fetchUserRepos(username: string): Promise<RepoInfo[]> {
+export async function fetchUserRepos(username: string): Promise<FetchReposResult> {
     const repos: RepoInfo[] = [];
     let page = 1;
     const maxPages = 3;
+    let rateLimited = false;
+    let error = false;
 
     try {
         while (page <= maxPages) {
@@ -186,8 +194,13 @@ export async function fetchUserRepos(username: string): Promise<RepoInfo[]> {
 
             if (!res.ok) {
                 if (res.status === 403) {
-                    console.warn('[GitStack] Rate limited on user repos!');
+                    const remaining = res.headers.get('X-RateLimit-Remaining');
+                    if (remaining === '0') {
+                        console.warn('[GitStack] Rate limited on user repos!');
+                        rateLimited = true;
+                    }
                 }
+                error = true;
                 break;
             }
             const data = await res.json();
@@ -198,9 +211,10 @@ export async function fetchUserRepos(username: string): Promise<RepoInfo[]> {
         }
     } catch (e) {
         console.warn('[GitStack] Error fetching repos:', e);
+        error = true;
     }
 
-    return repos;
+    return { repos, rateLimited, error: error && repos.length === 0 };
 }
 
 /**

utils/profile/scanner.ts

@@ -3,7 +3,7 @@
  */
 
 import { signatures } from '../signatures';
-import { fetchUserRepos, RepoInfo } from '../api/github';
+import { fetchUserRepos, RepoInfo, githubFetch } from '../api/github';
 import { CACHE_TTL, getCacheWithTimestamp, setCache } from '../cache';
 import {
     injectProfileLoadingState,
@@ -94,7 +94,7 @@ async function scanRepoQuick(repo: RepoInfo): Promise<ScanResult> {
     }
 
     try {
-        const treeRes = await fetch(
+        const treeRes = await githubFetch(
             `https://api.github.com/repos/${repo.full_name}/git/trees/${repo.default_branch}?recursive=1`
         );
 
@@ -151,10 +151,22 @@ export async function scanAndDisplayProfile(username: string): Promise<void> {
     injectProfileLoadingState(username);
     scannedProfileUsernames.add(username);
 
-    const repos = await fetchUserRepos(username);
+    const { repos, rateLimited, error } = await fetchUserRepos(username);
+
+    // Handle rate limit
+    if (rateLimited) {
+        injectProfileRateLimitError(username);
+        return;
+    }
+
+    // Handle API error vs genuinely no repos
     if (repos.length === 0) {
         removeProfileLoadingState();
-        injectProfileEmptyState(username, 0);
+        if (error) {
+            injectProfileEmptyState(username, 0, 'api_error');
+        } else {
+            injectProfileEmptyState(username, 0, 'no_repos');
+        }
         return;
     }
 
@@ -216,12 +228,12 @@ export async function scanAndDisplayProfile(username: string): Promise<void> {
         });
 
         if (newTechs.size === 0) {
-            injectProfileEmptyState(username, scannedCount);
+            injectProfileEmptyState(username, scannedCount, 'scanned_nothing');
         }
     } else if (cachedTechs.length === 0) {
         removeProfileLoadingState();
         if (repos.length > 0) {
-            injectProfileEmptyState(username, 0);
+            injectProfileEmptyState(username, 0, 'scanned_nothing');
         }
     }
 }