בטא בקרוב. הפיצ׳ר עדיין בפיתוח, ולכן שמות ופרטים עשויים להשתנות לפני השחרור.

מעקב אחרי PR עד שהוא ירוק

כשהסוכן פותח pull request, ‏Ingot יכול ללוות אותו עד שהוא ירוק: הוא עוקב אחרי בדיקות ה-CI והערות הסקירה של ה-PR, נותן לסוכן לתקן את מה שנכשל, מריץ את בדיקת הפרויקט שלכם ודוחף את התיקון לענף של ה-PR. כל דחיפה וכל תשובה ממתינות לאישור שלכם לפני שהן קורות. הכול רץ בחלון ה-Ingot שלכם, ושום דבר לא נשלח לשרת של Ingot.

‏Ingot אחרי ש-PR במעקב הפך לירוק: הצ׳אט של ה-PR עם הלוג של הבדיקה שנכשלה והסוכן תיקן, ‏Pushed to fix/cart, כרטיס Goal שמסומן Done, ו-PR #7: Green בשורת המצב

איך מפעילים

התכונה כבויה כברירת מחדל. אפשר להפעיל אותה בכל אחד מהמקומות האלה:

  • ‏Settings › Features › Agent follows its PR
  • רשימת Customize… באשף ההגדרה הראשונית (Help › Set Up Ingot…)
  • הפקודה Agent: Follow Pull Request to Green… ‏(⌥⌘W ב-macOS, ‏Ctrl+Alt+W ב-Windows וב-Linux). אם התכונה כבויה, ‏Ingot שואל אם להפעיל אותה.

אחרי מה עוקבים

  • PRs שהסוכן פותח. כשהסוכן פותח PR בצ׳אט (בכלי ליצירת pull request או ב-gh pr create), ‏Ingot עוקב אחריו ומקשר אותו לאותו צ׳אט. כדי לבטל את זה, כבו את Auto follow ב-Settings › Tools › Agent tools › Follow PR to green.
  • כל PR שתבחרו. הריצו Follow Pull Request to Green… והדביקו קישור ל-PR, הקלידו #12 בשביל PR ב-origin של הפרויקט, או השאירו את התיבה ריקה כדי לעקוב אחרי ה-PR של הענף הנוכחי.
  • ‏Git Hosts. בחלונית Git Hosts, ליד PRs פתוחים יש כפתור Follow.

ב-GitHub הכול עובד: בדיקות CI שנכשלו מתוקנות, והערות סקירה מקבלות תשובה. ‏GitLab, ‏Bitbucket, ‏Azure DevOps, ‏Gitea ו-Forgejo נותנים ל-Ingot רק את מצב ה-PR ואת מצב ה-CI, ולכן אצלם Ingot מתקן CI שנכשל אבל עדיין לא קורא הערות סקירה.

מה קורה

  1. מעקב. ‏Ingot בודק את ה-PR כל 30 שניות בזמן שה-CI רץ. כשאין שינוי הוא מאריך את ההמתנה בין בדיקה לבדיקה, עד 10 דקות, והוא מאט גם כשמכסת הבקשות של GitHub מתקרבת לסוף. לא צריך webhook או מנהרה.
  2. בדיקה נכשלת. ‏Ingot מביא את סוף הלוג של ה-job שנכשל ומעביר אותו לסוכן בצ׳אט שמקושר ל-PR, ופותח את הצ׳אט אם הוא לא קיים. הלוג נכנס כמידע לא מהימן: הסוכן משתמש בו כדי למצוא את הבאג ולא מבצע הוראות שכתובות בתוכו. לפני שההרצה מתחילה, הצ׳אט מציג תחזית עלות. אם התחזית גבוהה מסף האזהרה שלכם, ההרצה ממתינה לאישור.
  3. בדיקת הפרויקט. כשהסוכן מסיים, ‏Ingot מריץ את בדיקת הפרויקט: הפקודה ב-Follow PR to green › Check אם הגדרתם אחת, ואחרת סקריפט ה-test של הפרויקט, שמבקש אישור קודם.
  4. דחיפה. ‏Ingot עושה commit לשינויים של הסוכן ודוחף אותם לענף של ה-PR. הדחיפה עוברת דרך אותו כרטיס אישור כמו שאר פעולות ה-git של הסוכן, וגם Always Run עובד עליה. אם מישהו אחר דחף לענף בינתיים, הדחיפה נדחית ו-Ingot עוצר.
  5. סוקר מעיר. הסוכן מבצע את השינוי שההערה מבקשת, אם צריך, ומנסח תשובה. אחרי הבדיקה והדחיפה, התשובה מופיעה בכרטיס אישור. התשובה תמיד מחכה לאישור: אין לה Always Run, ו-Ingot אף פעם לא מפרסם הודעה בשמכם בלי האישור שלכם. ‏Ingot מתעלם מהערות שלכם, מהערות של בוטים, מהתשובות של עצמו, מהערות קצרות כמו "LGTM" או "thanks", ומהערות שכבר היו שם כשהתחלתם לעקוב.

איפה רואים את זה

  • שורת המצב. ה-PR הדחוף ביותר מבין אלה שבמעקב מציג את המצב שלו: Watching, ‏Fixing, ‏Waiting for approval, ‏Green או Gave up. כששורת המצב השקטה פועלת, המצב הוא שורה בטבעת הפעילות, והוא מופיע בשורה עצמה רק כש-PR ממתין לאישור שלכם. לחיצה פותחת את רשימת ה-PRs שבמעקב: פתיחת הצ׳אט המקושר, פתיחת ה-PR, הפסקת מעקב, מעקב מחדש או הסרה.
  • התראות. כש-PR במעקב ממתין לאישור שלכם, התראה עם Open chat מביאה אתכם לכרטיס.
  • ‏Git Hosts ו-Agent Command Center. בשורות ה-PR ב-Git Hosts מופיע תג Following. ב-Agent Command Center יש רצועת Following ותג על הכרטיס של הצ׳אט המקושר.
  • ‏Ingot Health. ב-Help › Ingot Health… יש שורה Follow PR to green שאומרת אם PR ממתין לכם או שהמעקב נכשל, עם Show list כפתרון. ראו Ingot Health.

מתי זה נעצר

  • כשה-PR ממוזג או נסגר.
  • אחרי 3 הרצות תיקון ב-PR, תיקוני CI והערות סקירה יחד. משנים את המגבלה ב-Follow PR to green › Max iterations.
  • כשלוחצים Stop following, עוצרים את ההרצה של הסוכן, או מדלגים על דחיפה או על בדיקה.
  • כש-GitHub מסרב לגישה. התחברו עם gh auth login, הגדירו GH_TOKEN, או הוסיפו טוקן לשרת ה-MCP של GitHub.

כשה-PR ירוק, ‏Ingot ממשיך להקשיב להערות סקירה, בקצב איטי יותר, עד שה-PR ממוזג או נסגר.

בטיחות

  • בלי דחיפה בכוח. ‏Ingot אף פעם לא עושה force push. הוא אף פעם לא דוחף לענף ברירת המחדל או לענף הבסיס, ל-PR שמגיע מ-fork, או כש-origin הוא מאגר אחר.
  • אמון בתיקייה. תיקונים רצים רק בתיקייה שסימנתם כמהימנה.
  • ענף. הפרויקט חייב להיות על הענף של ה-PR. גם שינויים שלכם שלא נכנסו ל-commit מעכבים את התיקון.
  • אישורים. כללי האישור של git ושל הטרמינל ו-Always Run חלים על הבדיקה ועל הדחיפה. בתוך הרצת התיקון, הכלים של הסוכן פועלים לפי כל הכללים הרגילים, כולל ארגז החול ומדיניות הפרויקט.
  • רק הגדרות משתמש. כל ההגדרות של Follow PR הן הגדרות משתמש, כך שהגדרות workspace של מאגר לא יכולות להפעיל מעקב או לקבוע את פקודת הבדיקה.

הגדרות

ב-Settings › Tools › Agent tools › Follow PR to green:

הגדרהמה היא עושהברירת מחדל
ingot.agent.followPr.enabledמפעילה את התכונהfalse
ingot.agent.followPr.autoFollowמעקב אחרי כל PR שהסוכן פותחtrue
ingot.agent.followPr.maxIterationsמספר הרצות התיקון ל-PR לפני ש-Ingot מוותר3
ingot.agent.followPr.checkפקודת בדיקת הפרויקט; ריק משתמש בסקריפט testריק
ingot.agent.followPr.pollSecondsשניות בין בדיקות בזמן שה-CI רץ30

אפליקציית הדסקטופ והדפדפן מתנהגות אותו דבר.

ראו גם Git Hosts, Ship ו-סקירת סוכן לפני commit.