docs(heartbeat): שער קריאת-הערות לפני סגירה — מונע נפילת הערות-יו"ר (#164) #353

chaim · 2026-06-30T10:21:11Z

chaim commented

2026-06-30 10:21:11 +00:00

רקע

חגורה-וכתפיות ל-sweep בפלאגין (plugin-legal-ai #3). הערות שנכנסות תוך-כדי ריצה אינן נקראות אוטומטית — סוכן קורא comments פעם אחת בתחילת הריצה (§2), כך שהערת-יו"ר שנוחתת אחרי-כן ולפני שהריצה סוגרת את ה-issue לא נראית לעולם. כך נשמטה הערת-יו"ר על CMP-190 (30.6.26).

השינוי

שער חובה ב-HEARTBEAT §4ב: לפני PATCH status=done, לקרוא שוב comments ולהשוות לרשימת תחילת-הריצה. אם נכנסה הערת-יו"ר חדשה שלא טופלה — לא לסגור. או לטפל (ולתעד ב-comment), או אם היא מרחיבה היקף — להשאיר פתוח ולהעביר ל-CEO (§4ג). אסור done בעוד הערת-יו"ר ממתינה ללא-מענה.

ה-sweep תופס הערות-יתום תוך ~2 דק'; השער מונע את הנפילה במקור.

Invariants

G2/G12 — תיעוד-סוכן בלבד (פרומפט), ללא קוד; משלים את מסלול-הניתוב הקיים.

Refs TaskMaster #164. צמוד ל-plugin-legal-ai #3.

🤖 Generated with Claude Code

## רקע חגורה-וכתפיות ל-sweep בפלאגין ([plugin-legal-ai #3](https://gitea.nautilus.marcusgroup.org/ezer-mishpati/plugin-legal-ai/pulls/3)). הערות שנכנסות **תוך-כדי ריצה** אינן נקראות אוטומטית — סוכן קורא comments פעם אחת בתחילת הריצה (§2), כך שהערת-יו"ר שנוחתת אחרי-כן ולפני שהריצה סוגרת את ה-issue **לא נראית לעולם**. כך נשמטה הערת-יו"ר על CMP-190 (30.6.26). ## השינוי שער חובה ב-HEARTBEAT §4ב: **לפני** `PATCH status=done`, לקרוא שוב comments ולהשוות לרשימת תחילת-הריצה. אם נכנסה הערת-יו"ר חדשה שלא טופלה — **לא לסגור**. או לטפל (ולתעד ב-comment), או אם היא מרחיבה היקף — להשאיר פתוח ולהעביר ל-CEO (§4ג). אסור `done` בעוד הערת-יו"ר ממתינה ללא-מענה. ה-sweep תופס הערות-יתום תוך ~2 דק'; השער מונע את הנפילה **במקור**. ## Invariants - **G2/G12** — תיעוד-סוכן בלבד (פרומפט), ללא קוד; משלים את מסלול-הניתוב הקיים. Refs TaskMaster #164. צמוד ל-plugin-legal-ai #3. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

chaim added 1 commit 2026-06-30 10:21:12 +00:00

docs(heartbeat): comment-recheck gate before done — prevent dropped chair comments

G12 Leak-Guard / leak-guard (pull_request) Successful in 4s

Details

Lint — undefined names / undefined-names (pull_request) Successful in 10s

Details

24e02621df

Belt-and-suspenders to the plugin sweep (plugin-legal-ai #3). Comments that
arrive mid-run aren't re-read automatically — an agent reads comments once at
run start (§2), so a chair comment that lands after that point and before the
run closes the issue is never seen. That is exactly how a chair comment on
CMP-190 (2026-06-30) was dropped.

Adds a mandatory gate to HEARTBEAT §4ב: before PATCH status=done, re-read
comments and compare to the run-start list. If a new unaddressed chair comment
exists — do not close. Either handle it (and record a comment) or, if it
widens scope, keep the issue open and hand back to the CEO (§4ג). Never mark
done while a chair comment waits unanswered.

The plugin sweep catches orphaned comments within ~2 min; this gate prevents
the drop at the source. Refs legal-ai #164.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

chaim merged commit 61e6be4b90 into main

2026-06-30 10:22:07 +00:00

chaim deleted branch worktree-comment-recheck-gate

2026-06-30 10:22:07 +00:00

chaim referenced this issue from a commit

2026-06-30 10:22:08 +00:00

Merge pull request 'docs(heartbeat): שער קריאת-הערות לפני סגירה — מונע נפילת הערות-יו"ר (#164)' (#353) from worktree-comment-recheck-gate into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: ezer-mishpati/legal-ai#353