🌐 Add Complete Hebrew (he) Translation Support

AUTH_ISSUES_EXPLAINED.md

@@ -0,0 +1,277 @@
+# 🔍 הסבר מפורט על בעיות האימות
+
+## 📊 סיכום הבעיות שזוהו:
+
+### ❌ 1. **Claude Authentication** - 401 Unauthorized
+```
+[UsageMonitor] CLI fallback not implemented, API method should be used
+[UsageMonitor] Failed to fetch usage
+Claude CLI not found. Please ensure it is installed and in your PATH.
+```
+
+### ❌ 2. **GitHub Authentication** - טוקן לא תקין
+```
+[GitHub OAuth] Auth check failed (not authenticated): Command failed
+The token in GITHUB_TOKEN is invalid.
+```
+
+---
+
+## 🎯 מה באמת קורה כאן?
+
+### בעיה 1: Claude - אין Claude CLI מותקן
+
+#### **מה הקוד מנסה לעשות:**
+
+1. **UsageMonitor** מנסה לבדוק שימוש ב-Claude API
+2. אם API נכשל (401) → מנסה **fallback ל-CLI**
+3. אבל ה-CLI לא מיושם! (קוד ריק):
+
+```typescript
+// מ-usage-monitor.ts שורה 234
+private async fetchUsageViaCLI(
+  _profileId: string,
+  _profileName: string
+): Promise<ClaudeUsageSnapshot | null> {
+  // CLI-based usage fetching is not implemented yet.
+  console.warn('[UsageMonitor] CLI fallback not implemented, API method should be used');
+  return null;  // ← תמיד מחזיר null!
+}
+```
+
+#### **למה זה קורה:**
+- אין Claude CLI מותקן במערכת שלך
+- גם אם היה מותקן, הקוד לא מיושם
+- **זו לא בעיה בשמירת טוקן** - זו בעיה שאין טוקן בכלל!
+
+---
+
+### בעיה 2: GitHub - טוקן ישן חוסם את gh CLI
+
+#### **מה הקוד מנסה לעשות:**
+
+1. המערכת שומרת `GITHUB_TOKEN` ב-`.env` (אם הוגדר)
+2. כשמפעילים `gh auth login`, ה-CLI אומר:
+   > "אני רואה שיש `GITHUB_TOKEN` ב-environment, אני לא יכול להתחבר כי הוא חוסם אותי"
+
+#### **איפה הטוקן נשמר:**
+
+מהקוד ב-`env-handlers.ts`:
+```typescript
+// שורה 57
+existingVars['GITHUB_TOKEN'] = config.githubToken;
+
+// שורה 133 - כתיבה ל-.env
+${existingVars['GITHUB_TOKEN'] ? `GITHUB_TOKEN=${existingVars['GITHUB_TOKEN']}` : '# GITHUB_TOKEN='}
+```
+
+#### **למה זה חוסם:**
+- `gh auth login --web` לא יכול לעבוד אם יש `GITHUB_TOKEN` ב-environment
+- זה מנגנון אבטחה של GitHub CLI
+- צריך **למחוק את הטוקן הישן קודם**
+
+---
+
+## 🔧 הפתרונות המדויקים:
+
+### פתרון 1: Claude - התקנת Claude CLI
+
+#### אופציה A: דרך npm (מומלץ)
+```powershell
+npm install -g @anthropic-ai/claude-cli
+```
+
+#### אופציה B: דרך pip
+```powershell
+pip install claude-cli
+```
+
+#### אופציה C: התחבר בלי CLI (עדכון קוד)
+**אם אתה לא רוצה להתקין CLI**, צריך לעקוף את הנפילה ל-CLI:
+
+---
+
+### פתרון 2: GitHub - ניקוי טוקן ישן
+
+#### שיטה A: דרך PowerShell (מהיר)
+```powershell
+# מחק את GITHUB_TOKEN מה-environment
+[System.Environment]::SetEnvironmentVariable('GITHUB_TOKEN', $null, 'User')
+[System.Environment]::SetEnvironmentVariable('GITHUB_TOKEN', $null, 'Process')
+
+# אתחל את הטרמינל
+exit
+# פתח טרמינל חדש
+
+# עכשיו נסה שוב
+gh auth login --web --scopes repo
+```
+
+#### שיטה B: דרך הממשק (מומלץ)
+1. עבור ל: **Settings > Environment Variables**
+2. מצא את `GITHUB_TOKEN`
+3. **מחק** או **השבת** אותו
+4. **Save Settings**
+5. **אתחל את האפליקציה**
+6. נסה: **Settings > Gitxxxxxxxxxxxxxxxxct**
+
+#### שיטה C: עריכת .env ידנית
+```powershell
+# ערוך את הקובץ
+notepad "$env:USERPROFILE\.auto-claude\.env"
+
+# מצא את השורה:
+GITHUB_TOKEN=ghp_xxxxxxxxxxxxx
+
+# שנה ל:
+# GITHUB_TOKEN=
+
+# שמור וסגור
+```
+
+---
+
+## 🎭 האם הקוד מנסה לחבר דרך דפדפן?
+
+### תשובה: **כן, אבל רק ל-GitHub (לא ל-Claude)**
+
+מה-`oauth-handlers.ts` שראינו:
+
+```typescript
+// שורה 5
+import { shell } from 'electron';
+
+// מאוחר יותר בקוד:
+await shell.openExternal(authUrl); // ← פותח דפדפן!
+```
+
+#### **מתי זה קורה:**
+- רק כש**אתה לוחץ** על "Connect GitHub"
+- GitHub OAuth דורש אישור בדפדפן
+- זה **לא אוטומטי** - רק לפי בקשה שלך
+
+#### **ל-Claude:**
+- **אין** חיבור דרך דפדפן
+- רק API עם OAuth token
+- אם אין טוקן - פשוט נכשל
+
+---
+
+## 🧩 למה זה "שומר את הטוקן"?
+
+### הקוד שמציג מה אתה רואה:
+
+```typescript
+// מ-env-handlers.ts
+// כשקוראים הגדרות:
+if (vars['GITHUB_TOKEN']) {
+  config.githubToken = vars['GITHUB_TOKEN'];
+}
+
+// כששומרים הגדרות:
+existingVars['GITHUB_TOKEN'] = config.githubToken;
+```
+
+### מה זה אומר:
+1. ✅ **כן, הקוד שומר טוקן** - זה נורמלי
+2. ✅ **זה נכון** - כך המערכת זוכרת את החיבור
+3. ❌ **הבעיה:** הטוקן **ישן/לא תקף**
+4. 🔧 **הפתרון:** צריך **למחוק אותו ולהתחבר מחדש**
+
+---
+
+## 📋 סדר פעולות מומלץ:
+
+### שלב 1: תקן GitHub (קריטי)
+```powershell
+# 1. מחק environment variable
+$env:GITHUB_TOKEN = $null
+[System.Environment]::SetEnvironmentVariable('GITHUB_TOKEN', $null, 'User')
+
+# 2. נקה את ה-gh CLI cache
+Remove-Item "$env:APPDATA\GitHub CLI\hosts.yml" -ErrorAction SilentlyContinue
+
+# 3. התחבר מחדש
+gh auth login --web --scopes repo
+
+# 4. בדוק שעובד
+gh auth status
+```
+
+**תוצאה צפויה:**
+```
+✓ Logged in to github.com as YOUR_USERNAME
+✓ Token: gho_xxxxxxxxxxxxx
+```
+
+---
+
+### שלב 2: תקן Claude (אופציונלי אם אתה משתמש ב-Claude)
+
+#### אם **אתה צריך** UsageMonitor:
+```powershell
+# התקן Claude CLI
+npm install -g @anthropic-ai/claude-cli
+
+# התחבר
+claude auth login
+
+# בדוק
+claude config get oauth_token
+```
+
+#### אם **אתה לא צריך** UsageMonitor:
+השבת אותו בקוד (אני יכול לעזור עם זה).
+
+---
+
+### שלב 3: וידוא
+```powershell
+# הפעל מחדש
+cd C:\Users\Koperberg\Auto-Claude
+npm run dev
+```
+
+**חפש בלוגים:**
+```
+✅ [GitHub OAuth] Auth check passed (authenticated)
+✅ [UsageMonitor] Successfully fetched via API  (אם התקנת Claude CLI)
+```
+
+---
+
+## 🎯 שאלות נפוצות:
+
+### ש: "למה הקוד לא אומר לי שהטוקן ישן?"
+**ת:** כי `gh auth login` רק בודק אם יש `GITHUB_TOKEN` ב-environment - לא אם הוא תקף.
+
+### ש: "איך אני מונע שטוקן יהיה ישן?"
+**ת:** 
+1. GitHub tokens יכולים לפוג (expiration date)
+2. אם מחקת אותו ב-GitHub.com
+3. אם שינית הרשאות
+
+**פתרון:** השתמש ב-`gh auth refresh` כל כמה שבועות.
+
+### ש: "האפליקציה פותחת דפדפן אוטומטית?"
+**ת:** **לא.** רק כשאתה לוחץ "Connect GitHub" בהגדרות.
+
+### ש: "אני צריך Claude CLI?"
+**ת:** **לא חובה** אם אתה לא משתמש ב-UsageMonitor. אפשר להשבית אותו.
+
+---
+
+## ✅ סיכום:
+
+| בעיה | סיבה | פתרון |
+|------|------|--------|
+| Claude 401 | אין CLI מותקן | התקן: `npm install -g @anthropic-ai/claude-cli` |
+| GitHub token invalid | טוקן ישן חוסם | מחק: `$env:GITHUB_TOKEN = $null` והתחבר מחדש |
+| Browser opens | GitHub OAuth זקוק לאישור | נורמלי - רק כשלוחצים "Connect" |
+| Token saving | המערכת זוכרת חיבור | נורמלי - זו תכונה, לא באג |
+
+---
+
+**נוצר:** 30 בדצמבר 2025  
+**סטטוס:** מחכה לניקוי GITHUB_TOKEN והתקנת Claude CLI  
+**Priority:** 🔥 HIGH - חוסם GitHub operations