Slopgate

איזו בעיה הכלי פותר

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

דרכים להשתמש בכלי

• לזהות המרות טיפוס חוזרות

  מפעילים את חבילת הכללים as-any. כשהסוכן מוסיף המרה לא בטוחה, הבדיקה המהירה מצביעה על הקובץ והכלל; מתקנים את הטיפוס או את האימות לפני שממשיכים.

• להוסיף בדיקות לאפליקציה קיימת

  בודקים קו בסיס ראשוני של הפרות קיימות. הפרות חדשות חוסמות commits מאוחרים יותר, ואת החוב הישן אפשר לתקן בהדרגה; לא מעדכנים את קו הבסיס כדי להסתיר תקלות חדשות.

• להפריד בין הממשק למודולי מסד הנתונים

  מוסיפים כלל גבול לפרויקט ב-dependency-cruiser. בדיקת ה-commit יכולה לדווח על ייבוא שחוצה אותו במקום להסתמך רק על הוראה כתובה.

לפני שמתחילים

• מאגר Git ו-Node.js מגרסה 18 עם npm.
• הרשאה להתקנת כלי שורת הפקודה ולהוספת hooks מקומיים של Git או Claude Code לפרויקט.
• תלויות הבדיקות שבוחרים להפעיל; החבילה כוללת את המנוע המקומי ואת גרסת ast-grep הנדרשת.

התקנה והגדרה

1. להתקין את הגרסה המתועדת

   מריצים במסוף שבו Node ו-npm זמינים. הגרסה המתועדת היא 0.3.4; המנוע הארוז אינו דורש התקנת Rust.

   npm install -g @alexcodeplace/slopgate@0.3.4

2. לאתחל את פרויקט היעד

   מאתחלים את Slopgate מתיקיית השורש של המאגר. בודקים את הגדרות .slopgate ואת שינויי ה-hooks לפני שמאשרים אותם.

   slopgate init .

3. לבדוק את קו הבסיס הראשוני

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

   slopgate baseline --config .slopgate/config.toml

שימוש בפרויקט

1. לבדוק קובץ ששונה

   מחליפים את src/app.ts בקובץ המקור המתאים. מסלול הבדיקה המהיר נותן משוב ממוקד בלי להריץ את כל בדיקות הפרויקט הכבדות.

   slopgate --file src/app.ts --config .slopgate/config.toml

2. לבדוק את השינוי המוכן ל-commit

   מוסיפים ל-staging רק את הקבצים המיועדים ל-commit ומריצים את הבדיקה. קוד 0 מציין מעבר, 1 מציין ממצאים חוסמים ו-2 דורש תיקון הגדרות או מנוע AST.

   slopgate --staged --config .slopgate/config.toml

3. לצמצם חוב ישן בלי לקבל הפרות חדשות

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

   slopgate baseline --prune --config .slopgate/config.toml

מה כדאי לדעת מראש

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