core/README.md

core/ — הליבה האנליטית

השכבה הטהורה של OrgState Engine. stdlib בלבד, ללא I/O, ללא state. אם רכיב כאן צריך לייבא מ‑infra/, verticals/ או delivery/ — הוא לא שייך לכאן.

תוכן

קובץ	מה יש בו
events.py	CanonicalEvent — אירוע ארגוני אחיד
state.py	EntityState — מצב ישות ליום נתון
ontology.py	Entity, ENTITY_TYPES — סוגי ישויות ארגוניות
signals.py	מתמטיקת האותות: Δ (שינוי), ψ (יציבות), ξ (חריגה), γ (זמן תגובה), κ (קוהרנטיות), Ω (בריאות)
drift.py	DriftIssue, drift_score (סכום משוקלל, weights אופציונליים), severity_from_score
decisions.py	DecisionItem, recommendation_for_issue
config.py	Stage 1 — MetricConfig / EntityTypeConfig / VerticalConfig, טעינה מ‑YAML
calibration.py	Stage 1 — calibrate / Calibration, סקיילים robust (MAD) מדאטת הלקוח
pipeline.py	Stage 1 — Observation, run_pipeline — הצינור הגנרי מונע‑הקונפיג

שימוש

from core import drift_score, severity_from_score, health_omega

signals = {"delta": 0.3, "psi": 0.7, "xi": 0.5, "gamma": 0.4, "kappa": 0.8}
score = drift_score(signals)          # 0.0 (בריא) .. 1.0 (מדורדר)
severity = severity_from_score(score) # low / medium / high / critical

בדיקות

tests/test_core_*.py — 36 בדיקות correctness אמיתיות (לא בדיקות טווח בלבד): תכונות מתמטיות של כל אות, משקלי drift_score, ספי החומרה בגבולות, מיפוי ההמלצות, ובדיקה אינטגרטיבית שמוכיחה lead‑time חיובי על סדרה מדורדרת.

Stage 1 — בוצע

הסקיילים והמשקלים כבר לא hardcoded: config.py הופך אותם לקונפיג, calibration.py גוזר את הסקיילים מדאטת הלקוח, ו‑pipeline.py הוא צינור גנרי אחד מונע‑קונפיג. הדיפולטים ההיסטוריים נשארו מקובעים ב‑drift.py (DEFAULT_DRIFT_WEIGHTS / DEFAULT_SEVERITY_THRESHOLDS) והבדיקות מוודאות שהם לא משתנים בשקט.