Oak Builder GitHub

מטרת הכלי וחזון השימוש: כלי Oak Builder GitHub מספק ניתוח מוכוון-תחום ו-scaffolding עבור מאגרי Oak ב-GitHub. המשתמשים היעד הם מפתחים וצוותי הנדסה שמתחילים או ממפים פרויקטים שמסמכים על Oak (בעיקר Deno). הכלי מעריך את מבנה המאגר, שימוש ב-middlewares, תבניות הניתוב, מצבDependencies, מוכנות בדיקות וה-CI ושיקולי פריסה. הוא מספק תוכניות scaffolding קונקרטיות והנחיות ארכיטקטוניות להאצת קליטת הצוות והתחזוקה.
\n
ליבה פונקציונלית: הכלי מקבל URL של מאגר GitHub או נתיב מקומי, מזהה דפוסי Oak ובונה גרף-תחום של מודולים, נתיבים, middleware ותלות. דרישות: קליטת מאגר, זיהוי דפוס Oak, גרף תלותים ו-generator לשכפול. פיצ’רים מתקדמים: הצעות אבטחה, hotspot-ביצועים, תוכניות מיגרציה ו-scaffolds מוכנים ל-PR. ייחודיות: דפוסי middleware ייעודיים Oak, מדריך מיגרציה לגרסאות Oak חדשות-generation, ויצירה אוטומטית של scaffolding בהתאם לתבניות Oak פופולריות.
\n
קלטים ופלטים: קלטים: repo_url (מחרוזת), analysis_scope (enum: full/modular), oak_version (מחרוזת, אופציונלי), include_tests (boolean), target_platform (מחרוזת: deno/node). פלטים: analysis_report (JSON), recommended_structure (מערך תיקיות/קבצים), scaffold_plan (אובייקט עם שלבים ותבניות), risk_score (0-100). ניתן לייצא ל-GitHub כ-PR template או patch.
\n
אלגוריתמים וחישובים: שימוש בניתוח סטטי, זיהוי דפוס מבוסס AST וגרף תלותים קל כדי להעריך סיכון וה readiness. מחושב score איכותי על בסיס lint וכיסוי בדיקות ובריאות התלותים וכן score הצעה תצוגתית לשכפול. נוסחאות: risk_score = w1*missing_tests + w2*outdated_deps + w3*complexity + w4*unverified_middlewares. הערכים הם הליתיים ומוסברים.
\n
שגיאות ומקרי קצה: טיפול ב-URLים לא תקפים, מאגרי פרטיים או לא נגישים, מגבלות בקצב, קלטים חסרים או גרסאות Oak מעורפלות עם קודי שגיאה והנחיות fallback. נתונים חיצוניים שאינם זמינים מובילים להמלצות זהירות וחוסרים מסומנים.
\n
תעשייה/אזור ולוקליזציה: תואם לזרימת GitHub ואקוסיסטמות Node/Deno; שימוש בתאריך/שעה ISO וחותמות זמן UTC בדו"חות; יחידות קשורות לקוד. לוקליזציה ברירת המחדל היא אנגלית.
הנחות והחרגות: מניח מאגרי ציבור או בעלי גישה מאושרת; אינו מריץ קוד בזמן אמת ואינו מבצע סריקות אבטחה מעמיקות; אינו כולל הצגה UI ואינו אחראי להחלטות הפריסה לייצור.