New: scripts/notify.py — sends via SMTP (notify@marcus-law.co.il → paperclip+chaim@marcus-law.co.il) Updated: HEARTBEAT.md — agents must send email when waiting for human decision Triggers: outcome choice, direction approval, QA failures, review ready. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
90 lines
2.7 KiB
Markdown
90 lines
2.7 KiB
Markdown
# HEARTBEAT.md — רשימת ביצוע לכל ריצה
|
||
|
||
## שפה — כלל עליון
|
||
|
||
**כל הפלט שלך חייב להיות בעברית בלבד.** זה כולל:
|
||
- Comments ב-Paperclip
|
||
- הודעות סטטוס
|
||
- תיאורי שגיאות
|
||
- סיכומים ודיווחים
|
||
- חשיבה פנימית (thinking)
|
||
|
||
אין יוצאים מן הכלל. גם שמות tools, פקודות, ונתיבי קבצים — ההסבר סביבם בעברית.
|
||
|
||
---
|
||
|
||
הרץ את הרשימה הזו בכל heartbeat.
|
||
|
||
## 1. זיהוי
|
||
|
||
- וודא שאתה יודע מי אתה: `$PAPERCLIP_AGENT_ID`
|
||
- בדוק הקשר: `$PAPERCLIP_TASK_ID`, `$PAPERCLIP_WAKE_REASON`
|
||
|
||
## 2. בדוק תיבת דואר
|
||
|
||
```bash
|
||
curl -s -H "Authorization: Bearer $PAPERCLIP_API_KEY" "$PAPERCLIP_API_URL/api/agents/me/inbox-lite"
|
||
```
|
||
|
||
- תעדוף: `in_progress` קודם, אחר כך `todo`
|
||
- אם `PAPERCLIP_TASK_ID` מוגדר — תעדף אותו
|
||
|
||
## 3. Checkout ועבודה
|
||
|
||
```bash
|
||
curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
|
||
"$PAPERCLIP_API_URL/api/issues/{issue-id}/checkout"
|
||
```
|
||
|
||
- עבוד על המשימה לפי ההוראות ב-AGENTS.md שלך
|
||
- השתמש בכלים המשפטיים (legal-ai MCP)
|
||
|
||
## 4. דיווח — חובה!
|
||
|
||
**לפני שאתה מסיים, תמיד:**
|
||
|
||
פרסם comment על ה-issue:
|
||
```bash
|
||
curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
|
||
-H "Content-Type: application/json" \
|
||
"$PAPERCLIP_API_URL/api/issues/{issue-id}/comments" \
|
||
-d '{"body": "סיכום העבודה..."}'
|
||
```
|
||
|
||
עדכן סטטוס issue:
|
||
```bash
|
||
curl -s -X PATCH -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
|
||
-H "Content-Type: application/json" \
|
||
"$PAPERCLIP_API_URL/api/issues/{issue-id}" \
|
||
-d '{"status": "done"}'
|
||
```
|
||
|
||
## 5. התראת מייל — כשנדרשת תשובה אנושית
|
||
|
||
**כשהתוצאה דורשת החלטה או תשובה של חיים**, שלח מייל:
|
||
|
||
```bash
|
||
python3 /home/chaim/legal-ai/scripts/notify.py \
|
||
"נדרשת תשובתך — [תיאור קצר]" \
|
||
"תוכן ההודעה עם סיכום מה נדרש"
|
||
```
|
||
|
||
**מתי לשלוח:**
|
||
- בקשה לקביעת תוצאה (דחייה/קבלה/חלקית)
|
||
- בקשה לאישור כיוון נימוק
|
||
- דוח QA שנכשל (צריך החלטה על תיקונים)
|
||
- החלטה מוכנה לביקורת דפנה
|
||
- כל מצב שדורש פעולה אנושית ולא יכול להתקדם לבד
|
||
|
||
**מתי לא לשלוח:**
|
||
- עדכוני סטטוס רגילים
|
||
- סיום משימה שלא דורשת תגובה
|
||
- שגיאות טכניות שאפשר לפתור לבד
|
||
|
||
## 6. Release
|
||
|
||
```bash
|
||
curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
|
||
"$PAPERCLIP_API_URL/api/issues/{issue-id}/release"
|
||
```
|