V3-CH7 — כיול Production ושינוי מבוקר
כרך 3 · פרק 7 · מדיניות drift, tuning, version promotion ו-rollback
v1.0 Spec · 12.8.2026
מטרת הפרק
הגדרת מדיניות כיול ושינוי מבוקר ל-Production: זיהוי drift, כללי tuning דינמיים, קידום גרסאות מבוקר, ו-rollback. הרחבה על בסיס V2-CH6 (כיול) ו-V2-CH4 (גרסאות).
מדיניות Drift
| מדד | סף | פעולה | חומרה |
|---|---|---|---|
| Mismatch rate | > 20% | חזרה אוטומטית ל-Shadow Active | P1 |
| Hit rate (agent) | < 0.3 | Alert + הפחתת משקל אוטומטית | P2 |
| Calibration error | > 0.3 | Penalty multiplier מופעל | P2 |
| Days since last eval | > 14 | Decay factor מופעל | P3 |
| Reliability stale | > 30 days | Alert + נעילת הרחבה | P2 |
כללי Tuning דינמיים
| כלל | טריגר | אפקט | הערה |
|---|---|---|---|
| Calibration multiplier | 10–49 מלצות | ×0.7 | רמת INITIAL |
| Calibration multiplier | 50–199 מלצות | ×1.0 | רמת CALIBRATED |
| Mature bonus | 200+ מלצות ו-hit_rate > 0.7 | ×1.1 | רמת MATURE |
| Decay factor | ימים מאז הערכה אחרונה | exp(-days/90) | דעיכה הדרגתית |
| Penalty multiplier | calibration_error > 0.3 | ×(1-error) | עונש על חוסר דיוק |
Version Promotion — 5 שלבים
| שלב | פעולה | פירוט | סטטוס |
|---|---|---|---|
| 1 | יצירת גרסה | סנאפשוט חדש עם change_reason ו-approved_by | קיים (V2-CH4) |
| 2 | אישור | החלטה מפורשת; אין auto-promotion | קיים (V2-CH4) |
| 3 | הפעלה | is_active=true + VersionActivationEvent | קיים (V2-CH4) |
| 4 | קישור AnalysisOutput | version_id מתעדכן בכל פלט חדש | קיים (V2-CH4) |
| 5 | אימות Production | גרסה חדשה ב-Canary לפני Controlled Live | חדש ב-V3 |
כללי Change Control
- אין שינוי אוטומטי של גרסאות פעילות; כל שינוי דורש אישור מפורש.
- גרסה חדשה נבדקת ב-Canary לפני Controlled Live; אין קידום ישיר.
- Rollback גרסה: חזרה לגרסה הקודמת עם AuditEvent ונימוק.
- Drift מעל 20% mismatch → חזרה אוטומטית ל-Shadow.
- Decay factor מפחית משקל סוכן שלא הוערך > 90 ימים.
קריטריוני קבלה
| מזהה | קריטריון | תוצאה |
|---|---|---|
| C1 | מדיניות drift מוגדרת: 5 מדדים עם סף, פעולה וחומרה. | SPEC PASS |
| C2 | כללי tuning מוגדרים: calibration multiplier, mature bonus, decay, penalty. | SPEC PASS |
| C3 | Version promotion: 5 שלבים (יצירה → אישור → הפעלה → קישור → אימות Production). | SPEC PASS |
| C4 | Rollback גרסה מתועד עם AuditEvent ונימוק; אין auto-promotion. | SPEC PASS |
| C5 | Drift > 20% mismatch → חזרה אוטומטית ל-Shadow Active. | SPEC PASS |
| C6 | Decay factor מופעל על סוכנים שלא הוערכו > 90 ימים. | SPEC PASS |
הבהרת סטטוס: SPEC PASS = מפרט מאושר ונעול; כיול Production ושינוי מבוקר יתממשו יחד עם שערי G1–G5. ראה דוח צליבה.