FROM CHAT TO OBSERVABILITY

סשן → אירוע → תמונת מצב

בסיס מעשי למערכת שמתחילה בצ׳אט ובסביבת הפיתוח, ויכולה לגדול לאייג׳נטים עצמאיים.

ארכיטקטורת ה־MVP

01 · מקורות פעילותדיווח צ׳אט ידני · Claude Code hooks · Codex exec JSONL

02 · מחבריםמיפוי לאירועים אחידים. מזהה סשן, בעלים, פרויקט ותקציר פעולה. ללא תוכן שיחה או פקודות.

03 · שרת + SQLitePOST /api/events מאומת · יומן אירועים · עדכון מצב באותה טרנזקציה · מניעת כפילויות.

04 · מרכז שליטהGET /api/sessions + GET /api/events כל 2 שניות · מפת עבודה · סינון · יומן לכל סשן.

מה מחובר ומה עדיין לא

סביבה	דרך חיבור	מגבלה
Claude / ChatGPT בצ׳אט	יצירת סשן ודיווח ידני	אין ניטור אוטומטי של שיחות בדפדפן
Claude Code	סקריפט hook ותצורת הגדרה לדוגמה	צריך להתקין בכל סביבת פיתוח. אותות באירועים בלבד; אין heartbeat רציף
Codex CLI	wrapper סביב codex exec --json	רק ריצות שמופעלות דרך המחבר; לא כל סשני Codex הקיימים
IDE / סשנים אינטראקטיביים נוספים	חיבור ייעודי בהמשך	אינו חלק מהמימוש הנוכחי

משימת טקסט מהמתחם

במצב מקומי בחרו ״סשן חדש״ ואז ״הפעלת סוכן אמיתי״, Claude ומודל מהרשימה. המשימה נשלחת ל־Claude CLI המחובר במחשב, והתשובה מופיעה בפרטי הסוכן. אפשר לשלוח משימות המשך בפרטי אותו סוכן, עם שמירת ההקשר והיסטוריית התשובות. ההרצה ללא כלי קבצים; המשימות והתשובות נשמרות מקומית. Codex זמין כרגע במחבר CLI ובדיווח ידני.

הפעלה מקומית

דרוש Python 3.10 ומעלה. אין תלות בחבילות חיצוניות. פתחו את קובץ README לפרטי החיבור והתצורה.

export ACC_TOKEN="$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')"
python3 -m server.app
# Open http://127.0.0.1:8080

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

חוזה האירועים

{
  "event_id": "evt-unique-123",
  "session_id": "codex:session-123",
  "type": "activity",
  "sequence": 7,
  "summary": "מריץ בדיקות"
}

האירוע הראשון הוא session.created עם provider, source, owner, project ו־task. אירוע מאוחר נשמר ביומן אך אינו מחזיר את מצב הסשן לאחור. heartbeat מעדכן את אות הקשר בלבד.

משמעות הסטטוסים

סטטוס	המשמעות
עובד	דווחה תחילת משימה או פעילות
ממתין לך	מחכה להמשך צ׳אט או לאישור משתמש
הושלם / שגיאה	תוצאה מפורשת של הריצה, לא מסקנה משתיקה
לא ידוע	אין אות עדכני: 120 שניות ב־Codex, או 15 דקות בחיבור hooks. מצב אחרון נשמר לצפייה
דיווח ידני	תמונת המצב האחרונה שהמשתמש הזין, ללא אימות פעילות

המשך למערכת צוותית

הפרידו את המחברים למחשבי המפתחים ואת השרת לשירות ארגוני. הוסיפו TLS ו־SSO, מפתח נפרד לכל מחבר, הרשאות לפי צוות, שמירת אירועים מוגבלת בזמן, תור עמיד במחברים ומדיניות גיבוי. PostgreSQL ו־SSE מתאימים לשלב שבו גדלים מעבר לפיילוט מקומי.

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