==================================================================
   הוראות שימוש - תיקון חסימת נטפרי (HTTP 418) ב-Antigravity
   קובץ הסקריפט:  Fix-Antigravity-NetFree.ps1
==================================================================

מה זה?
------
סקריפט שמתקן את הבעיה שבה סוכן ה-AI (Gemini) ב-Antigravity לא עובד
מאחורי סינון נטפרי, ומחזיר שגיאת "HTTP 418" או "Agent terminated due to error".
הסקריפט מאתר לבד את ההתקנות במחשב, מגבה כל קובץ, ומתקן 3 מקומות:
   1. main.js              (קובץ הגדרות של ה-IDE)
   2. app.asar             (ארכיון של אפליקציית הסוכן)
   3. language_server.exe  (מנוע ה-AI - הגורם העיקרי לשגיאה)

הסקריפט בטוח: לפני כל שינוי הוא יוצר גיבוי (.bak) ליד הקובץ המקורי,
ואת הקבצים הבינאריים הוא משנה בצורה ששומרת על הגודל המדויק שלהם.

------------------------------------------------------------------
שלב 1 - שימוש רגיל (תיקון)
------------------------------------------------------------------
1. סגור לגמרי את Antigravity (גם ה-IDE וגם אפליקציית הסוכן).
2. לחיצה ימנית על הקובץ "Fix-Antigravity-NetFree.ps1"
   ובחר:  Run with PowerShell
3. אם יישאל אם לסגור את Antigravity - הקלד  Y  והקש Enter.
4. הסקריפט יציג שורות:
      [V] ירוק  = הצליח / כבר תקין
      [!] צהוב  = הערה
      [X] אדום  = בעיה
5. פתח מחדש את Antigravity ונסה את הסוכן.

   * אם בפתיחה תקפוץ הודעה "Installation appears to be corrupt" -
     התעלם וסגור אותה. זו התנהגות תקינה (Antigravity מזהה שהקובץ שונה).

------------------------------------------------------------------
שלב 2 - איך בודקים שהסקריפט תקין? (חשוב!)
------------------------------------------------------------------
אם אצלך כבר תיקנת, הסקריפט יראה "כבר תקין" ולא תוכל לראות אותו "עובד".
לכן יש מצב בדיקה עצמית שמוכיח שהמנגנון עובד - על קבצים זמניים מזויפים,
בלי לגעת בכלום אמיתי:

   א. פתח את התיקייה שבה נמצא הסקריפט.
   ב. החזק Shift + לחיצה ימנית על מקום ריק בתיקייה ->
      בחר "Open PowerShell window here" (או "פתח חלון PowerShell כאן").
   ג. העתק והדבק את השורה הבאה והקש Enter:

      powershell -ExecutionPolicy Bypass -File .\Fix-Antigravity-NetFree.ps1 -SelfTest

   ד. אם הכל תקין יופיע בסוף:
      [V] כל הבדיקות עברו - מנגנון התיקון תקין ועובד!

   הבדיקה יוצרת קובץ טקסט וקובץ בינארי זמניים עם כתובת חסומה,
   מתקנת אותם, מאמתת שהתיקון הצליח ושהגודל נשמר, ואז מוחקת אותם.

------------------------------------------------------------------
שלב 3 - ביטול / שחזור (אם משהו השתבש)
------------------------------------------------------------------
אפשרות א' - אוטומטי:
   פתח PowerShell בתיקייה (כמו בשלב 2) והרץ:

      powershell -ExecutionPolicy Bypass -File .\Fix-Antigravity-NetFree.ps1 -Restore

   זה מחזיר כל קובץ מהגיבוי האחרון שנוצר.

אפשרות ב' - ידני:
   ליד כל קובץ שתוקן נמצא קובץ גיבוי עם סיומת  .bak  וחותמת תאריך,
   למשל:  main.js.20260524-205145.bak
   מחק את הקובץ המתוקן והעתק את קובץ ה-.bak במקומו (הסר את הסיומת .bak).

------------------------------------------------------------------
העברה למחשב אחר
------------------------------------------------------------------
פשוט העתק את הקובץ "Fix-Antigravity-NetFree.ps1" למחשב השני
(דיסק-און-קי / מייל / כל דרך), והרץ אותו שם בדיוק לפי שלב 1.
הסקריפט מאתר לבד את מיקום ההתקנה - גם אם היא במקום אחר או בשם אחר.

------------------------------------------------------------------
חשוב לדעת
------------------------------------------------------------------
* בטוח להרצה חוזרת: אם משהו כבר תוקן, הסקריפט פשוט ידלג עליו.
* אחרי כל עדכון של Antigravity התיקון מתאפס - פשוט הרץ את הסקריפט שוב.
* בודק העדכונים של האפליקציה עצמו חסום בנטפרי, וזה תקין -
  זה רק אומר שלא יהיו עדכונים אוטומטיים (וזה אפילו טוב, כדי שהתיקון יישמר).

------------------------------------------------------------------
דגלים מתקדמים (אופציונלי, להרצה מ-PowerShell)
------------------------------------------------------------------
   -DryRun     סריקה בלבד - מראה מה היה מתקן, בלי לשנות כלום
   -Force      סוגר את Antigravity אוטומטית בלי לשאול
   -SelfTest   בדיקה עצמית (ראה שלב 2)
   -Restore    שחזור מהגיבוי (ראה שלב 3)

דוגמה:
   powershell -ExecutionPolicy Bypass -File .\Fix-Antigravity-NetFree.ps1 -DryRun
==================================================================