CodeMender יכול ליצור, לאמת ולהחיל באופן אוטומטי תיקונים של קוד מקור לנקודות חולשה מאומתות, ולבדוק אותם בארגז החול המקומי כדי לצמצם את הרגרסיות.
יצירת תיקונים לנקודות חולשה
משתמשים ב-cm fix כדי ליצור תיקון אבטחה מאומת לממצא מאומת:
cm fix FINDING_ID
כשמריצים את cm fix, CodeMender מבצע את שלבי האימות הבאים:
- יוצר תיקון פוטנציאלי באמצעות מנוע החשיבה הרציונלית שמתארח בענן.
- מחיל את התיקון על עותק של קוד המקור בתוך ארגז החול המקומי.
- הידור ובדיקה של בסיס הקוד על ידי הפעלת
build.commandשהגדרתם, כדי לוודא שהפרויקט נוצר ושבדיקות היחידה עוברות. - מריץ מחדש את הניצול המאומת של הוכחת ההיתכנות כדי לוודא שאי אפשר יותר לנצל את נקודת החולשה.
כברירת מחדל, CodeMender מבקש מכם לאשר כל שינוי בקובץ לפני שהוא כותב אותו בדיסק בסביבת העבודה שלכם. אחרי שכל הבדיקות עוברות, CodeMender מחיל את התיקון המאומת על סביבת העבודה. אחרי זה אפשר להעביר את השינויים לסביבת ה-Staging.
תיקון דגלים
- Provide fix context (
-c/--context): מספקים אילוצים ארכיטקטוניים או הנחיות לכתיבת קוד:cm fix FINDING_ID -c "Use the safe parameterized database helper in src/db/query.go"
- אישור אוטומטי של בקשות (
-y/--yes): אישור אוטומטי של כל בקשות הכתיבה של קבצים ואישור הפקודות במהלך תהליך התיקון: הערה: אפשר גם להשבית את בקשות האישור האינטראקטיביות ב-cm fix FINDING_ID -y
config.yamlעל ידי הגדרתtools.confirm_writes: falseו-tools.confirm_commands: false. כשההנחיות לאישור מושבתות, צריך לבדוק את תוצאות הבדיקה לפני שמעבירים את השינויים לשלב ה-staging או שומרים אותם. - שליטה בארגז החול (
--sandbox): הפעלה או השבתה באופן מפורש של ארגז החול ברמת מערכת ההפעלה להרצה הזו (לדוגמה,--sandbox=falseלהשבתה):cm fix FINDING_ID --sandbox=false
- מעקף של גבולות הנתיב (
--allow-all-paths): השבתת הבדיקה של גבולות הנתיב של סביבת העבודה בהרצה הזו, כדי שכלי הסוכן יוכלו לגשת לנתיבים מחוץ לשורש הפרויקט ול-project_pathsשהוגדר (בשילוב עם--sandbox=falseכדי לגשת לנתיבי מארח שלא נטענו בתוך ארגז החול):cm fix FINDING_ID --allow-all-paths
- Bypass command policy (
--allow-all-commands): השבתת האכיפה של רשימת החסימה שלcommand_policy.yamlבהרצה הזו:cm fix FINDING_ID --allow-all-commands
- Bypass cache (
--no-cache): מאלצים את CodeMender ליצור תיקון חדש:cm fix FINDING_ID --no-cache
- הגדרת תקציב למשך זמן הביצוע (
--duration/--timeout): הגבלת משך הזמן בפועל ליצירת תיקונים ואימות (לדוגמה,15mאו30m), או הגדרתCM_DURATIONאוexecution.durationב-config.yaml: כשהזמן נגמר, CodeMender נותן לסוכן עוד קצת זמן כדי לסיים את התיקון. אם הנציג מסיים במהלך תור החסד,cm fix FINDING_ID --duration 20m
cm fixמפעיל את אימות ה-build (מחיל את התיקון ומסמן את הממצאFIXEDאם ה-build עובר, או שומר תיקוןpendingומשאיר את העריכות במקום אם ה-build נכשל) ועדיין יוצא עם סטטוס50. אם הסשן מגיע למועד הסיום לפני שהוא מסתיים, CodeMender מבטל את העריכות של עץ העבודה שלא אומתו, שומר את ההבדלים שבתהליך כתיקוןpartialשאפשר לבדוק באמצעותcm report --patches, ויוצא עם הסטטוס50.
בדיקה וניהול של השוואות VCS מקומיות
CodeMender כולל פקודות VCS מובנות שעוזרות לבדוק, להעביר לשלב הביניים ולנהל את השינויים בקוד שנוצרים בעקבות התיקונים, לפני שמאשרים אותם:
הצגת סטטוס המאגר: בודקים אילו קבצים CodeMender שינה או יצר בסביבת העבודה המקומית.
cm vcs status
בדיקת ההבדלים: בודקים את ההבדלים המאוחדים שורה אחר שורה בכל השינויים בקוד שהסוכן יצר ולא בוצע להם commit.
cm vcs diff
העברת שינויים לסביבת Staging: מוסיפים את השינויים המאומתים של התיקון לסביבת ה-Staging המקומית כדי לבדוק ולשמור אותם.
cm vcs stage
ביטול השינויים בסשן: ביטול כל השינויים בקבצים המקומיים ש-CodeMender יצר במהלך הסשן הנוכחי, ושחזור המאגר למצב הבסיסי שלו.
cm vcs reset