9 Commits

Author	SHA1	Message	Date
Chaim	ad04291d39	feat(seance): predecessor by-case לצריכת-סוכן דרך ה-plugin (#220 המשך) ... מוסיף get_predecessor_for_case(case_number) — האח case-scoped של get_predecessor_context (by-issue). סוכנים חושבים ב-case_number (לא issue-UUID), לכן זהו הנתיב שכלי-ה-plugin legal_predecessor_context (PR נפרד ב-plugin-legal-ai) יקרא. מחזיר מסקנות (summary) של ריצות-heartbeat שהסתיימו על-פני issues של התיק, newest-first, עם summary בלבד (ריצות cancelled ריקות מסוננות). - shaper משותף _shape_predecessor_run (G2 — נתיב-shaping יחיד ל-by-issue+by-case). - join בטוח i.id::text = payload->>'issueId' (לא cast של payload חופשי ל-uuid). - Port pc_get_predecessor_for_case (read-only); endpoint GET /api/operations/cases/{case_number}/predecessor. - 2 בדיקות (shaping+identifier, case-לא-נמצא). אומת חי: 1043-02-26/8125-09-24 מחזירים מסקנות-דיספוזיציה אמיתיות. Invariants: G12 (fetch מהמעטפת, המגע מהשער; הכלי יחיה ב-plugin=מעטפת מוצהרת, לא ב-mcp-server), G2 (shaper יחיד). המשך: PR ב-plugin-legal-ai (כלי) + הוראת-HEARTBEAT. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-07 05:07:44 +00:00
Chaim	cf7c918bed	feat(operations): פאנל בריאות-הסוכנים + הסלמות אחרונות ב-/operations (#218+#222 UI) ... הטמעת מוקאפ 02e (מאושר Claude-Design X17) — נראות שרת-הצד שנבנתה כ-backend: - backend: get_recent_escalations() ב-paperclip_client — משחזר הסלמות מהערות author_type='system' (severity+reason מנותחים מהגוף, identifier מ-join); Port pc_get_recent_escalations (read-only); endpoint GET /api/operations/agents/escalations. - frontend: useAgentHealth + useRecentEscalations (טיפוסים מקומיים כמו שאר operations.ts) + AgentHealthPanel ב-/operations תחת "בריאות-הסוכנים": 4 stat-tiles (זומבי/תקוע/עובד/רגוע), שורות-בעיה worst-first, וקארד הסלמות-אוטומטיות-אחרונות (severity+תיק+סיבה+מתי). דיוק מול המוקאפ: issue מוסלם עובר לבעלות-חיים→יוצא מרשימת-הבריאות, לכן שורות-הבריאות = זומבים טרם-הסלמה וקארד-ההסלמות = מטופלים (משלימים). Invariants: G12 (fetch מהמעטפת, המגע מהשער; UI צורך endpoint דומייני), G2 (מקור-בריאות/הסלמות יחיד). שער-עיצוב: מוקאפ 02e אושר לפני קוד (feedback_claude_design_gate). בדיקות: 13 pytest (2 חדשות ל-get_recent_escalations: parse severity/reason, fallback). frontend: tsc --noEmit + eslint נקיים (build מלא ב-CI/deploy — symlink node_modules שובר next build ב-worktree). api:types לא נדרש (operations.ts טיפוסים ידניים); ה-endpoint נפרס אטומית עם ה-UI. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-07 04:44:50 +00:00
Chaim	c7941a63ec	feat(watchdog): auto-escalation של zombie-loops ל-chair — סגירת הלולאה (#218+#222) ... מרכיב את הפרוסות שמוזגו לכלל closed-loop: watchdog שרת-צדי (_zombie_escalation_loop ב-lifespan, כל 15 דק') שגוזר בריאות per-issue (#222) ומסלים כל zombie מתמשך (לולאת-recovery, ≥ZOMBIE_ESCALATE_MIN_RECOVERY=2 יקיצות-שחזור) ל-chair דרך escalate_issue הloop-safe (#218). הטלמטריה agent.escalated (#219) נדלקת מה-Port. - מדוע שרת-צדי: סוכן תקוע-בלולאה לא יכול להסלים-עצמו אמין; ה-watchdog (מקביל ל-Deacon של Gastown, אבל דרך ה-reaper הקיים ולא tier חדש) עושה זאת. - אידמפוטנטי מבנייה: issue מוסלם הופך agent-unowned → לא zombie בsweep הבא. - החלטת-ההסלמה (סף+severity) = helper טהור zombie_escalation ב-agent_health (testable). severity: ≥5 יקיצות→high, אחרת→medium. - kill-switch: AGENT_ZOMBIE_AUTO_ESCALATE=0 להשבתה (הבריאות עדיין נצפית, escalate ידני עדיין זמין ב-endpoint). ברירת-מחדל ON — הלולאות שורפות budget והתרופה מוכחת. - 4 בדיקות policy חדשות (11 סה"כ). dry-run חי: 6 issues→0 hzombies→0 הסלמות (blast-radius מינימלי על deploy). Invariants: מקיים G2 (מרחיב את מנגנון-ה-reaper הקיים, לא sweep מקביל; escalate דרך המסלול הקנוני), G12 (הכל ב-web/, המגע מהשער), §6 (כשל-sweep נלכד ולא-קטלני). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-07 03:37:25 +00:00
Chaim	e203474548	feat(seance): אחזור-הקשר מריצות-קודמות של issue לצמצום blind-heartbeats (#220) ... מוסיף get_predecessor_context(issue_id, limit) ב-paperclip_client — read-only, מחזיר ריצות-heartbeat שהסתיימו על אותו issue (newest-first) עם ה-summary שכל heartbeat משאיר ב-result_json, כך ש-wake טרי קורא מה קודמיו הסיקו במקום לגלות-מחדש (ה-generic blind heartbeat). קשירת run→issue דרך wakeup_request_id→payload.issueId; limit מוגבל 1..10. - Port: pc_get_predecessor_context (read-only, לא עטוף-טלמטריה). - endpoint: GET /api/operations/issues/{issue_id}/predecessor?limit=3. - 3 בדיקות (fake-asyncpg: shaping+isoformat, clamp, empty). אומת חי read-only על issue בן 11 ריצות → מוחזרות מסקנות-דיספוזיציה אמיתיות. Invariants: מקיים G12 (fetch מהמעטפת, המגע מהשער; אין REST/כלי-פלטפורמה בליבה), G2 (מקור-predecessor יחיד). follow-up: MCP tool + HEARTBEAT (wake קורא בתחילת ריצה). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-07 03:16:03 +00:00
Chaim	bfc352c7b5	feat(health): טקסונומיית-בריאות לסוכן — zombie/stalled/working/idle (#222) ... מוסיף web/agent_health.py — מסווג-טהור classify_issue_health (agent-agnostic, testable) שממפה כל issue פתוח+משויך-סוכן למצב-בריאות אחד, ו-get_agent_health ב-paperclip_client שגוזר את הפרימיטיבים מ-heartbeat_runs (run חי=finished_at null בחלון) + agent_wakeup_requests (total + recovery-markers בחלון). מרכיב על אירועי #219 (אותם reasons של recovery). - zombie = פתוח+משויך-סוכן, אין run חי, יש wakeup-recovery → הstranded-child שאובחן ידנית (reference_recovery_loop_stranded_child) עולה אוטומטית. - stalled = ננער חוזר בלי progress; working = run חי; idle = המתנה בנונית. - Port: pc_get_agent_health (read-only, לא עטוף-טלמטריה לפי הכלל); endpoint GET /api/operations/agents/health (worst-first, +counts). - 7 בדיקות pytest (מסווג-טהור + fetch fake-asyncpg). אומת חי read-only מול Paperclip DB: 6 issues→idle נכון, אפס zombie. Invariants: מקיים G12 (מסווג אגנוסטי; fetch מהמעטפת; המגע מהשער), G2 (מקור-בריאות יחיד). UI ב-/operations = follow-up מגודר-שער-עיצוב (feedback_claude_design_gate). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-07 03:05:17 +00:00
Chaim	b3b7c48b8f	feat(escalation): primitive הסלמה-לאדם loop-safe בשער-הפלטפורמה (#218) ... מוסיף escalate_issue(issue_id, severity, reason) — חלופה loop-safe להשארת issue משויך-סוכן+blocked, שהיא מקור לולאות source_scoped_recovery_action / stranded_assigned_issue / issue_reopened_via_comment (reference_paperclip_recovery_loops). שני אפקטים בטרנזקציית-DB אחת, במנגנון הקנוני של reset_case_agents (raw SQL, לא REST): - מעבר-אטומי למצב human-owned {status:in_review, assignee_agent_id:null, assignee_user_id:CHAIM_USER_ID} (rule #7). direct-DB בכוונה — עוקף את disposition-resolver של Paperclip שהוא-עצמו מקור-הלולאות; נוחת human-owned בשוט אחד בלי done→todo flip. - הערת-severity עמידה author_type='system' — אינרטית ל-route-pending-comments (מנתב רק author_type='user'), לכן לא מעירה CEO. אפס wakeup — המטרה היא מסירה-לאדם. חיווט: - Port: pc_escalate_issue עטוף ב-agent.escalated (מרכיב על טלמטריית #219 — הסלמות נספרות per-case באותו זרם כמו ה-wakeups שהן מחליפות). - app.py: POST /api/cases/{case}/agents/escalate (Literal severity). - 3 בדיקות pytest (fake-asyncpg): severity לא-תקין, happy-path (מעבר+system-note+ אפס-wakeup), issue-לא-נמצא. Invariants: מקיים G2 (אותו מנגנון-העברה-לאדם כמו reset_case_agents, לא מסלול מקביל), G12/INV-PORT1 (המגע מהשער בלבד; ליבה נקייה), §6 (אין בליעה שקטה — severity לא-תקין וissue-חסר מוחזרים מפורשות). follow-up מוצהר: חיווט-סוכנים (MCP tool + HEARTBEAT §4 להחליף blocked+prose), auto-escalation מה-reaper, והתראת-מייל (notify.py) לחיים. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-06 21:02:38 +00:00
Chaim	5dbe970dbc	feat(telemetry): אירועי-סוכן מובנים בשער-הפלטפורמה — נראוּת לולאות-recovery (#219) ... מוסיף web/agent_telemetry.py — emitter אגנוסטי-לפלטפורמה שפולט אירוע JSON מובנה לכל פעולת-פלטפורמה משנת-מצב (wakeup/comment/interaction-reap/cancel/ run-cancel/session-reset). מטרה: להפוך דיבוג לולאות-recovery מפורנזיקה-ידנית מול Paperclip DB (agent_wakeup_requests/heartbeat_runs) לנראוּת בזמן-אמת. - הפליטה מחווטת ב-web/agent_platform_port.py בלבד (התפר היחיד) — כל pc_* משנה-מצב נעטף ב-instrument(); השמות הציבוריים והחתימות נשמרים, app.py לא משתנה. - אגנוסטי-לפלטפורמה (G12): agent_telemetry לא מייבא Paperclip; אירועים בשמות-דומיין שורדים החלפת-פלטפורמה. מסלול-פליטה יחיד (G2). - OTLP-ready ("logs first"): schema יציב + _SINK מבודד להחלפה עתידית בלי שינוי call-site. - error מ-op נפלט כאירוע ואז נזרק-מחדש — אין בליעה שקטה (§6). - store-UTC (feedback_israel_time). 6 בדיקות pytest (web/tests/test_agent_telemetry.py). Invariants: מקיים G2 (מסלול-טלמטריה יחיד), G12/INV-PORT1 (פליטה מהשער, ליבה נקייה), כלל-הנדסה §6 (אין בליעה שקטה). מזין את #222 (טקסונומיית-בריאות). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-06 20:51:20 +00:00
Chaim	6359363f13	fix(storage): #106.5 — serve_blob probes S3 sub-backend, not dual disk-OR-S3 exists ... באג-אינטראקציה שהתגלה לפני ה-flip ל-dual: DualBackend.exists() מחזיר True אם הקובץ על **הדיסק או** ב-S3. serve_blob בדק backend.exists() ואז הנפיק presigned — כך שתחת dual, קובץ שקיים-רק-בדיסק (mirror שנכשל / מחוץ לסט-ההגירה) היה מקבל redirect ל-presigned-URL שמחזיר 404 מ-MinIO, במקום fallback-לדיסק. תיקון: serve_blob בודק קיום ב-**S3 ספציפית** — `s3 = getattr(backend, "s3", backend)` (DualBackend.s3, או ה-S3Backend עצמו תחת s3) — כך שקובץ disk-only נופל ל-FileResponse אמיתי. תואם-לאחור ל-filesystem/s3 (getattr מחזיר את ה-backend עצמו). invariants: INV-STG6 (presigned רק כשהאובייקט באמת ב-S3) · INV-G10 (אפס שינוי תחת filesystem). tests: 6 (2 חדשות — dual מ-S3-sub-backend present→redirect / absent→disk-fallback). py_compile OK. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-11 18:08:45 +00:00
Chaim	63784f1f91	feat(storage): #106.5 — read-wiring via serve_blob (presigned + dual disk-fallback) ... חיווט-קריאה של 4 endpoints מגישי-קבצים (api_read_local_file · research/analysis download · analysis export-docx · exports download) דרך helper serve_blob יחיד (INV-STG6). מיישם את אסטרטגיית-ה-cutover שהפאנל התלת-מודלי (Opus+DeepSeek+Gemini) אישר פה-אחד 2026-06-11: - filesystem → FileResponse מדיסק (משמר-התנהגות; ה-backend הפעיל בייצור — אפס שינוי). - s3/dual → 302 ל-presigned-URL כשהאובייקט ב-MinIO (bytes browser↔MinIO, לא דרך FastAPI). - dual + miss → **fallback-לדיסק** — מכסה שקוף קבצים שמחוץ לסט-ההגירה מתויג-ה-DB (analysis-and-research.md, DOCX דינמי, proofread). זו רשת-הביטחון שהפאנל דרש. - s3 + miss + ללא-דיסק → 404. כשל normalize_key/presign → fallback-לדיסק, לעולם לא 500 (לא נשבר בשקט — logger.exception). ה-cutover (#106.6 flip ל-s3) + WORM (#106.7) **נשארים נעולים מאחורי אישור-אדם** — הכרעת-הפאנל פה-אחד (proceed_autonomously=false). PR זה הפיך: תחת filesystem אין שינוי- התנהגות, וה-helper מוכן להפעלה כשיוחלט flip מפוקח + curl-ירוק per-endpoint. invariants: INV-STG6 (presigned) · INV-STG1 (storage layer יחיד) · G2 (serve_blob יחיד, לא 4 העתקי-לוגיקה) · INV-G10 (אפס שינוי-התנהגות בייצור filesystem). tests: 4 חדשות (web/tests/test_serve_blob.py — filesystem/dual-S3/dual-fallback/s3-404), עוברות. py_compile OK. מקור: פאנל תלת-מודלי (תיעוד ב-TaskMaster #106.6). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-11 17:43:31 +00:00